Envio Directo (beta)
Direct Send API es una funcionalidad en fase beta de Meta, por lo que no está habilitada para todas las cuentas de WhatsApp Business (WABA). Si tu cuenta no la tiene habilitada, el mensaje falla y recibirás una notificación de error en tu webhook (ver Respuesta).
Direct Send API permite enviar mensajes de WhatsApp de negocio a usuario (categoría utility) sin necesidad de crear y aprobar plantillas manualmente. En lugar de referenciar una plantilla por nombre, se envía el contenido directamente (texto o interactivo) agregando el campo category a la petición. Meta compara el contenido contra las plantillas existentes o crea una nueva de forma automática y asíncrona.
Esta plataforma integra Direct Send sobre el mismo endpoint de mensajería que ya existe (POST /v1/messaging), con la misma autenticación: para obtener el token consulta Generar Token de Autenticación.
Consideraciones:- Si se omite el campo category, el mensaje se comporta como un envío normal (ver Mensajes sin plantilla).
- El envío puede tardar más de lo habitual, ya que Meta realiza el matching y, cuando es necesario, la creación de la plantilla.
- Si Meta crea una plantilla nueva, le asigna un nombre automático (por ejemplo, auto_generated_1234567890) y después se puede usar con normalidad. Para fijar un nombre propio, consulta Atribución de template.
- Enviar service en category se considera fuera de Direct Send y sigue el comportamiento de envío existente.
- Meta supervisa la categorización de los mensajes; consulta Uso indebido de la API.
Consulta de templates creados
Las plantillas creadas por Direct Send se pueden consultar en el listado de plantillas (GET /v1/template/{{wabaId}}, ver Gestión de Plantillas) y se pueden usar para enviar de forma normal en cuanto quedan en estatus APPROVED.