Recebimento de SMS, como consultar sob demanda
/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 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 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:
HELPER para facilitar o envio de SMS na sua aplicação | HELPERs para facilitar Histórico 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.