Como enviar SMS do seu sistema

 

Entendendo um envio de SMS

Por meio dos serviços da Zenvia, seu sistema pode enviar SMS a um celular. Esse envio é composto pelos seguintes elementos:

entenda-um-envio-de-sms

 

 

  • O quê: o conteúdo da mensagem curta de texto a ser enviada;
  • Para quem: celular do destinatário;
  • Quando: data e hora de agendamento (pode ser imediato).

 

 

 

 

 

 

Veja o caminho que o SMS segue:

caminho-do-sms

 

O que você precisa desenvolver em seu sistema?

 

Módulo de envio (necessário)

Módulo que efetua a integração com os métodos da API por meio de HTTP(S) GET, HTTP(S) POST ou WebServices (XML/SOAP). Exemplos de operações que o módulo efetua:

  • Envio de SMS único;
  • Envio de múltiplos SMS;
  • Cancelamento de SMS agendado.

Para uma referência completa das operações, veja a documentação.

 

Módulo para recebimento de status (opcional)

Script para gravar o status de um SMS. A plataforma Zenvia envia o status dos SMS por uma chamada HTTP a uma URL do sistema do cliente.

Exemplo de URL: http://www.suaempresa.com.br/sistemasms/receber_status_sms_enviado.php

Este script tem a seguinte lógica:

  1. Recebe parâmetros de status via HTTP GET;
  2. Identifica em sua base de dados o SMS correspondente (pelo ID ou celular);
  3. Salva seu status final de entrega.

 

Estrutura de armazenamento de dados (opcional)

Para visualizar e manter o histórico de seus envios, sugerimos a criação de uma estrutura para persistência das informações em Banco de Dados ou em um arquivo simples, contendo os seguintes dados:

Campo Formato Descrição
ID String (50) Identificador único para cada SMS enviado.
Celular Código de país + Código de área + Número Destinatário do SMS. Exemplo: 555199887766.
Conteúdo String(160) Texto do SMS enviado.
Data/hora envio dd/mm/aaaa hh:mm:ss Data e hora de envio/agendamento do SMS.
Status de entrega Integer Ver documentação de integração para detalhes.
Retorno da integração String (200) Retorno da chamada à Zenvia. Serve como log para diagnóstico e resolução de problemas.