/sms/recebimento

Com este método o cliente pode consultar sob demanda os dados de "SMS respondido" e de "SMS recebido", na sua aplicação:

  • 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. 

A resposta de SMS será gratuita para quem responde a partir do seu celular, mas terá o mesmo valor de um SMS enviado para o cliente Directcall que recebe a resposta na sua aplicação.


Veja também: Callback para receber mensagens automaticamente, na sua aplicação



DESCRIÇÃO

Para consultar sob demanda os dados de "SMS respondido" e de "SMS recebido", na sua aplicação:

ESTRUTURA DA URLhttps://api.directcallsoft.com/sms/recebimento
VERSÃO1
MÉTODOPOST
PARÂMETROS

access_token obrigatório Chave de acesso ao método, para saber como obter clique aqui

data_inicio obrigatório Data de início 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"

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 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

msg Array de dados (lista dos SMS recebidos)


Exemplo de resposta em JSON
{
   "api":"sms",
   "modulo":"recebimento",
   "status":"ok",
   "codigo":"000",
   "msg":
}

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:

  • Sem rótulos