Como receber SMS no seu sistema

 

Entendendo o recebimento de um SMS

Por meio dos serviços da Zenvia, seu sistema pode receber um SMS de um usuário de celular. Por exemplo:

  • O usuário responde a um SMS recebido: por exemplo, uma resposta a uma enquete.
  • O usuário inicia uma comunicação pelo SMS: por exemplo, o usuário faz uma pergunta para um SAC. Nesse caso, é necessária a contratação de um número especial.

 

Veja o caminho de um SMS recebido:

caminho-sms-recebido

O que é um número especial?

Um número especial – também conhecido como short code – é um número de três a oito dígitos que identifica um sistema remetente ou destinatário na rede da operadora.

 

Há dois tipos de número especial:

  • Compartilhado: sua empresa compartilha com outras um número especial, utilizando palavras-chave para se identificar (exemplo: o usuário envia “LUZ” para o número 2210 e essa mensagem é repassada à conta associada a essa palavra-chave).
  • Exclusivo: número especial exclusivo de sua empresa. Todas as mensagens enviadas para esse número serão direcionadas para a sua conta, sem precisar de palavra-chave.

 

O que você precisa desenvolver em seu sistema?

 

Módulo para recebimento do SMS (necessário)

A plataforma Zenvia envia os dados do SMS por uma chamada HTTP a uma URL do sistema do cliente.

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

 

Estrutura de armazenamento de dados (opcional)

Para que visualizar e manter o histórico dos SMS recebidos, sugerimos a criação de uma estrutura para persistência em Banco de Dados ou 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.