/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é 24h 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. - 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.
- Entregamos como Mensagem de Voz o SMS destinado a telefones fixos (opcional).
- 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ÇÃO | Este 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 URL | https://api.directcallsoft.com/sms/send | ||
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 obrigatório Número de destino do SMS, formato exemplo: 551199990002 (DDI DDD NUMERO) Notas sobre este parâmetro:
texto obrigatório Texto a ser enviado na mensagem pode ter até 700 caracteres, mas "importante": Notas sobre este parâmetro:
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.
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. 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:
DICA:
| ||
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
|
Exemplos:
Linguagem | Descrição | Arquivo |
---|---|---|
PHP | Arquivo em PHP com exemplo de como requisitar o access_token por meio da API | RequisitarToken.php |
PHP | Arquivo em PHP com exemplo de como enviar um SMS via API | EnvioSmsUnico.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.