/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".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.