Estado da mensagem (Meta)

GET https://app.sendapp.ai/api/whatsapp-meta/message-status

Obtém o estado de entrega de uma mensagem WhatsApp Meta a partir do seu wamid (o id devolvido no envio). Devolve o estado atual: sent, delivered, read ou failed.

Os estados ficam disponíveis durante 7 dias após o envio. Não é preciso registar um endereço próprio: o estado lê-se sempre com esta chamada. Se preferir receber as atualizações em tempo real no seu servidor, use os webhooks de estado.

Parâmetros

3 · 2 obrigatórios

apikey obrigatório

A tua API Key.

wamid obrigatório

O id da mensagem (wamid) devolvido pelo endpoint de envio.

token opcional

Token da conta (recomendado): limita a pesquisa a uma conta específica.

Precisa de ajuda com a integração? info@sendapp.live

Pedido

curl 'https://app.sendapp.ai/api/whatsapp-meta/message-status?apikey=YOUR_API_KEY&wamid=wamid.HBgLMzkxMjM0NTY3ODkwFQIAERgS'

<?php
$ch = curl_init('https://app.sendapp.ai/api/whatsapp-meta/message-status?' . http_build_query([
    'apikey' => 'YOUR_API_KEY',
    'wamid'  => 'wamid.HBgLMzkxMjM0NTY3ODkwFQIAERgS',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
echo curl_exec($ch);

const params = new URLSearchParams({
  apikey: 'YOUR_API_KEY',
  wamid: 'wamid.HBgLMzkxMjM0NTY3ODkwFQIAERgS'
});
const res = await fetch('https://app.sendapp.ai/api/whatsapp-meta/message-status?' + params);
console.log(await res.json());

Resposta

{
  "status": "success",
  "wamid": "wamid.HBgLMzkxMjM0NTY3ODkwFQIAERgS",
  "message_status": "delivered",
  "recipient": "391234567890",
  "timestamp": "2026-07-13 10:00:00",
  "error_message": null
}

{
  "status": "error",
  "message": "Message not found or status no longer available (statuses are retained for 7 days)."
}