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 30 Próxima »

/sms/send

Este método permite enviar um arquivo de audio para um número de telefone, a partir da API de um "texto" ou de um "arquivo de áudio".

NOTAS:

  • Este método é similar ao utilizado para o envio de SMS em lote, o que muda é o parâmetro "tipo", que deve ser enviada com o valor "voz".

  • Este serviço irá tentar entregar por 3 vezes cada mensagem.
  • Veja também:
    Outra alternativa é enviar a partir de um arquivos de áudio MP3 +Inf. 
    Envio de mensaem de voz em lote +Inf. 
     
 
 
DESCRIÇÃOCom este método podemos realizar o envio de uma Mensagem de Voz para um telefone fixo ou móvel, a partir da API de um "texto" ou de um "arquivo de áudio".
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:  

  • 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.
  • Este serviço irá tentar entregar 3 vezes cada mensagem.

texto obrigatório Texto a ser enviado na mensagem

Notas: 

  • 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 de até 4mb, 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 Indique "voz" para entregar a mensagem como Torpedo de voz | Indique "texto" para entregar como SMS.
NOTA: Se não for informado entrega como SMS quando o telefone for móvel e como Mensagem de voz quando o telefone for fixo.

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

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

enviar_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"
}

 

Exemplos:

Linguagem
Descrição
Arquivo
PHPArquivo em PHP com exemplo de como enviar mensagem de vozMensagemVoz.php

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