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

/sms/send

Método que faz o envio o de SMS em lote pela API. Este método é o mesmo de envio padrão o que muda aqui é o parâmetro "destino_csv" que deve ser enviado 

 
 
DESCRIÇÃOCom este método podemos enviar um lote em massa de SMS para telefones móveis ou Torpedo de Voz para telefonia fixa.
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_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 SMS 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

Notas sobre este parâmetro:

  • Um SMS pode ter até 140 caracteres;
  • Mensagens maiores serão divididas em "multiplos SMS", antes de serem entregues;
  • A cobrança será proporcional ao número de SMS utilizado em cada envio. 

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 para envio "com short number" Configure n para enviar o SMS sem short number ou s para enviar o SMS com short number.

IMPORTANTE informar este parâmetro, se você deseja enviar SMS SEM SHORT NUMBER.
Caso o parâmetro short_number não seja informado, as mensagens serão enviadas "COM SHORT NUMBER", por padrão.

  • O SMS COM SHORT NUMBER tem "custo maior" do que o SMS SEM SHORT NUMBER, mas é um serviço mais confiável, direto com as operadoras móveis, sem envolver chips de celulares.
    Além disso o destinatário verá sempre o mesmo número de remetente ( short number ), o que pode estabelecer uma identidade para o seu negócio.
  • O SMS SEM SHORT NUMBER tem "custo memnor" do que o SMS COM SHORT NUMBER, mas é um serviço menos confiável uma vez que envolve chips de celulares.
    Além disso o destinatá
    rio verá sempre um número de remetente "aleatório".

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

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