Este método facilita que a sua aplicação receba automaticamente os dados de "SMS respondido" e de "SMS recebido":
- Em até 72 horas o cliente receberá a resposta de SMS enviado sem que o remetente precise utilizar palavras-chave, mesmo quando não tiver contratado short number exclusivo.
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
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
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 |
Informações |
---|
...
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.