Skip to main content
GET
https://api.enviaai.app
/
v1
/
messages
/
{messageId}
/
status
Status da Mensagem
curl --request GET \
  --url https://api.enviaai.app/v1/messages/{messageId}/status \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "messageId": "msg_xyz789",
    "status": "delivered",
    "to": "5511999999999",
    "sentAt": "2026-02-03T12:00:00.000Z",
    "deliveredAt": "2026-02-03T12:00:02.000Z",
    "readAt": null
  }
}

​
Path Parameters

​
messageId
string
required
ID da mensagem

​
Response

​
messageId
string
ID da mensagem
​
status
string
Status atual: queued, sent, delivered, read, failed
​
to
string
Número do destinatário
​
sentAt
string
Timestamp do envio
​
deliveredAt
string
Timestamp da entrega
​
readAt
string
Timestamp da leitura
​
error
object
Detalhes do erro (se failed)

​
Exemplo

const status = await client.messages.getStatus('msg_xyz789');

console.log('Status:', status.status);
console.log('Enviada em:', status.sentAt);
console.log('Entregue em:', status.deliveredAt);

{
  "success": true,
  "data": {
    "messageId": "msg_xyz789",
    "status": "delivered",
    "to": "5511999999999",
    "sentAt": "2026-02-03T12:00:00.000Z",
    "deliveredAt": "2026-02-03T12:00:02.000Z",
    "readAt": null
  }
}

​
Fluxo de Status

​
Alternativa: Webhooks

Em vez de fazer polling, use webhooks para receber atualizações:
  • message.sent - Quando enviada
  • message.delivered - Quando entregue
  • message.read - Quando lida
  • message.failed - Quando falhar