Atlassian uses cookies to improve your browsing experience, perform analytics and research, and conduct advertising. Accept all cookies to indicate that you agree to our use of cookies on your device. Atlassian cookies and tracking notice, (opens new window)
Directcall
Recebimento de SMS, Callback para receber mensagens automatico
Este método facilita que a sua aplicação receba automaticamente os dados de "SMS respondido" e de "SMS recebido":
A qualquer momento, o cliente receberá os dados de SMS respondido ou de SMS recebido, se contratou palavra-chave e o remetente incluiu a palavra-chave na mensagem (ex.: BBB, desejo participar), mesmo quando não tiver contratado short number exclusivo.
A qualquer momento, o cliente receberá os dados de SMS respondido ou de SMS recebido, quando tiver contratado short number exclusivo.
|
|
|---|---|
DESCRIÇÃO | Para receber automaticamente dados de "SMS recebido" e de "SMS respondido" na sua aplicação, sempre que uma nova mensagem chegar, basta registrar uma URL de notificação, conforme indicamos a seguir:
|
ESTRUTURA DA URL | |
VERSÃO | 1 |
MÉTODO | POST |
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 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 está 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 único 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"
} |
Caso você já tenha registrado uma ou mais URL de callback, você pode consultar a(s) URL(s) através do seguiste método:
Consultar URL(s) registradas para callback
|
|
|---|---|
DESCRIÇÃO | Com este método podemos verificar todas as URL registradas |
ESTRUTURA DA URL | |
VERSÃO | 1 |
MÉTODO | POST | GET |
PARÂMETROS | access_token obrigatório Chave de acesso ao método, para saber como obter clique aqui 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 está 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 total Total de URL's registradas rows Array com resultado, tendo a url e o code (identificador único)
Exemplo de resposta em JSON{
"api":"sms",
"modulo":"list-callback",
"status":"ok",
"codigo":"001",
"msg":[],
"total":2,
"rows":
[
{"code":"aedd74c466f0dba65bc641f19355bf7a98d790c9","url":"http:\/\/www.sesite.com.br\/webservice\/test.php"}, {"code":"7cfa08f1bdc011d524d8ec8bbceb7d06df237a14","url":"http:\/\/www.sesite.com.br\/webservice\/test2.php"}
]
} |
Para remover uma URL que está registrada para receber o callback de um SMS recebido você vai precisar o code (Identificador único da URL).
Removendo URL registrada para callback
|
|
|---|---|
DESCRIÇÃO | Com este método podemos remover uma URL registrada para recebimento de callback de SMS recebido |
ESTRUTURA DA URL | |
VERSÃO | 1 |
MÉTODO | POST |
PARÂMETROS | access_token obrigatório Chave de acesso ao método, para saber como obter clique aqui code obrigatório (String) Identificador único da URL registrada a ser removida 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 está 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
Exemplo de resposta em JSON{
"api":"sms",
"modulo":"add-callback",
"status":"ok",
"codigo":"001",
"msg":"URL de Callback removida com sucesso."
} |
Como vou receber e quais dados vou receber pelo sistema de callback?
- Nosso sistema vai realizar um POST HTTP para a sua URL, e os dados da mensagem serão encaminhados no formato JSON
Dados recebidos vindo do Callback
|
|
|---|---|
DESCRIÇÃO | Dados vindo do callback |
FORMATO | JSON |
VERSÃO | 1 |
MÉTODO | POST |
PARÂMETROS | from - Número 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 |
Validade 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:
HELPER para facilitar o envio de SMS na sua aplicação
Acelere a implantação com este miniaplicativo baseado em HTML e Javascript, com interfaces prontas para os usuários da sua aplicação utilizarem esta API.