/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, chat via SMS, etc.
- Mostra "SMS respondido" ha menos de 24 horas, sem que o remetente precise incluir uma palavra chave na resposta.
- Mostra "SMS recebido" sem o envio preliminar de um SMS para o remetente, mas somente quando o remetente tiver incluido uma palavra chave contratada na Directcall no inicio da resposta, ex.: BBB, desejo participar.
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: Callback para receber mensagens automatico; Histórico de SMS Recebido x Enviado no estilo Chat
| DESCRIÇÃO | Com este método podemos listar pontualmente SMS respondido em até 24h e SMS recebidos com palavra chave no inicio, que tenha sido contratada na Directcall. | ||
| 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.