Esta API facilita que o sistema do cliente receba automatico o status de cada SMS enviado, cada vez que um SMS muda de status, ex. se o SMS foi entregue na operadora móvel, se o número do destino não era válido, etc.
Diferencial da Directcall no SMS com short number:
- Fornece inclusive status se o SMS foi recebido "no celular do destinatário", enquanto a maior parte dos fornecedores de SMS informam apenas se o SMS foi entregue na operadora móvel.Quando não consegue entregar um SMS "no celular do destinatário" estorna o SMS não entregue, após tentar por até 72h.
Para automatizar o recebimento de status de SMS no seu sistema basta registrar uma URL de notificação.
Registrando um URL de notificação
| DESCRIÇÃO | Com este método podemos registrar um URL para recebimento de callback de SMS enviado | |||
| ESTRUTURA DA URL | https://api.directcallsoft.com/sms/add-callback-status | |||
| 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 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
|
...
| DESCRIÇÃO | Com este método podemos verificar todas as URL registradas | |||
| ESTRUTURA DA URL | https://api.directcallsoft.com/sms/list-callback | |||
| 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 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 total Total de URL`s registradas rows Array com resultado, tendo a url e o code (identificador único)
|
...
| DESCRIÇÃO | Com este método podemos remover uma URL registrada para recebimento de callback de SMS enviado | |||
| ESTRUTURA DA URL | https://api.directcallsoft.com/sms/remove-callback | |||
| 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 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
|
...
| DESCRIÇÃO | Dados vindo do callback |
| VERSÃO | 1 |
| MÉTODO | POST |
| 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 |
...