Eventos

SMS recebido

Dispara quando o dispositivo Android recebe um SMS. É a base de chatbots e respostas automáticas.

{
  "event": "sms.received",
  "timestamp": "2026-08-14T10:30:45.123Z",
  "workspaceId": "workspace_abc123",
  "data": {
    "message": {
      "id": "msg_01H8X",
      "from": "+351912345678",
      "body": "Quinta de manha, se for possivel.",
      "deviceId": "dev_oppo_cph2577"
    }
  }
}

SMS enviado

Dispara quando o dispositivo entrega a mensagem à rede móvel. Enviado não é o mesmo que entregue.

SMS entregue

Dispara quando a operadora confirma a entrega ao destinatário. É o evento que confirma mesmo que a mensagem chegou.

SMS falhado

Dispara quando o envio falha. Traz sempre o motivo, e é o motivo que permite agir: número inválido corrige-se no contacto, sem saldo resolve-se na conta, rejeitada pelo operador resolve-se mudando o remetente.

{
  "event": "sms.failed",
  "timestamp": "2026-08-14T10:31:15.789Z",
  "data": {
    "message": { "id": "msg_01H8Y", "to": "+351967880231" },
    "error": { "code": "invalid_number", "message": "numero invalido" }
  }
}