/sms/send
Este método permite enviar SMS em lote via API e opcionalmente, receber via email resposta de SMS, sempre que um destinatário responder.
Diferencial do SMS com short number da Directcall:
- Quando não consegue entregar um SMS "no celular do destinatário" estorna o SMS não entregue, após tentar por até 72h.
- Fornece status se o SMS foi recebido "no celular do destinatário", enquanto a maior parte dos fornecedores de SMS informam apenas se o SMS foi entregue na operadora móvel.
- Em até 24h o usuário pode receber no seu email a resposta de SMS enviado, caso o destinatário responda, sem a necessidade de palavra chave. Com recursos que permitirão responder a mensagem rapidamente a partir do seu email e relatório SMS Recebido x Enviado no estilo chat.
- Basta informar o email do usuário no parametro callbackEmail, indicado abaixo.
NOTAS:
- 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 ou email.
- Comparado ao envio de SMS unitário neste método muda apenas o parâmetro "destino_csv", que precisa ser enviado.
DESCRIÇÃO | Com este método podemos enviar um lote em massa de SMS para telefones móveis ou Torpedo de Voz para telefonia fixa. | ||
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: 554130600300 (DDI DDD NUMERO) destino_csv obrigatório. Deve conter o Arquivo CSV com os números de destino. Notas sobre este parâmetro:
texto obrigatório Texto a ser enviado na mensagem 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: Informar este parâmetro se você deseja enviar SMS SEM SHORT NUMBER.
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. | ||
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
|
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.