Versões comparadas

Versão antiga 40

changes.mady.by.user Usuário desconhecido (djalmo)

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Bruno

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

/sms/send



DESCRIÇÃO

Este método permite

...

Diferencial do SMS com short number da Directcall:

  • Em até 24h o usuário pode receber resposta de cada SMS enviado via email, caso o destinatário responda.
    Com recursos que permitirão responder a mensagem rapidamente a partir do seu email, com link para histórico SMS Recebido x Enviado no ESTILO CHAT. 
    - Basta informar o email do usuário no parametro callbackEmail, indicado abaixo.
  • 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.
     

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
 
 
DESCRIÇÃOCom este método podemos enviar um SMS para telefones móveis, com a opção de a mensagem ser entregue como Mensagem de voz, caso o número indicado seja de um telefone fixo
  • .
ESTRUTURA DA URLhttps://api.directcallsoft.com/sms/send
VERSÃO1
MÉTODOPOST
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:
554199xx2010
  • 554199990002;
554199xx2030
  • 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
  • Cada SMS pode ter
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

sms

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.
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
    s
    n para não enviar (padrão) e
    n
    s 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

    e-mail nesta opção se você deseja receber resposta de SMS

    enviado via email

    em um e-mail, ex.: [email protected] 

    NOTAS:

    • O

    email

    • 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

    email

    • e-mail recebido, além de ver histórico SMS Recebido x Enviado no

    ESTILO CHAT

    • 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.

    DICA:

    • 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

    callerid Código identificador da mensagem

     

    id_mensagem: Identificador único para a mensagem

    destino: Destino da mensagem


    Exemplo de resposta em JSON
    {

       
    
    "api": "sms",

       
    
    "modulo": "enviar",

       
    
    "status": "ok",

       
    
    "codigo": "000",

       
    
    "msg": "
    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:

    Linguagem
    Descrição
    Arquivo
    PHPArquivo em PHP com exemplo de como requisitar o access_token por meio da APIRequisitarToken.php
    PHPArquivo em PHP com exemplo de como enviar um SMS via APIEnvioSmsUnico.php

    ...

     



    Informações
    titleValidade 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:

     

    ...