Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
 
 
DESCRIÇÃO

Esta API facilita que

...

a sua aplicação receba automático o status de cada SMS enviado com short number, cada vez que um SMS muda de status, ex.:

    • se o SMS foi entregue na operadora

...

    • móvel;
    • se o SMS foi entregue no telefone móvel de destino;
    • se o número do destino não era válido, etc.

Para automatizar o recebimento de status de SMS no seu sistema basta registrar uma URL de notificação, conforme indicamos a seguir:

...

 
 
DESCRIÇÃOCom este método podemos registrar um URL para recebimento de callback de SMS enviado

ESTRUTURA DA URLhttps://api.directcallsoft.com/sms/add-callback-status
VERSÃO1
MÉTODOPOST
PARÂMETROS

access_token obrigatório Chave de acesso ao método, para saber como obter clique aqui

url obrigatório (String) URL para envio do SMS recebido 

IMPORTANTE: Você pode evitar que a sua URL fique exposta utilizando autenticação por HTTP Basic Auth, basta adicionar ao inicio da URL usuário e senha: Por exemplo: https://usuario:[email protected]  

format opcional Opção de retorno da API podendo ser JSON ou XML, se não informado JSON será o padrão

RETORNO

api Origem API que esta sendo usada

modulo Módulo que está sendo chamado

status Mensagem de status

codigo Código de retorno - Clique aqui para listar os códigos e suas descrições

code Identificador unico da URL registrada

 

Exemplo de resposta em JSON

{

"api":"sms",
"modulo":"add-callback",
"status":"ok",
"codigo":"001",
"msg":"URL de Callback cadastrada com sucesso.",
"code":"7cfa08f1bdc011d524d8ec8bbceb7d06df237a14"
}

 

...

 
 
DESCRIÇÃODados vindo do callback
VERSÃO1
MÉTODOPOST
PARÂMETROS

to - Numero origem do SMS recebido

msg - Mensagem de texto recebida pelo sistema

date Data de recebimento do SMS : Formato dd-mm-YYYY

code - Código identificador do SMS no sistema

status - Mensagem de status do sistema

...

 

 

 

Informações
titleValidade dos tokens: Os tokens de acesso têm uma validade limitada, por isso convém que o sistema criado tenha em conta estes timings para que possa desenvolver rotinas de requisação de novos tokens.

 

Veja também: