Ver un mensaje

Usalo para saber qué pasó con un mensaje que enviaste: con el id que te devolvió el envío ves su estado (en cola, enviado, entregado, leído o fallido) y, si falló, el motivo.

GET
/contacts/{contact}/messages/{message}

Permiso requerido: conversations:read

Devuelve un mensaje de tu cuenta por el id que te dio el envío o un webhook. Aceptado no es entregado: el estado final llega por message.status_changed o por este GET. status es queued, sent, delivered, read o failed en los mensajes que enviaste. sent, delivered, read y failed tienen el mismo significado que en message.status_changed; queued es un mensaje en cola que todavía no se envió (en cola no es enviado) y no se reintenta. status es null en los mensajes recibidos, las notas y las acciones. status también es null en un mensaje enviado cuyo resultado no se conoce (el proveedor no confirmó ni rechazó el envío o el envío se interrumpió): puede haber llegado y no cambia de estado; también cuando lleva más de una hora en cola sin resultado: un mensaje cuyo envío no empezó dentro de la hora ya no sale; pasada la hora sin resultado, status es null, o failed con error.reason not_sent y su aviso si su envío llega tarde. Reintentar es un envío nuevo, que sólo puede duplicar si el envío había empezado y se cortó. error trae code, title y reason solo cuando status es failed. error.reason es null cuando el rechazo lo informó el proveedor; si Funnelchat decidió que un mensaje enviado con clave no salía, trae device_unavailable, insufficient_balance, window_closed, recipient_unreachable, template_not_found, template_unresolved_placeholder, not_queued o not_sent, code es null y title es un texto llano en el idioma de la cuenta. client_reference es la referencia que mandaste al enviar, o null. Responde 404 si el mensaje no existe o no es de ese contacto.

Autorización

http
headerAuthorizationBearer <clave>

Parámetros de la ruta

contact*integer
message*integer

Cuerpo de la respuesta

OK

application/json
  1. response
id*integer
contact_id*integer|null
device_id*integer|null
direction*string
Valor en"outbound""inbound"
type*string
Valor en"text""image""video""document""sticker""contact""audio""note""action""invalid""interactive""location""voice_call""video_call""event""button""template""notification""option_list""template_button_reply""poll""whatsapp_form""call_permission_request""call_permission_reply""request_contact_info"
status*|
Valor en"sent""delivered""read""failed""queued"null
error*|null
client_reference*string|null
created_at*string|null
updated_at*string|null
curl -X GET "https://example.com/contacts/0/messages/0"
{  "id": 0,  "contact_id": 0,  "device_id": 0,  "direction": "outbound",  "type": "text",  "status": "sent",  "error": {    "code": 0,    "title": "string",    "reason": "string"  },  "client_reference": "string",  "created_at": "string",  "updated_at": "string"}