texte intégral - Fondation Maison des sciences de l`homme

Guia Técnico para envio de múltiplos
SMS via Protocolo SOAP
15 de Abril de 2014
Versão 1.0
Para automatizar o processo de envio de SMS, o cliente pode se comunicar com a plataforma de SMS e realizar os seus disparos de forma automatizada.
O envio através dessa API é feito de forma multipla, o usuário poderá enviar N mensagens para N telefones. Cada mensagem deve estar associada a um telefone.
O cliente deverá informar o usuário de acesso ao sistema, à senha (criptografada), os telefones de destino e os textos de cada mensagem. A descrição técnica do Web Service pode ser encontrado no seguinte link:
http://mm.otimatel.com.br/ws/wsEnviaSmsLote.php
Conectar­se a plataforma de SMS:
A conexão devera ser efetuada via protocolo SOAP.
O link para o WSDL (Web Service Definition Language) está localizado no seguinte endereço:
http://mm.otimatel.com.br/ws/wsEnviaSmsLote.php?wsdl
O cliente deverá passar as seguintes informações:
Campo
login
senha
Descrição Usuário utilizado para acessar o sistema.
Senha de acesso ao Valor
TEXTO
Obrigatório
SIM
TEXTO
SIM
msgs
checar_blackli
st
num_dias_chec
k
sistema (criptografada com MD5).
Array contento o telefone e sua mensagem
0/1
Número de dias que o sistema deverá consultar se já houve envio para o número:
0 – não fará consulta
1 – até 1 dia atrás
2 – até 2 dias atrás
3 – até 3 dias atrás
4 – até 4 dias atrás
5 – até 5 dias atrás
ARRAY
SIM
Campo para SIM
informar se o sistema deve consultar ou não a blacklist
Este campo SIM
informa quantos dias o sistema deverá verificar se já houve disparo para este número
Exemplo de Conexão: Conexão com a biblioteca NUSOAP.
$data['login'] = “usuarioA”;
$data['senha'] = md5(‘123456’);
$data['msgs'][] = array(‘telefone’ => ‘3499990000’, ‘mensagem’=>’Ola’);
$data['msgs'][] = array(‘telefone’ => ‘3488880000’, ‘mensagem’=>’Ola 2’);
$data['checar_blacklist'] = 0;
$data['num_dias_check'] = 0;
require_once “nuSoap/nusoap.php";
$client = new soapclient ( " http://mm.otimatel.com.br/ws/wsEnviaSmsLote.php?
wsdl.", true );
$content = $client->call ( 'enviarSMSLote', array( 'entrada' => $data ) );
Retorno das informações:
As informações serão retornadas em um array de dados contendo o telefone, o
código de envio (para ser usado posteriormente na consulta do status) e o número do erro no formato:
Informações:
Elemento
num_telefone
cod_envio
num_error
Descrição Número do telefone
Código identificador do SMS para consulta de status
Número do erro
Números de erro de retorno:
Código
0
1
2
3
4
5
6
7
8
9
10
12
Mensagem
Envio realizado
Dados vazios, por favor, entre com todos os dados
Usuário ou senha inválido
Telefone inválido
Configurações de envio não setadas, entre em contato com o administrador.
Plano não existente, entre em contato com o administrador
Saldo insuficiente
Sem saldo para disparos.
Falha da tentativa de envio
Tamanho máximo de caracteres excedido.
Número na blacklist
Número já teve disparos nos últimos N dias