Cómo funciona Direct Send
Direct Send utiliza plantillas en segundo plano. Puedes enviar texto final o contenido interactivo. También puedes hacer referencia a una plantilla de utilidad existente y pedirle a YCloud que convierta sus componentes admitidos en un mensaje de Direct Send.Funciones admitidas y límites
Requisitos y alcance del envío
Conecta tu WABA y número de teléfono comercial a YCloud. En Meta WhatsApp Manager → Plantillas de mensajes, verifica si tu empresa es apta para Direct Send. Si el acceso no está disponible para tu WABA, utiliza una plantilla de utilidad aprobada o contacta a YCloud para verificar los requisitos. Direct Send de utilidad puede iniciar una notificación esperada fuera de la ventana de atención al cliente de 24 horas. Obtén el consentimiento del cliente y mantén el contenido vinculado a su solicitud, transacción, cuenta o información esencial que califique. Las promociones y los códigos de verificación quedan fuera de este flujo de utilidad.Longitud del mensaje y botones
interactive. Un encabezado de imagen solo está disponible cuando conviertes una plantilla admitida y Meta ha habilitado esa capacidad para tu WABA.
Período de validez para la entrega (TTL)
ttlSeconds establece cuánto tiempo puede permanecer un mensaje disponible para su entrega. Si no se puede entregar dentro de ese período, se descarta. Un mensaje entregado no se elimina cuando expira su TTL.
ttlSeconds: 1800; no lo deje en el valor predeterminado.
Tipos de mensajes admitidos
Los siguientes formatos cubren notificaciones de texto, enlaces y respuestas de clientes a través de YCloud.Procesar respuestas de botones de respuesta
Aunque envíe una solicitudinteractive, Direct Send entrega el contenido como una plantilla. Por lo tanto, cuando un cliente pulsa un botón de respuesta, se utiliza el formato de respuesta rápida de plantilla: type: button, con button.payload y button.text.
Campos relevantes en un evento de mensaje entrante de YCloud:
button.payload para identificar la acción y context.id para correlacionar la respuesta con el wamid del mensaje original. No lea esta respuesta desde interactive.button_reply, que es el formato habitual de botón de respuesta libre.
Enviar a través de YCloud
Prepare una clave de API del lado del servidor y los números del remitente y del destinatario en formato E.164. Solo necesita el WABA ID si decide enviar muestras de mensajes.1. Seleccione el modo de envío
sendDirectly describe los tiempos de envío. Para usar Direct Send, su WABA debe tener acceso y su solicitud debe incluir los campos de Direct Send indicados a continuación.
2. Crear la solicitud
- Texto
- Botón de URL
- Botones de respuesta
3. Rastrear la entrega
Guarde elid del mensaje devuelto, su externalId y el wamid cuando esté disponible. Reciba actualizaciones a través de whatsapp.message.updated o consulte GET /v2/whatsapp/messages/{id}.
Después de accepted, el resultado del envío es sent o failed. Los mensajes correctos pueden avanzar a delivered y read. Una solicitud aceptada no constituye un recibo de entrega.
Para errores de envío síncronos, inspeccione error.whatsappApiError cuando esté presente. Para mensajes en cola, revise las actualizaciones de estado posteriores. Si una solicitud agota el tiempo de espera, concilie el mensaje original antes de reintentar.
Convertir una plantilla de utilidad existente
Use una plantilla de utilidad existente en su WABA. Establezcatype: "template" y useDirectSend: true. Proporcione el nombre de la plantilla, el idioma y cada parámetro requerido. YCloud reemplaza las variables y convierte los componentes admitidos en texto o contenido interactivo con category: "utility". La plantilla debe cumplir con los límites de conversión indicados abajo. YCloud no requiere el estado APPROVED para esta conversión.
Si la plantilla tiene un encabezado de imagen, confirme que Meta haya habilitado Direct Send con encabezado de imagen para su WABA antes de utilizarla. Esto requiere un acceso independiente de Meta.
Para este ejemplo, use una plantilla de utilidad existente llamada order_update con el cuerpo Your order {{1}} has been updated. y sin encabezado, pie de página ni botones:
type se convierte en text, y la variable de la plantilla pasa a ser el ID de pedido suministrado:
accepted no confirma la entrega. Almacene el id del mensaje y rastree los eventos whatsapp.message.updated. Revise los límites de conversión a continuación antes de reutilizar una plantilla con encabezados o botones.
Si YCloud devuelve WHATSAPP_DIRECT_SEND_UNSUPPORTED_COMPONENT, verifique el encabezado, los botones y las variables sin resolver de la plantilla con respecto a los límites a continuación. Si la WABA no puede usar Direct Send, compruebe su elegibilidad antes de volver a intentarlo o envíe una plantilla de utilidad aprobada a través del flujo de trabajo habitual de plantillas.
Establecer el tiempo de vida del mensaje
Para la conversión de plantillas, el valorttlSeconds de la solicitud tiene prioridad sobre el TTL de la plantilla. Si lo omite, YCloud hereda un TTL positivo de plantilla de hasta 43200 segundos. Un TTL de plantilla inferior a 30 segundos falla la validación, por lo que debe anularlo con un valor de solicitud válido. YCloud no hereda valores de TTL de plantilla superiores a 43200. Si no se aplica ninguno de los valores, Meta utiliza su TTL predeterminado.
Asignar un nombre a una plantilla de Direct Send de utilidad
template.name identifica una plantilla existente en la solicitud de conversión anterior. templateName tiene un propósito diferente: establézcalo cuando desee que Meta reutilice un nombre reconocible para una plantilla de Direct Send de utilidad. El campo es opcional y no habilita Direct Send por sí solo. También debe establecer useDirectSend: true o category: "utility".
400 con target templateName y mensaje A template with the same name already exists. Elija otro nombre antes de volver a intentarlo.
templateName no es compatible con Direct Send de autenticación. Para un mensaje de Direct Send de utilidad en cola, YCloud devuelve el error de validación sin devolver un ID de mensaje y, de lo contrario, reenvía el nombre a Meta sin almacenarlo en el registro del mensaje. YCloud ignora el campo para los mensajes que no usan Direct Send.
Límites de conversión de plantillas e idiomas
Direct Send de utilidad admite texto, botones CTA de URL y botones de respuesta. Estos límites también se aplican cuando YCloud convierte una plantilla de utilidad:400 con el código WHATSAPP_DIRECT_SEND_UNSUPPORTED_COMPONENT.
Idiomas compatibles
Direct Send admite los idiomas para plantillas de WhatsApp excepto:Ver plantillas generadas por Direct Send en YCloud
- Abra WhatsApp Manager → Templates en la consola de YCloud.
- Seleccione la WABA utilizada para enviar el mensaje.
- Establezca Creator → Auto generated. Use Category → Utility para limitar la lista a plantillas de utilidad.
- Compruebe el nombre, la categoría, el idioma, el estado y la hora de última actualización de la plantilla. Haga clic en su nombre o en Insights para abrir su vista previa y los detalles de rendimiento.

