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

/sms/send

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

Diferencial da Directcall no SMS com short number:

  • Em até 24h o usuário pode receber resposta de cada SMS enviado no seu email, caso o destinatário responda. Com recursos que permitirão responder a mensagem rapidamente a partir do seu email, com link para histórico SMS Recebido x Enviado no ESTILO CHAT. 
    - Basta informar o email do usuário no parametro callbackEmail, indicado abaixo.
  • Fornece inclusive status se o SMS foi recebido "no celular do destinatário", enquanto a maior parte dos fornecedores de SMS informam apenas se o SMS foi entregue na operadora móvel.
  • Quando não consegue entregar um SMS "no celular do destinatário" estorna o SMS não entregue, após tentar por até 72h.
     
 
 
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.
  • O formato CSV deve ser igual ao exemplo abaixo, com header e um numero abaixo do outro: 
    ------------------------
    numero
    5541xx99792010
    554199xx203090
    ------------------------

  • 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é 160 caracteres para envio "sem short number" e 140 para envio "com short number";
  • Mensagens maiores serão divididas em "multiplos SMS" e chegarão com complemento simiar a 1/2, 2/2, etc.;
  • 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.
Se o parâmetro short_number não for informado as mensagens serão enviadas "COM SHORT NUMBER", por padrão.

  • SMS COM SHORT NUMBER tem "custo maior" do que SMS SEM SHORT NUMBER, mas é um serviço mais confiável uma vez que é 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.
  • SMS SEM SHORT NUMBER tem "custo menor" do que SMS COM SHORT NUMBER, mas é um serviço menos confiável uma vez que utiliza 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.

entregar_como_mensagem_de_voz_em_tel_fixo opcional Opção para entrega de mensagem de texto como voz para telefones fixos, podendo ser s para enviar (padrão) 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