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

/sms/send

Este método permite enviar SMS via API e receber respostas de SMS, inclusive via e-mail, sempre que um destinatário responder.

Diferencial do SMS Directcall com short number:

  • Fornece status de SMS entregue no celular do destinatário, não somente se o SMS foi entregue na operadora móvel do destinatário.
  • Em até 96h você recebe resposta de SMS enviado, inclusive no seu e-mail, basta informar o e-mail do usuário no parâmetro callbackEmail. 
    – Mesmo quando a resposta chega sem palavra chave, mesmo que você não tenha contratado um short number exclusivo.
  • Entregamos como Mensagem de Voz o SMS destinado a telefones fixos (opcional). 
  • Relatório no estilo Chat permite listar as mensagens enviadas e as respostas recebidas em ordem cronológica. – Isso facilitar o histórico de SMS na sua aplicação.
  • A sua aplicação pode ser atualizada por callbak sobre o status de SMS enviado e sobre SMS recebido – Isso reduz o uso de servidores e de banda larga no cliente Directcall.

Lista de países onde a Directcall entrega com alta qualidade SMS no exterior.

Sobre a capacidade de entrega de SMS em lote e unitário:

  • Capacidade de até 12 milhões de SMS por hora no envio em lote, nas seguintes condições: Tamanho máximo de cada lote: 10 mil SMS. Número máximo de requisições de SMS em lote por minuto: 20.
  • Capacidade de até 2,5 mil SMS por hora no envio unitário, nas seguintes condições: Número máximo de requisições de SMS unitário por minuto: 42.

Veja também: Callback para receber status automatico; Envio em lote; Envio personalizado; Agendamento; Recebimento de SMS, Callback para receber mensagens automatico; Histórico de SMS Recebido x Enviado no estilo Chat.

 

 
 
DESCRIÇÃOEste método permite enviar SMS para telefones móveis e Mensagem de Voz para telefones fixos (opcional).
Nota: O texto é automaticamente transformado em áudio antes de ser entregue, quando a opção Mensagem de Voz é habilitada.
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: 554199990001 (DDI DDD NUMERO)

destino obrigatório Número de destino do SMS, formato exemplo: 551199990002 (DDI DDD NUMERO)

Notas sobre este parâmetro:

  • Para enviar para mais do que um destinatário basta incluir um ; no meio de cada número, por exemplo: 554199990002;554199990003, mas esta alternativa não deve ser utilizada para enviar SMS 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.

texto obrigatório Texto a ser enviado na mensagem pode ter até 700 caracteres, mas "importante":

Notas sobre este parâmetro:

  • Cada SMS pode ter no máximo 140 caracteres, sendo contabilizado parâmetro texto mais parâmetro origem;
  • 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: Se este parâmetro não for informado ou se for informado algo diferente de n (minusculo), 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 n para não enviar (padrão) e s para 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.
 

callbackEmail opcional para envio "com short number" Indique um endereço de email nesta opção se você deseja receber resposta de SMS enviado via email, ex.: [email protected] 

NOTAS:

  • O email indicado será avisado caso o destinatário de cada SMS responda, com recursos que permitirão responder a mensagem rapidamente a partir do email recebido, além de ver histórico SMS Recebido x Enviado no estilo Chat.

  • Esta opção garante apenas a resposta de SMS enviados ha menos de 24h, sem a necessidade de palavra chave.

  • A resposta de SMS será gratuita para quem responde a partir do seu celular, mas terá o mesmo de um SMS enviado para quem recebe a resposta na sua aplicação.

DICA:

  • Para facilitar alertas online sobre SMS recebido na tela do computador, mesmo quando o usuário não estiver na sua aplicação, instale a: Directcall APP Desktop. Além de SMS esta APP facilita ligação com opção de gravação, de histórico na sua aplicação, etc., mesmo quando o usuário não estiver na sua aplicaçã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

callerid Código identificador da mensagem

 

Exemplo de resposta em JSON
{
   "api":"sms",
   "modulo":"enviar",
   "status":"ok",
   "codigo":"000",
   "msg":"001 - Mensagem enviada com sucessso - CALLER-ID: 62925845049598",
   "callerid":"62925845049598"
}

Exemplos:

Linguagem
Descrição
Arquivo
PHPArquivo em PHP com exemplo de como requisitar o access_token por meio da APIRequisitarToken.php
PHPArquivo em PHP com exemplo de como enviar um SMS via APIEnvioSmsUnico.php

 

 

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