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.
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.
httpAuthorizationBearer <clave>contact*integermessage*integerOK
application/json- response
id*integercontact_id*integer|nulldevice_id*integer|nulldirection*string"outbound""inbound"type*string"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*|"sent""delivered""read""failed""queued"nullerror*|nullclient_reference*string|nullcreated_at*string|nullupdated_at*string|nullcurl -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"}Listar los mensajes de un contacto GET
Sirve para traer el historial de mensajes de un contacto y mantenerlo sincronizado en tu sistema, con paginación por cursor y updated_since para pedir solo lo nuevo.
Mensajes
Contiene el envío de un mensaje de texto o archivo indicando en el cuerpo el contact_id y el número desde el que sale (device_id).