/sms/send

Este método permite enviar um arquivo de áudio 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 enviado 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 arquivo de áudio MP3 com tamanho máximo de 4MB +Inf. 
    Envio de mensagem 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 está enviando o SMS, formato exemplo: 554130600300 (DDI DDD NUMERO)

destino obrigatório Número de telefone para o qual 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. 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 áudio já cadastrado, veja aqui como cadastrar o áudio.

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

num_tentativas  opcional Informa o número de tentativas de envio de torpedo por voz (caso tenha usado o parâmetro "tipo" = "voz"). Se o parâmetro não for informado ou não for um valor "numérico", usará o padrão de 3 tentativas.

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