/sms/recebimento
Este método permite o recebimento de dados de "SMS respondido" ou de "SMS recebido", útil para atendimento a clientes, pesquisas, confirmação de visitas, etc.
- Mostra "SMS respondido" ha menos de 24 horas, sem a exigencia de que o remetente precise incluir uma palavra chave na resposta.
- Já um "SMS recebido" sem o envio preliminar de um SMS para o remetente será visto a partir desta API somente se o remetente tiver incluido uma palavra chave contratada na Directal na resposta, ex.: BBB.
Mais diferencial do SMS com short number da Directcall:
Em até 24h o usuário pode receber resposta de cada SMS enviado inclusive no seu email, caso o destinatário responda. Com recursos que permitirão responder a mensagem rapidamente a partir do seu email, com link para histórico SMS Recebido x Enviado no ESTILO CHAT.
- Basta informar o email do usuário no parametro callbackEmail, nas APIs que permitem o Envio de SMS.
NOTAS:
- O recebimento de SMS é uma opção do sms "com short number".
- A resposta de SMS será gratuita para quem responde a partir do seu celular, mas terá o mesmo de um SMS enviado para quem recebe a resposta na sua aplicação.
- Veja também Recebimento de SMS, callback para receber automático dados de SMS recebido, que facilita para o seu sistema o recebimento automático de dados de cada SMS respondido ou recebido, cada vez que chegar uma nova mensagem.
| DESCRIÇÃO | Com este método podemos listar os SMS recebidos por nossa plataforma. | ||
| ESTRUTURA DA URL | https://api.directcallsoft.com/sms/recebimento | ||
| VERSÃO | 1 | ||
| MÉTODO | POST | ||
| PARÂMETROS | access_token obrigatório Chave de acesso ao método, para saber como obter clique aqui data_inicio obrigatório Data de inicio da pesquisa, formato <ano-mes-dia hora:minuto:segundo> "Y-m-d H:i:s" data_fim obrigatório Data de fim da pesquisa, formato <ano-mes-dia hora:minuto:segundo> "Y-m-d H:i:s" short_number opcional Indica qual a lista de recebimento buscar, com ou sem short number (padrão sem short number). Valores s, para buscar com short number e n para buscar sem short number format opcional Opção de retorno da API podendo ser JSON ou XML, se não informado JSON será o padrão pagina opcional Opção para paginação da lista de SMSs recebidos. Valor numérico inteiro itens_por_pagina opcional Opção para limitar a quantidade de registros de uma página. Valor numérico inteiro | ||
| 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 msg Array de dados (lista dos SMSs recebidos)
|
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.