Cómo enviar una plantilla, foto o video al cliente con un agente de IA
Para que tu agente de IA envíe una foto, un video o un archivo al cliente, incluye el campo template_ids con los id de las plantillas de AnyLinga en la respuesta a callback_url. Puedes incluir hasta 5 id; el campo reply_text es opcional.
Cómo se envían los archivos adjuntos
Una plantilla contiene texto y archivos adjuntos que guardaste previamente en AnyLinga. Tu agente elige las plantillas necesarias y AnyLinga las envía al cliente.
Obtén la lista de plantillas
1. Consulta las plantillas disponibles
- Ejecuta
GET /api/connect/templatescon el mismo encabezadoAuthorization: Bearer <Token de callback>. - La respuesta incluirá los campos
id,name,category,provider,bodyy los archivos adjuntos enattachmentspara cada plantilla. Las plantillas de WhatsApp Business API también incluirán el bloquemeta. - Elige las plantillas que necesites y toma sus
idpara enviarlas.
Incluye las plantillas en la respuesta del agente
2. Agrega template_ids a la respuesta
- En la respuesta a
callback_url, incluye el arreglotemplate_idscon hasta 5 id de plantillas. - Agrega
reply_textsi necesitas enviar un texto por separado antes de las plantillas. Si no lo necesitas, puedes omitir el campo.
{
"correlation_id": "b1e7d0c4-2f3a-4e8b-9c6d-7a5f1e2d3c4b",
"reply_text": "Aquí tienes nuestro catálogo y un video sobre las entregas.",
"template_ids": ["7d1f0c2a-4b3e-4a9d-8c61-2e5f9b0a7d34"]
}
AnyLinga devolverá en la respuesta una lista templates con el resultado de cada plantilla: ok, parts_sent o el code del error. Si no había texto y no se envió ninguna plantilla, la respuesta será 502.
También puedes incluir las plantillas en /api/connect/send cuando el agente inicia la conversación con el cliente.
Orden de envío y restricciones
Primero se envía reply_text con la traducción y luego las plantillas, una por una. El texto de la plantilla y los archivos adjuntos se envían en mensajes separados. Los videos se envían como videos.
El texto de la plantilla no se traduce: el cliente lo recibirá tal como está escrito en la plantilla.
Solo se pueden usar plantillas publicadas. Las plantillas de WhatsApp Business API deben estar aprobadas por Meta. De lo contrario, AnyLinga devolverá 404 con el template_id de esa plantilla.
Las plantillas se validan antes de que la respuesta se registre como procesada. Si hay un error en el id, corrígelo y vuelve a enviar la respuesta con el mismo correlation_id.
Preguntas relacionadas
Plantillas de respuestas rápidas · Plantillas de WhatsApp · Cómo iniciar una conversación con el cliente desde el agente
¿Tienes preguntas?
Respondemos en horario laboral.