Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

/sms/send

...

 
 
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" .
ESTRUTURA DA URLhttps://api.directcallsoft.com/sms/send
VERSÃO2
MÉTODOPOST
PARÂMETROS

origem obrigatório Número de quem esta 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.
  • Os telefones podem ser separados por qualquer caracter não numérico, por exemplo: 5541xx99792010;554199xx2030.
  • 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 Texto a ser enviado na mensagem

A cobrança será proporcional ao número de SMS utilizado em cada envio. 

Notas sobre este parâmetro:

  • Um SMS pode ter até 140 caracteres;
  • Mensagens maiores serão divididas em "multiplos SMS", antes de serem entregues;
  •  

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

    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

    format opcional Opção de retorno da API podendo ser JSON ou XML, se não informado JSON será o padrão

    short_number opcional Opção para envio com ou sem short number podendo ser s para envio com short number e n para envio sem short number.

    id_origem opcional Opção para envio do número de origem no início do SMS podendo ser s para enviar e n para não enviar.

    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"
    }
    Informações
    titleValidade 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.