Set Creator to Auto generated. This test WABA has no matching generated templates.
auto_generated. Utilice el filtro Auto generated para identificarlas en lugar de basarse únicamente en sus nombres.
La página de estadísticas muestra la vista previa del mensaje y las estadísticas disponibles de entrega, fallos, lecturas e interacciones para el período seleccionado. Utilice el estado y el contenido de la plantilla de forma conjunta al investigar una advertencia o una plantilla pausada.
Las plantillas generadas no se pueden editar ni eliminar manualmente. Para modificar la notificación, cambie el contenido en su solicitud de envío; Meta luego asociará o generará una plantilla para ese contenido.
Pautas de integridad y contenido
Mantenga el contenido de Utility específico y no promocional
Los mensajes de Utility deben responder a una acción esperada del cliente o proporcionar información esencial requerida. Indique claramente el pedido, la cita, la cuenta o la transacción correspondiente.category por utility no altera el significado del contenido. Meta sigue evaluando las plantillas generadas tras el envío. Puede verificar un caso de uso sustancialmente diferente con una muestra de mensaje antes de enviarlo.
Verificar un nuevo caso de uso con muestras de mensajes (opcional)
POST /v2/whatsapp/messages/{wabaId}/messageSamples envía un ejemplo a Meta y devuelve la categoría detectada por Meta. No envía un mensaje al cliente. Esta verificación es opcional; no necesita invocarla para cada mensaje ni antes de usar Direct Send. Para un nuevo caso de uso de Utility, recomendamos verificar tres o cuatro muestras representativas, una por solicitud.
Reemplace WABA_ID con el ID de su cuenta de WhatsApp Business y configure YCLOUD_API_KEY en su entorno. Utilice datos ficticios de clientes en la muestra:
category antes de usar el contenido en una solicitud de Direct Send de Utility. Si Meta detecta MARKETING o AUTHENTICATION, revise el contenido o utilice el flujo de mensajería adecuado. Para una muestra con botones, envíe los campos type y interactive de un ejemplo de envío anterior; omita los campos de destinatario y de envío.
Distinguir una plantilla pausada de una restricción de la cuenta
Una plantilla puede pausarse debido a una baja calidad. Los mensajes que coincidan con ella, o que sean muy similares, pueden fallar a continuación con el error de Meta132015. Busque la plantilla afectada en YCloud, inspeccione su contenido y estado, y solucione la causa antes de reanudar esa notificación.
El uso indebido reiterado de categorías puede restringir Direct Send para todo el WABA:
Recibir notificaciones de YCloud
whatsapp.template.correct_category_detection a través de su endpoint de webhook si desea recibir notificaciones de detección de categorías. No es una respuesta a messageSamples y no se activa para cada mensaje. En el objeto whatsappTemplate del evento, compare previousCategory con category. Por ejemplo, previousCategory: "UTILITY" y category: "MARKETING" significa que Meta identificó contenido de marketing en una plantilla de Direct Send de Utility. Revise el contenido antes de volver a enviar mensajes similares. Utilice whatsapp.message.updated para hacer un seguimiento de la entrega por separado.
Campos relevantes de un evento de restricción de cuenta de YCloud:
violationType para conocer el motivo y restrictions[].expiration para ver su vencimiento, cuando se proporcione.
Solicitar una revisión de una decisión sobre la categoría
Si considera que el contenido fue marcado incorrectamente, abra Meta Business Support Home → Cuenta de WhatsApp → Actualizaciones de plantillas de Direct Send → Disponibles para revisión. Seleccione las plantillas afectadas y elija Solicitar revisión. Envía la solicitud en un plazo de 60 días a partir de la notificación. Cada plantilla marcada puede revisarse una sola vez. Haz un seguimiento del resultado como In review, Reversed o Unchanged. Si la opción de revisión no está disponible, contacta a YCloud con el WABA ID, el nombre o ID de la plantilla, el idioma y los detalles de la notificación.Preguntas frecuentes sobre Direct Send
¿Necesito un nombre de plantilla antes de enviar?
¿Necesito un nombre de plantilla antes de enviar?
template.name y establece useDirectSend: true. El campo opcional templateName asigna un nombre a una plantilla de Utility de Direct Send; no selecciona una plantilla existente.¿Por qué Direct Send sigue generando plantillas?
¿Por qué Direct Send sigue generando plantillas?
¿Puedo enviar fuera de la ventana de servicio de atención al cliente de 24 horas?
¿Puedo enviar fuera de la ventana de servicio de atención al cliente de 24 horas?
¿Por qué un mensaje puede tener éxito antes de que aparezca su plantilla generada?
¿Por qué un mensaje puede tener éxito antes de que aparezca su plantilla generada?
¿Cómo se limpian las plantillas generadas que no se usan?
¿Cómo se limpian las plantillas generadas que no se usan?
¿Establecer utility garantiza que Meta aceptará la categoría?
¿Establecer utility garantiza que Meta aceptará la categoría?
¿Cómo se factura Direct Send?
¿Cómo se factura Direct Send?

