AnyLinga
ES
Iniciar sesión Prueba gratis

Centro de ayuda/Agente de IA

Cómo enviar una plantilla, foto o video al cliente con un agente de IA

Actualizado: 2026-11-11

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/templates con el mismo encabezado Authorization: Bearer <Token de callback>.
  • La respuesta incluirá los campos id, name, category, provider, body y los archivos adjuntos en attachments para cada plantilla. Las plantillas de WhatsApp Business API también incluirán el bloque meta.
  • Elige las plantillas que necesites y toma sus id para enviarlas.
El límite es de 30 solicitudes por minuto.

Incluye las plantillas en la respuesta del agente

2. Agrega template_ids a la respuesta

  • En la respuesta a callback_url, incluye el arreglo template_ids con hasta 5 id de plantillas.
  • Agrega reply_text si 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.

Plantillas de respuestas rápidas · Plantillas de WhatsApp · Cómo iniciar una conversación con el cliente desde el agente

¿Te resultó útil este artículo?

¿Tienes preguntas?

Respondemos en horario laboral.

¿Ya usas AnyLinga?

Cuéntanos tu pregunta y te respondemos por WhatsApp o email.

¿Aún no tienes cuenta?

Pruébalo tú mismo o lo conectamos por ti al pagar el primer mes.

Consultar conexión

Qué necesitas