Você está acessando a área Zenvia Desenvolvedores » Primeiros passos

Como receber SMS no seu sistema

admin — Mon, 15 Oct 2012 21:23:08 +0000

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:

O que é um número especial?

Um número especial é um número de três a cinco dígitos que identifica um sistema remetente ou destinatário.

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)

Script para gravar o status de um SMS recebido. 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

Este script tem a seguinte lógica:

Recebe as informações do SMS via HTTP GET.
Salva os dados no banco de dados.

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 (20)	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(150)	Texto do SMS enviado.
Data/hora envio	dd/mm/aaaa hh:mm:ss	Data e hora de envio/agendamento do SMS.

The post Como receber SMS no seu sistema appeared first on Você está acessando a área Zenvia Desenvolvedores.

Como enviar SMS do seu sistema

admin — Mon, 15 Oct 2012 18:11:37 +0000

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:

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:

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:

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

Estrutura de armazenamento de dados (opcional)

Para que visualizar e manter o histórico de seus envios, 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 (20)	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(150)	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.

The post Como enviar SMS do seu sistema appeared first on Você está acessando a área Zenvia Desenvolvedores.