Status da mensagem

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"
}

GET

api

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"
}

Descrição

Este endpoint retorna o status atualizado de uma mensagem individual enviada com um template do WhatsApp. É o complemento do padrão fire-and-forget de Enviar mensagem: você usa o message_id (wamid) retornado no envio para consultar em qual status de entrega a mensagem está. Os status de entrega (sent, delivered, read, failed) são atualizados automaticamente conforme a Meta envia os webhooks correspondentes. Uma mensagem recém-enviada normalmente mostra sent até chegarem as confirmações de entrega e leitura.

Cabeçalho de autenticação

X-API-Key

string

obrigatório

Sua API Key da Mindo. Formato: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

Parâmetros de rota

message_id

string

obrigatório

ID da mensagem atribuído pela Meta (wamid). É o valor de message_id retornado por Enviar mensagem ao enviar o template.

Resposta (200 OK)

integer

ID interno do registro de envio na Mindo.

template

object

Informações do template utilizado.

Mostrar Propriedades de template

integer

ID interno do template.

name

string

Nome do template.

language

string

Idioma do template (ex: "es", "en", "pt_BR").

category

string

Categoria do template na Meta (ex: "MARKETING", "UTILITY", "AUTHENTICATION").

recipient

object

Informações do destinatário.

Mostrar Propriedades de recipient

phone

string

Número de telefone do destinatário.

contact_name

string | null

Nome do contato na Mindo. null se o telefone não corresponder a um contato registrado.

contact_id

integer | null

ID do contato na Mindo. null se o telefone não corresponder a um contato registrado.

variables_used

object

Variáveis usadas para renderizar o template neste envio.

delivery_status

object

Status de entrega detalhado com os timestamps de cada transição. Atualizado via webhooks da Meta.

Mostrar Propriedades de delivery_status

current

string

Status atual da mensagem. Veja tabela de status.

sent_at

string (ISO 8601) | null

Data e hora em que a mensagem foi enviada para a Meta.

delivered_at

string (ISO 8601) | null

Data e hora da entrega ao dispositivo. null se ainda não foi entregue.

read_at

string (ISO 8601) | null

Data e hora da leitura. null se ainda não foi lida.

failed_at

string (ISO 8601) | null

Data e hora em que o envio falhou. null se não falhou.

error_code

string | null

Código de erro da Meta se a mensagem falhou. null se não houve erro.

error_message

string | null

Descrição do erro se a mensagem falhou. null se não houve erro.

meta_message_id

string | null

ID da mensagem na Meta (wamid). Coincide com o message_id da rota.

was_successful

boolean

Indica se o envio inicial para a Meta foi bem-sucedido.

error_message

string | null

Mensagem de erro do envio inicial. null se não houve erro.

sent_at

string (ISO 8601)

Data e hora em que o envio foi registrado.

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"
}