Rastreamento
Status da mensagem e relatórios de entrega
| status | Significado | Final | Cobrado |
|---|---|---|---|
| scheduled | Aguardando send_at. | No | Sim, reembolsado se cancelado |
| queued | Aceito e aguardando a próxima passagem da fila (a cada dois segundos). | No | Yes |
| sent | Entregue à rede; aguardando o relatório de entrega. | No | Yes |
| delivered | O aparelho confirmou a entrega. | Yes | Yes |
| failed | Não pôde ser entregue; o erro explica o motivo. | Yes | Não, reembolsado |
| canceled | Seu lote agendado foi cancelado. | Yes | Não, reembolsado |
Códigos de erro nas mensagens
| error.code | Significado |
|---|---|
| network_error | A mensagem não pôde ser entregue à rede. Seu valor foi devolvido ao saldo. |
| undeliverable | A rede informou que o aparelho não pôde ser alcançado. |
| canceled | O lote agendado foi cancelado antes de começar. |
Reembolsos
Quando uma mensagem falha, seu valor total é devolvido ao saldo na mesma passagem, como uma linha de reembolso no registro que nomeia o lote. O campo refunded do lote mostra o total acumulado.
Webhooks ou polling
Webhooks são o caminho rápido: cada status final chama seu endpoint assim que é definido. Para volumes pequenos ou para verificação, use polling GET /v1/messages/{id} ou GET /v1/batches/{id}; o limite de taxa permite ambos.