/sms/send
Método que faz o envio o de SMS pela API.
| |
Com este podemos um SMS para telefones móveis |
ou Torpedo telefonia fixatelefones fixos (opcional). - O texto é automaticamente transformado em áudio antes de ser entregue, quando a opção de Mensagem de Voz é habilitada.
|
ESTRUTURA DA URL | https://api.directcallsoft.com/sms/send |
VERSÃO | 1 |
MÉTODO | POST |
PARÂMETROS | origem obrigatório Número de quem |
esta está enviando o SMS, formato exemplo: |
554199xx2010 554199990001 (DDI DDD NUMERO) destino obrigatório Número de destino do SMS, formato exemplo: |
554199xx2010 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:
|
554199xx2010554199xx2030- 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.
- Para números internacionais acrescente 00 na frente do numero. Ex.: 0011234567890
texto obrigatório Texto a ser enviado na mensagem pode ter até 700 caracteres, mas "importante": Notas sobre este parâmetro: |
Um até 160 caracteres para envio "sem short number" e 140 para envio "com short number"- no máximo 140 caracteres, sendo contabilizado parâmetro texto mais parâmetro origem;
- Mensagens maiores serão divididas em "
|
multiplos - múltiplos SMS" e chegarão com complemento
|
simiar - similar 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 |
smsSMS), 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
|
sn para não enviar (padrão) e |
n 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. |
opcional para envio "com short number" Caso você queira receber a resposta deste envio com SHORT NUMER no seu e-mail, envie o Indique um endereço de e-mail |
, quando o destinatário do SMS responder a resposta vai direto ao nesta opção se você deseja receber resposta de SMS em um e-mail |
informado FormatoIMPORTANTE LERSe esta opção for habilitada o usuário será avisado por email sobre cada SMS recebido, com copia da mensagem que originou a mensagem recebida e com recursos que permitirão que responder a mensagem facilmente, a aprtir do email.O e-mail indicado será avisado caso o destinatário de cada SMS responda, com recursos que permitirão responder a mensagem rapidamente a partir do e-mail recebido, além de ver histórico SMS Recebido x Enviado no estilo Chat. Esta opção garante apenas a resposta de
|
Esta versão trata apenas as mensagens recebidas em resposta a O email remetente de cada aviso será: [email protected], sendo que esta conta de email "não recebe mensagens".
Para evitar que tais avisos sejam considerados Spam libere este remetente ou domínio no email dos usuários. Esta opção não impede que você continue consultando mensagens recebidas no Histórico de SMS recebido, através da API de extrato.- 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: |
DICA: - Para facilitar alertas online sobre SMS recebido na tela do computador
|
do seu usuário- 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
|
nela |
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 |
id_mensagem: Identificador único para a mensagem destino: Destino da mensagem
Exemplo de resposta em JSON |
---|
{
|
|
001 - Mensagem enviada com sucessso - CALLER-ID: 62925845049598", "callerid":"62925845049598"}001 - Mensagem enviada com sucessso - CALLER-ID: 55694775188625",
"destino": [
"5541987654321",
"5541912345678"
],
"callerid": "55694775188625",
"detalhe": [
{
"id_mensagem": 55694762999823,
"destino": "5541987654321"
},
{
"id_mensagem": 55694775188733,
"destino": "5541912345678"
}
]
}
|
|
Exemplos:
...
Informações |
---|
title | 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.