/sms/send
Este método permite enviar SMS em lote para telefones móveis e Mensagem de Voz para telefones fixos (opcional), personalizando o nome de cada destinatário no corpo da mensagem (opcional) e um código (também opcional).
O texto é automaticamente transformado em áudio antes de ser entregue, quando a opção Mensagem de Voz é habilitada.
DESCRIÇÃO | Este método é o mesmo utilizado no envio padrão de SMS em lote, o que muda aqui é o "tipo de parâmetro" que pode ser enviado a partir de "destino_csv". Em linhas gerais, o usuário pode incluir até 10 |
variáveis a mais no CSV que envia para este serviço e referenciar estas variáveis no corpo do email. Exemplo de mensagem personalizada: "Ola {nome}, seu pedido foi enviado e seu codigo de rastreamento e {codigo}"
|
|
| |
ESTRUTURA DA URL | |
VERSÃO | 1 |
MÉTODO | POST |
PARÂMETROS | origem obrigatório Número de quem esta enviando o SMS, formato exemplo: 554199990001 (DDI DDD NUMERO) destino_csv obrigatório. Deve conter o Arquivo CSV com os números de destino. Notas sobre este parâmetro:
IMPORTANTE:
|
|
texto obrigatório Texto a ser enviado na mensagem - Exemplo de mensagem personalizada: "Ola {nome}, seu pedido foi enviado e seu codigo de rastreamento e {codigo}" Notas sobre estes parâmetros:
|
|
|
|
|
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 |
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_origemopcional 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. callbackEmail |
Indique um endereço de |
e-mail nesta opção se você deseja receber resposta de SMS enviado via |
e-mail, ex.: meuemail@minhaempresa.com.br NOTAS:
|
|
DICAS:
|
|
RETORNO | api Origem API que |
está 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
|
|
|
|
|
|
|
|
| Informações |
|---|
...
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. |
...
Veja também:
HELPER para facilitar o envio de SMS na sua aplicação
Acelere a implantação com este miniaplicativo baseado em HTML e Javascript, com interfaces prontas para os usuários da sua aplicação utilizarem esta API.