/sms/send

Este método permite enviar uma mensagem para múltiplos números 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 "destino_csv", que deve ser enviado 
  • Este serviço tenta entregar 3 vezes cada mensagem, com intervalo de 3 minutos entre cada tentativa.
  • Veja também: Envio de Mensagem de voz, a partir de arquivo de áudio
 
 
DESCRIÇÃOCom este método podemos enviar Mensagem de voz em massa para telefones fixos ou móveis, a partir de um "texto" ou de um "arquivo de áudio" MP3.
ESTRUTURA DA URLhttps://api.directcallsoft.com/sms/send
VERSÃO2
MÉTODOPOST
PARÂMETROS

origem obrigatório Número de quem está enviando a Mensagem de Voz, formato exemplo: 554130600300 (DDI DDD NUMERO)

destino_csv obrigatório. Deve conter o Arquivo CSV com os números de destino.

Notas sobre este parâmetro:

  • Este arquivo deve ser enviado por multipart/form-data.
  • O formato CSV deve ser igual ao exemplo, com header um número abaixo do outro: 
    ------------------------
    número
    5541xx99792010
    554199xx203090
    ------------------------
  • Quando você precisar enviar Mensagem de voz para lotes pequenos de destinatários (até 10), você pode utilizar o parâmetro destino e incluir um "ponto e virgula" no meio de cada número, por exemplo: 554199xx2010;554199xx2030 +Inf. 

texto obrigatório, se o parâmetro áudio, abaixo, não for utilizado. Texto a ser enviado na mensagem

Notas sobre este parâmetro: 

  • Por padrão serão aceitos 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 você utilize o parâmetro áudio, abaixo.

audio obrigatório, se o parâmetro texto, acima, não for utilizado. Este parâmetro deve ser enviado um arquivo no formato MP3.

Notas sobre este parâmetro: 

  • Recomendamos o uso de mensagens de áudio curtas, com menos de 60s. 
  • Mensagens maiores costumam ter baixa audiência, os destinatários desligam antes de terminar.
  • Recomendamos ainda que seja utilizado um áudio gerado por algum estúdio de gravação, isso costuma aumentar a audição completa das mensagens.

audio_id opcional Este parâmetro deve ser utilizado 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.

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. Indica a partir de que horário o envio de mensagens em lote deve ocorrer, diariamente, até que todas as mensagens sejam entregues.

enviar_ate opcional Valor inteiro da hora podendo ser de 0 a 23. Indica até que horário o envio de mensagens em lote deve ocorrer, diariamente, até que todas as mensagens sejam entregues.

Notas sobre este parâmetro: 

  • Se você utilizar as variáveis envio_de e envio_ate, os envios serão efetivados apenas dentro desta faixa de horário.
  • Hoje a solução Directcall tem capacidade para entregar 1.350 mensagens a cada 15 minutos, considerando mensagens com cerca de 15s e mensagens padrão, que não precisem ser convertidas mais do que uma vez, de Texto para Áudio (se utilizam este recurso), sendo que:
    Esta capacidade pode ser afetada, caso existam outros usuários utilizando o envio de mensagens em massa no mesmo horário.
    Esta infraestrutura pode ser duplicada ou triplicada para usuários que possam assumir um comprometimento de pelo menos 100.000 ou 300.000 mensagens, por mês.

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

 

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