Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 14 Próxima »

/sms/send

Método que faz o envio de um torpedo de voz pela API. Ente método é igual ao de envio padrão o que diferencia é o parâmetro "tipo" que deve ser enviada com o valor "voz"

 
 
DESCRIÇÃOCom este método podemos realizar o envio de um Torpedo de Voz para telefonia fixa ou móvel.
ESTRUTURA DA URLhttps://api.directcallsoft.com/sms/send
VERSÃO1
MÉTODOPOST
PARÂMETROS

origem obrigatório Número de quem esta enviando o SMS, formato exemplo: 554130600300 (DDI DDD NUMERO)

destino obrigatório Número de telefone onde deve ser entregue a sua Mensagem de Voz. Formato exemplo: 554130600300 (DDI DDD NUMERO)

Notas sobre este parâmetro:  

  • Para enviar para mais do que um destinatário basta incluir um "ponto e vírgula" no meio de cada número, por exemplo: 554130160300;551140621280, mas esta alternativa não deve ser utilizada para enviar Mensagens de Voz para mais do que 10 destinatários.
  • Quando você precisar enviar para mais do que 10 destinatários prefira informar os números via arquivo csv +Inf.

texto obrigatório Texto a ser enviado na mensagem

Notas sobre este parâmetro: 

  • Por padrão será aceito até 700 caracteres em cada mensagem, no entanto, indicamos que sejam enviados "textos curtos" para serem convertidos para voz.
  • Em caso de "mensagem longa", indicamos que seja enviado um arquivo de áudio, gerado por algum estúdio de gravação +Inf.

tipo opcional Opção para enviar como texto ou voz podendo ser ("voz" para torpedo de voz | "texto" para sms), por padrão é texto.

cron opcional Em caso de envio agendado esta variável deve ser enviada no formato <dia-mes-ano-hora-minuto-segundo> "d-m-Y-H-i-s"

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

audio opcional Esta parâmetro deve ser enviado um arquivo no formato MP3, caso seja enviado não precisa ser informado a variável texto

envio_de opcional Valor inteiro da hora podendo ser de 0 a 23

envio_ate opcional Valor inteiro da hora podendo ser de 0 a 23

Notas sobre este parâmetro: 

  • Se você enviar as variáveis envio_de e envio_ate os envios só serão efetivados dentro desta faixa de horário.

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

msg Texto de resposta da API

callerid Código de retorno da mensagem

 

Exemplo de resposta em JSON
{
   "api":"sms",
   "modulo":"enviar",
   "status":"ok",
   "codigo":"000",
   "msg":"001 - Mensagem enviada com sucessso - CALLER-ID: 62925845049598",
   "callerid":"62925845049598"
}

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.

 

  • Sem rótulos