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

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

audio_id opcional Este parâmetro deve ser enviado quando você quiser enviar um audio já cadastrado, para cadastrar o audio veja aqui.

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

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