DESCRIÇÃO

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

https://api.directcallsoft.com/sms/send

VERSÃO

1

MÉTODO

POST

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

PHP

Arquivo em PHP com exemplo de como enviar mensagem de voz

MensagemVoz.php