SMS DLR


Webhook de Envios SMS (DLR)

Configuração: Informar no corpo da requisição POST /sms/messages/ o campo url_callback_dlr

Callback das mensagens SMS enviadas.

Payload

CampoTipoDescrição
phoneintegerNúmero de telefone destinatário.
messagestringMensagem enviada.
statusstringStatus do envio (ver tabela abaixo).
referencestringReference informado no envio.
reason_errorstringMotivo do erro, se houver.

Status possíveis

StatusDescrição
PROCESSEDMensagem enviada para processamento.
SENT_TO_COMPANYEnviado para operadora.
DELIVERED_TO_CELLPHONEEntregue no aparelho.
NOT_DELIVERED_TO_CELLPHONENão entregue no aparelho.
INVALIDNúmero sintaticamente correto mas não ativo na rede.
ERRORErro no envio (ver reason_error).
BLACKLIST_USERNúmero na blacklist personalizada.
BLACKLIST_NEXUSNúmero na blacklist do Nexus.
NOT_IN_WHITELISTNúmero não está na whitelist.

Exemplo - Sucesso

{
  "phone": 5567898765544,
  "message": "Mensagem enviada",
  "status": "DELIVERED_TO_CELLPHONE",
  "reference": "refId2",
  "reason_error": null
}

Exemplo - Erro

{
  "phone": 5567898765544,
  "message": "Mensagem enviada",
  "status": "ERROR",
  "reference": "refId2",
  "reason_error": "Invalid syntax for phone number"
}

Exemplo - Blacklist

{
  "phone": 5567898765544,
  "message": "Mensagem enviada",
  "status": "BLACKLIST_USER",
  "reference": "refId2",
  "reason_error": null
}

Webhook de Envios SMS (DLR)

Callback das mensagens SMS enviadas. A URL deve ser informada no campo url_callback_dlr ao enviar a mensagem.

Payload

CampoTipoDescrição
phoneintegerNúmero de telefone destinatário.
messagestringMensagem enviada.
statusstringStatus do envio (ver tabela abaixo).
referencestringReference informado no envio.
reason_errorstringMotivo do erro, se houver.

Status possíveis

StatusDescrição
PROCESSEDMensagem enviada para processamento.
SENT_TO_COMPANYEnviado para operadora.
DELIVERED_TO_CELLPHONEEntregue no aparelho.
NOT_DELIVERED_TO_CELLPHONENão entregue no aparelho.
INVALIDNúmero sintaticamente correto mas não ativo na rede.
ERRORErro no envio (ver reason_error).
BLACKLIST_USERNúmero na blacklist personalizada.
BLACKLIST_NEXUSNúmero na blacklist do Nexus.
NOT_IN_WHITELISTNúmero não está na whitelist.

Exemplo - Sucesso

{
  "phone": 5567898765544,
  "message": "Mensagem enviada",
  "status": "DELIVERED_TO_CELLPHONE",
  "reference": "refId2",
  "reason_error": null
}

Exemplo - Erro

{
  "phone": 5567898765544,
  "message": "Mensagem enviada",
  "status": "ERROR",
  "reference": "refId2",
  "reason_error": "Invalid syntax for phone number"
}

Exemplo - Blacklist

{
  "phone": 5567898765544,
  "message": "Mensagem enviada",
  "status": "BLACKLIST_USER",
  "reference": "refId2",
  "reason_error": null
}