/sms/send
Comparado ao envio de SMS unitário neste método muda apenas o parâmetro "destino_csv", que precisa ser enviado.
| |
---|
DESCRIÇÃO | Este método permite enviar SMS para telefones móveis e Mensagem de Voz para telefones 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 está 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: - Este arquivo deve ser enviado por multipart/form-data.
- O formato CSV deve ser igual ao exemplo abaixo, com header e um número abaixo do outro:
------------------------ numero 554199990002 554199990003 ------------------------
IMPORTANTE: - Caso utilize o Microsoft Office Excel para edição dos seus arquivos CSV, sempre salve seu arquivo formatando as células dos números de telefone para formato "número" com 0 casas decimais.
- Este serviço aceita lotes com "no máximo" 10.000 destinatários. Se você precisa enviar para mais destinatários, deve dividir o envio em lotes com "no máximo" 10.000 destinatários.
- Quando você precisar enviar SMS para lotes pequenos de destinatários (até 10), você pode utilizar o parâmetro destino e incluir um "ponto e virgula" no meio de cada número, por exemplo: 554199xx2010;554199xx2030 +Inf.
texto obrigatório Texto a ser enviado na mensagem Notas sobre este parâmetro: - Um SMS pode ter até 160 caracteres para envio.
- Mensagens maiores serão divididas em "múltiplos SMS" e chegarão com complemento 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 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 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 Indique um endereço de e-mail nesta opção se você deseja receber resposta de SMS enviado via e-mail, ex.: [email protected] NOTAS: 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 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.
DICAS: - Cada SMS recebido poderá ser consultado também a partir da API de SMS que permite Consultar dados de SMS recebido e da API de SMS que permite Consultar dados de SMS Recebido x Enviado no ESTILO CHAT.
- 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
Exemplo de resposta em JSON |
---|
{ "api":"sms", "modulo":"enviar", "status":"ok", "codigo":"000", "msg":"001 - Mensagem enviada com sucessso - CALLER-ID: 62925845049598", "callerid":"62925845049598" } |
|