Status da mensagem

curl -X GET "https://api.mindosoftware.com/api/v1/meta-templates/messages/wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=/" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

import requests

message_id = "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA="

response = requests.get(
    f"https://api.mindosoftware.com/api/v1/meta-templates/messages/{message_id}/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
)

data = response.json()
print(f"Status atual: {data['delivery_status']['current']}")
print(f"Entregue: {data['delivery_status']['delivered_at']}")
print(f"Lida: {data['delivery_status']['read_at']}")

const messageId = "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=";

const response = await fetch(
  `https://api.mindosoftware.com/api/v1/meta-templates/messages/${encodeURIComponent(messageId)}/`,
  {
    method: "GET",
    headers: {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
);

const data = await response.json();
console.log("Status atual:", data.delivery_status.current);
console.log("Entregue:", data.delivery_status.delivered_at);
console.log("Lida:", data.delivery_status.read_at);

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

{
  "error": "Mensaje no encontrado"
}

{
  "error": "No tienes acceso a este mensaje"
}

{
  "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}

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"

import requests

message_id = "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA="

response = requests.get(
    f"https://api.mindosoftware.com/api/v1/meta-templates/messages/{message_id}/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
)

data = response.json()
print(f"Status atual: {data['delivery_status']['current']}")
print(f"Entregue: {data['delivery_status']['delivered_at']}")
print(f"Lida: {data['delivery_status']['read_at']}")

const messageId = "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=";

const response = await fetch(
  `https://api.mindosoftware.com/api/v1/meta-templates/messages/${encodeURIComponent(messageId)}/`,
  {
    method: "GET",
    headers: {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
);

const data = await response.json();
console.log("Status atual:", data.delivery_status.current);
console.log("Entregue:", data.delivery_status.delivered_at);
console.log("Lida:", data.delivery_status.read_at);

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

{
  "error": "Mensaje no encontrado"
}

{
  "error": "No tienes acceso a este mensaje"
}

{
  "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}

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

string

obrigatório

Sua API Key da Mindo. Formato: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

Parâmetros de rota

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.

object

Informações do template utilizado.

Mostrar Propriedades de template

integer

ID interno do template.

string

Nome do template.

string

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

string

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

object

Informações do destinatário.

Mostrar Propriedades de recipient

string

Número de telefone do destinatário.

string | null

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

integer | null

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

object

Variáveis usadas para renderizar o template neste envio.

object

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

Mostrar Propriedades de delivery_status

string

Status atual da mensagem. Veja tabela de status.

string (ISO 8601) | null

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

string (ISO 8601) | null

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

string (ISO 8601) | null

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

string (ISO 8601) | null

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

string | null

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

string | null

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

string | null

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

boolean

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

string | null

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

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"

import requests

message_id = "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA="

response = requests.get(
    f"https://api.mindosoftware.com/api/v1/meta-templates/messages/{message_id}/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
)

data = response.json()
print(f"Status atual: {data['delivery_status']['current']}")
print(f"Entregue: {data['delivery_status']['delivered_at']}")
print(f"Lida: {data['delivery_status']['read_at']}")

const messageId = "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=";

const response = await fetch(
  `https://api.mindosoftware.com/api/v1/meta-templates/messages/${encodeURIComponent(messageId)}/`,
  {
    method: "GET",
    headers: {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
);

const data = await response.json();
console.log("Status atual:", data.delivery_status.current);
console.log("Entregue:", data.delivery_status.delivered_at);
console.log("Lida:", data.delivery_status.read_at);

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

{
  "error": "Mensaje no encontrado"
}

{
  "error": "No tienes acceso a este mensaje"
}

{
  "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}