/sms/send
DESCRIÇÃO | Este método permite enviar SMS em lote para telefones móveis e Mensagem de Voz para telefones fixos (opcional).
Para o envio no formato JSON deve ser enviado o "Header Content-Type: application/json" |
ESTRUTURA DA URL | https://api.directcallsoft.com/sms/lot-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) destinatarios obrigatório. Deve conter um array de destinatário com os seguintes campos. id_destinatario obrigatório Identificador único para o destinatário destino obrigatório Número de destino do SMS, formato exemplo: 551199990002 (DDI DDD NUMERO) texto obrigatório Texto a ser enviado na mensagem
IMPORTANTE:
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 email nesta opção se você deseja receber resposta de SMS enviado via email, ex.: [email protected] NOTAS:
DICAS:
Exemplo de requisição em JSON { "origem": "558", "tipo": "texto", "access_token": "670769a9d4061b103a80080614216302c77e98b", "format": "json", "short_number": "s", "entregar_como_mensagem_de_voz_em_tel_fixo": "n", "id_origem": "n", "callbackEmail": "[email protected]", "destinatarios": [ { "id_destinatario": "1", "destino": "551199990001", "texto": "Envio em lote" }, { "id_destinatario": "2", "destino": "551199990002", "texto": "Envio em lote" } ] }
|
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 destino Array com os destinos enviados id_destinatario Identificador único para o destinatário id_mensagem Identificador único para a mensagem entregue_como Se a mensagem foi entregue como texto ou voz Exemplo de resposta em JSON { "api": "sms", "modulo": "enviar", "status": "ok", "codigo": "000", "msg": "001 - Mensagem enviada com sucessso - CALLER-ID: 62925845049598", "callerid": "62925845049598", "destino": [ { "id_destinatario": "1", "id_mensagem": 70006274618573, "entregue_como": "texto" }, { "id_destinatario": "2", "id_mensagem": 70006274635131, "entregue_como": "texto" } ] } |
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:
- TESTE GRÁTIS as APIs e APPs da Directcall
- 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.