Saltar al contenido principal
GET
/
api
/
v1
/
meta-templates
/
messages
/
{message_id}
/
curl -X GET "https://api.mindosoftware.com/api/v1/meta-templates/messages/wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=/" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "id": 123,
  "template": {
    "id": 45,
    "name": "welcome_message",
    "language": "es",
    "category": "MARKETING"
  },
  "recipient": {
    "phone": "+5491112345678",
    "contact_name": "Juan Perez",
    "contact_id": 789
  },
  "variables_used": {
    "name": "Juan Perez",
    "code": "ABC123"
  },
  "delivery_status": {
    "current": "read",
    "sent_at": "2025-11-16T21:30:00Z",
    "delivered_at": "2025-11-16T21:30:05Z",
    "read_at": "2025-11-16T21:31:00Z",
    "failed_at": null,
    "error_code": null,
    "error_message": null
  },
  "meta_message_id": "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=",
  "was_successful": true,
  "error_message": null,
  "sent_at": "2025-11-16T21:30:00Z"
}

​
Descripción

Este endpoint devuelve el estado actualizado de un mensaje individual enviado con un template de WhatsApp. Es el complemento del patrón fire-and-forget de Enviar mensaje: usás el message_id (wamid) que retorna el envío para consultar en qué estado de entrega está el mensaje. Los estados de entrega (sent, delivered, read, failed) se actualizan automáticamente a medida que Meta envía los webhooks correspondientes. Un mensaje recién enviado suele mostrar sent hasta que llegan las confirmaciones de entrega y lectura.

​
Header de autenticación

​
X-API-Key
string
requerido
Tu API Key de Mindo. Formato: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

​
Parámetros de ruta

​
message_id
string
requerido
ID del mensaje asignado por Meta (wamid). Es el valor de message_id que retorna Enviar mensaje al enviar el template.

​
Respuesta (200 OK)

​
id
integer
ID interno del registro de envío en Mindo.
​
template
object
Información del template utilizado.
​
recipient
object
Información del destinatario.
​
variables_used
object
Variables que se usaron para renderizar el template en este envío.
​
delivery_status
object
Estado de entrega detallado con los timestamps de cada transición. Se actualiza vía webhooks de Meta.
​
meta_message_id
string | null
ID del mensaje en Meta (wamid). Coincide con el message_id de la ruta.
​
was_successful
boolean
Indica si el envío inicial a Meta fue exitoso.
​
error_message
string | null
Mensaje de error del envío inicial. null si no hubo error.
​
sent_at
string (ISO 8601)
Fecha y hora en que se registró el envío.
curl -X GET "https://api.mindosoftware.com/api/v1/meta-templates/messages/wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=/" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "id": 123,
  "template": {
    "id": 45,
    "name": "welcome_message",
    "language": "es",
    "category": "MARKETING"
  },
  "recipient": {
    "phone": "+5491112345678",
    "contact_name": "Juan Perez",
    "contact_id": 789
  },
  "variables_used": {
    "name": "Juan Perez",
    "code": "ABC123"
  },
  "delivery_status": {
    "current": "read",
    "sent_at": "2025-11-16T21:30:00Z",
    "delivered_at": "2025-11-16T21:30:05Z",
    "read_at": "2025-11-16T21:31:00Z",
    "failed_at": null,
    "error_code": null,
    "error_message": null
  },
  "meta_message_id": "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=",
  "was_successful": true,
  "error_message": null,
  "sent_at": "2025-11-16T21:30:00Z"
}

​
Estados del mensaje

El campo delivery_status.current puede tener los siguientes valores:
EstadoDescripción
sentMensaje enviado a Meta exitosamente
deliveredMensaje entregado al dispositivo del destinatario
readMensaje leído por el destinatario
failedEl envío del mensaje falló
Los estados se actualizan automáticamente a medida que Meta envía los webhooks de entrega y lectura. Si consultás inmediatamente después de enviar, es normal ver el estado sent hasta que lleguen las confirmaciones.