Conversaciones

Envía y recibe mensajes a través de WhatsApp, Facebook Messenger e Instagram. La API detecta automáticamente el canal de cada conversación y enruta los mensajes al servicio correcto.

Listar conversaciones

GET /v1/conversations

Parámetros opcionales: channel (whatsapp, messenger, instagram), status (open, waiting, resolved, closed), customer (UUID), assigned_to (UUID), has_referral (true = solo las que vinieron de un anuncio), ad_id (filtrar por ID de anuncio), limit, page

Cada conversación incluye el objeto referral (o null) con los datos del anuncio de origen cuando la conversación proviene de publicidad (Meta ads / click-to-WhatsApp): source_id (ID del anuncio), source_type, headline, source_url, body, ctwa_clid, media_url. Usa ?has_referral=true para traer solo esas.

Obtener conversación

GET /v1/conversations/{'{id}'}

Incluye cliente y agente asignado.

Listar mensajes

GET /v1/conversations/{'{id}'}/messages

Parámetros opcionales: type (text, image, video, audio, document, template), limit, page

Enviar mensaje

POST /v1/conversations/{'{id}'}/messages

Cuerpo — mensaje de texto

{
  "body": "Hola, tu pedido ha sido enviado. Número de guía: ABC123"
}

Cuerpo — mensaje con multimedia

{
  "body": "Aquí está tu factura",
  "media_url": "https://ejemplo.com/factura.pdf",
  "media_type": "document"
}

Campo	Tipo	Requerido	Descripción
`body`	string	No*	Texto del mensaje (máx. 4096 caracteres)
`media_url`	url	No*	URL del archivo multimedia
`media_type`	string	No	image, video, audio, document

* Se requiere al menos body o media_url.

Enviar plantilla de WhatsApp

POST /v1/conversations/{'{id}'}/send-template

Cuerpo

{
  "template_id": "uuid-del-template",
  "variables": {
    "1": "Juan Pérez",
    "2": "$1,500.00",
    "3": "15 de marzo"
  }
}

Solo disponible para conversaciones de WhatsApp. Las plantillas deben estar aprobadas por Meta.

Resolver / Cerrar conversación

POST /v1/conversations/{'{id}'}/resolve — Marcar como resuelta

POST /v1/conversations/{'{id}'}/close — Cerrar definitivamente

¿Te sirvió esta página? Gracias por avisarnos.