Mudanças entre as edições de "Controllr/Aplicativos/Cadastros/Messenger"
Linha 144: | Linha 144: | ||
+ | ==[https://www.zenvia.com/produtos/sms Zenvia]== | ||
+ | Poderá contratar o Zenvia. Para contratar esse gateway deve acessar o site do [https://www.zenvia.com/produtos/sms Zenvia] e adquirir o seu pacote de SMS. | ||
+ | <div class="img-responsive align-center"> | ||
+ | <gallery mode="slideshow"> | ||
+ | arquivo:controllr-aplicativos-cadastros-marketing-sms-configuracao-zenvia.png| Configuração do serviço [https://www.zenvia.com/produtos/sms Zenvia] | ||
+ | arquivo:controllr-aplicativos-cadastros-marketing-sms-configuracao-zenvia-login.png| Login da sua conta no Zenvia através do link '''https://connect.zenvia360.com/manager/''' | ||
+ | arquivo:controllr_marketing_sms_confg_zenvia_identificador.png| Local onde capturar o seu '''Aggregate ID''' | ||
+ | </gallery> | ||
+ | </div> | ||
− | + | {| class="table table-bordered table-striped" style="margin:auto;" | |
− | + | ! style="text-align:center" colspan="3"| [https://www.zenvia.com/produtos/sms Zenvia] | |
− | + | |- | |
− | + | ! style="text-align:center; width:16%;"| Campo | |
+ | ! style="text-align:center;"| Descrição | ||
+ | ! style="text-align:center;"| Exemplo | ||
+ | |- | ||
+ | ! style="text-align:left; vertical-align:middle;"| Serviço | ||
+ | | style="text-align:left; vertical-align:middle;"| Selecione o serviço do Gateway que irá contratar. | ||
+ | | style="text-align:left; vertical-align:middle;"| [https://www.zenvia.com/produtos/sms Zenvia] | ||
+ | |- | ||
+ | ! style="text-align:left; vertical-align:middle;"| Usuário | ||
+ | | style="text-align:left; vertical-align:middle;"| O seu usuário será disponibilizado no seu E-mail após contratar o serviço do Zenvia | ||
+ | | style="text-align:left; vertical-align:middle;"| brbyte.corp.api | ||
+ | |- | ||
+ | ! style="text-align:left; vertical-align:middle;"| Senha | ||
+ | | style="text-align:left; vertical-align:middle;"| A senha será disponibilizada no seu E-mail após contratar o serviço do Zenvia.<br>'''OBS:''' Deverá utilizar a senha '''API''' | ||
+ | | style="text-align:left; vertical-align:middle;"| ********* | ||
+ | |- | ||
+ | ! style="text-align:left; vertical-align:middle;"| Aggregate ID | ||
+ | | style="text-align:left; vertical-align:middle;"| Ao logar na sua conta do [https://connect.zenvia360.com/manager/ Zenvia], irá descobrir o seu identificador, acesse:<br>Administração > Gerenciar Agrupador > Identificador | ||
+ | | style="text-align:left; vertical-align:middle;"| 33333 | ||
+ | |} | ||
Edição das 19h07min de 28 de abril de 2020
Índice
Marketing SMS
No APP Marketing SMS
É possível realizar o envio de SMS para grupos específicos de Clientes utilizando-se dos filtros disponíveis na seleção dos Clientes, podendo então criar campanhas para Cliente em atraso, clientes em dia, etc...

Primeiro deverá configurar o Gateway de envio de SMS. Basta clicar em Configuração.
Configuração

O Serviço estará com o status desabilitado, então irá contratar um dos gateways que está integrado com o Controllr.
Voipr
Voipr | ||
---|---|---|
Campo | Descrição | Exemplo |
Serviço | Selecione o serviço do Gateway que irá contratar. | Voipr |
Campaign Key | Insira a chave da Campanha criada no seu servidor Voipr. OBS: Use o tipo texto na criação ca campanha, pois o template de envio usado será o do Controllr |
4BxUFnE37jpnEmQmjJsUOm1EhWP51oCh |
Client Key | Insira a chave do Cliente criado no seu servidor Voipr | KdL3LhLdsH7aIig6WF8F6YZQvlz7Sphz |
Host | Insira o IP do seu servidor Voipr | 192.168.142.14 |
Porta | Insira a parta de acesso WEB do seu servidor Voipr. Padrão é a porta 8080 | 8080 |
SmsGateway.me
O SmsGateway.me é um APP que transforma o seu celular Android em um servidor de SMS Gratuito, usando o chip do seu celular. O App não se encontra mais na PlayStore, então deve procurar por APK na internet ou fazer o download do Sms Gateway ME no seu celular. Ao instalar você deve configurar no seu Android, permitir a instalação de APP menos seguros.
Khal
Poderá utilizar o Khal. Para contratar deve entrar em contato via E-mail ou telefone. Essas informações estão presentes no site do Khal.
OBS: Esse login do Khal é no IP http://172.246.132.10/app/login/
Khal | ||
---|---|---|
Campo | Descrição | Exemplo |
Serviço | Selecione o serviço do Gateway que irá contratar. | Khal |
Usuário | O seu usuário será disponibilizado no seu e-mail após contratar o serviço do Khal | 6799999 |
Senha | A sua senha será disponibilizada no seu e-mail após contratar o serviço do Khal | ******* |
Khal PlaySMS
Poderá utilizar o Khal. Para contratar deve entrar em contato via E-mail ou telefone. Essas informações estão presentes no site do Khal.
OBS: Esse login do Khal PlaySMS é no IP http://172.246.132.11/login/
Khal | ||
---|---|---|
Campo | Descrição | Exemplo |
Serviço | Selecione o serviço do Gateway que irá contratar. | Khal PlaySMS |
Login/ID | O seu Login/ID será disponibilizado no seu e-mail após contratar o serviço do Khal PlaySMS | 6799999 |
Senha | Senha é tipo de SMS que irá enviar para o seus clientes. • Longcode • Shortcode 1 Way • Shortcode 2 Way • Voz • WhatsApp Texto • Promotional SMS |
Longcode |
Flush | A mensagem chega no celular do cliente como um Popup, então o cliente irá ver o SMS |
Zenvia
Poderá contratar o Zenvia. Para contratar esse gateway deve acessar o site do Zenvia e adquirir o seu pacote de SMS.
Zenvia | ||
---|---|---|
Campo | Descrição | Exemplo |
Serviço | Selecione o serviço do Gateway que irá contratar. | Zenvia |
Usuário | O seu usuário será disponibilizado no seu E-mail após contratar o serviço do Zenvia | brbyte.corp.api |
Senha | A senha será disponibilizada no seu E-mail após contratar o serviço do Zenvia. OBS: Deverá utilizar a senha API |
********* |
Aggregate ID | Ao logar na sua conta do Zenvia, irá descobrir o seu identificador, acesse: Administração > Gerenciar Agrupador > Identificador |
33333 |
Envio Automático
- Cliente - Aniversário: Envia uma mensagem de 'Aniversário do Cliente' (campanha #1) na data informada em 'Nascimento' no cadastro do cliente.
- Cobrança - Envio Automático: Ao criar uma cobrança envia as informações via SMS do cliente, campanha #2.
- Cobrança - Antecedência: Informa o cliente que em X dias (0 = desativado) sua cobrança irá vencer, campanha #3.
- Cobrança - Data vencimento: Envia uma mensagem no dia do vencimento da cobrança, campanha #4.
- Cobrança - Pagamento: Envia a confirmação de pagamento quando a cobrança é paga, campanha #5.
- Bloqueio - Aviso: Informa o cliente que existe pendencia em seu nome, apenas uma mensagem de aviso, campanha #10.
- Bloqueio - Redução de Velocidade: Informa o cliente que encontra-se com velocidade reduzida devido a pendência, campanha #11.
- Bloqueio - Total: Ao atingir o prazo para bloqueio total do acesso envia-se a mensagem da campanha #12.
- Bloqueio - Cancelamento: Ao atingir o prazo para cancelamento do contrato do cliente envia-se o e-mail informando tal situação, campanha #13.
- Intervalo de envio: Informe de quantos em quantos segundos, seja enviado o seu SMS.
- Quantidade de envios: Quantidade de SMS, que devem ser enviados no intervalo de envio.
EX: Intervalo de envio: 5 seg Quantidade de envios: 5 SMS
Será enviado 5 SMS a cada 5 seg. Uma média de 1 SMS / por 1 seg.

OBS: Tente manter os valores dos campos iguais ou que o intervalo de envio seja maior que a quantidade de envios. Para que não congestione uma grande quantidade de envios no seu Gateway SMS.
Khal Play SMS
Para conectar com o Khal PlaySMS preencha as informações de ID e o tipo da senha fornecidos pela da Khal.

Caso queira uma mensagem do tipo Flash marque a opção Flash no menu.
Zenvia
- Serviço: Zenvia
- Usuário: Nome da sua Conta
- Senha: Senha de acesso (API)
- Aggregate ID: Identificador da sua conta WEB


1º Acesse o site do Zenvia e faça seu cadastro.
2º Você receberá um e-mail do comercial do Zenvia, para contratar o plano que melhor se enquadra para seus envios. O Zenvia trabalha na forma de pós-pago.
3º Depois de contratar o plano receberá um e-mail com o link e os dados de acesso a sua conta. Ao logar pode visualizar os SMS enviados em Monitor de Envios > Outros Envios.
O e-mail recebido será semelhante a este, contendo a senha para acesso Web do Zenvia e outra senha para a utilização da API do Zenvia, está sera a senha utilizada no Controllr a Senha API

ATENÇÃO: A senha utilizada no Controllr é a Senha API.
Outros
Caso queira cadastrar outros serviços que não estão na lista a opção "Outros" permite criar uma requisição HTTP genérica para os serviços que aceitem requisições via API, sendo preenchida de forma manual.

Variáveis da API
Como pode ver nos exemplos os parâmetros da URL da API devem ser dissubstituídos pelas variáveis do Controllr, com isso ao enviar a mensagem o Controllr sabe onde adicionar a mensagem, número do destino, usuário e etc.
Na URL deve-se substituir "user" "password" "destinatário" "mensagem" pelas variáveis disponíveis:
{u}: Usuário
{p}: Senha
{d}: Número do destinatário
{m}: Conteúdo da mensagem
Facilita Movel
http://www.facilitamovel.com.br
host: www.facilitamovel.com.br
porta: 443
API/URL: /api/simpleSend.ft?user={u}&password={p}&destinatario={d}&msg={m}
SSL: Sim

King Telecom
Site: https://www.kingsms.com.br/ Painel: http://painel.kingsms.com.br/cliente
Host: sms.kingtelecom.com.br
Porta: 443
URL: /kingsms/api.php?acao=sendsms&login={u}&token=SEU_TOKEM&numero={d}&msg={m}
SSL: SIM

O token é obtido no painel do cliente http://painel.kingsms.com.br/cliente menu Home -> Informações da Conta -> Token

Allcance SMS
Site: Painel: http://www.allcancesms.com.br
Painel: http://corporativo.allcancesms.com.br
Realizamos os testes preenchendo as configurações conforme:
Host: corporativo.allcancesms.com.br
Porta: 80
API/URL: /app/modulo/api/index.php?action=sendsms&lgn={u}&pwd={p}&numbers={d}&msg={m}
SSL: Não

HotMobile
Site: https://www.hotmobile.com.br
Painel: https://painel.hotmobile.com.br
Realizamos os testes preenchendo as configurações conforme:
Host: painel.hotmobile.com.br
Porta: 80
API/URL: /SendAPI/Send.aspx?usr={u}&pwd={p}&number={d}&msg={m}
SSL: Não

Template
Depois de configurar o Gateway de sua preferência. Agora deve-se Configurar o Template (modelo padrão de SMS), pode ser criados vários, como de aniversário, cobrança, lembrete, etc...

Para criar um template, clique em Novo.
- Nome: Nome do modelo do seu template
- Habilitado: Marque para ativar esse modelo.
- Variáveis: São utilizadas para, trazer as informações do seu cliente, do financeiro e do seu provedor.
Pronto, agora é só escrever o modelo do seu template.

Variáveis
Variável | Descrição | Exemplo |
---|---|---|
{CLI_NAME} | Primeiro nome do cliente | Marcos |
{CLI_NAME_L} | Sobrenome do cliente | Valas |
{CLI_NAME_FULL} | Nome completo do cliente | Marcos Valas |
{CLI_USER} | Usuário do cliente (hotsite) | marcosv |
{CLI_PASS} | Senha do usuário de acesso a área ao cliente (Hotsite) | 123456 |
{ISP_NAME_C} | Nome completo do provedor | BrByte Soluções para provedores e internet |
{ISP_NAME} | Nome simplificado do provedor | BrByte |
{ISP_ADDR_B} | Nome do bairro do provedor | Bairro Carandá |
{ISP_ADDR} | Endereço do provedor | Rua Vitório Zeola |
{ISP_NUM} | Número do provedor | 233 |
{ISP_CITY} | Cidade do provedor | Campo Grande |
{ISP_STATE} | Estado do provedor | Mato Groso do Sul |
{ISP_CEP} | CEP do provedor | 79000-000 |
{ISP_CNPJ} | CNPJ do provedor | 04.746.638/0001-27 |
{ISP_PHONE} | Telefone do provedor | (67) 2222-3333 |
{ISP_EMAIL} | E-mail do provedor | contato@brbyte.com |
{ISP_URL} | Site do provedor | www.brbyte.com |
{COB_CODE} | Código da cobrança | 768412 |
{COB_NUM_DOC} | Número do documento da cobrança | 2846876416 |
{COB_VAL_DOC} | Valor da cobrança | R$146,37 |
{COB_VAL_PAG} | Valor pago da cobrança | R$100,00 |
{COB_VAL_DISC} | Valor com desconto da cobrança | R$126,37 |
{COB_DATE_VENC_Y} | Ano de vencimento da cobrança | 2018 |
{COB_DATE_VENC_M} | Mês de vencimento da cobrança | Maio |
{COB_DATE_VENC_D} | Dia de vencimento da cobrança | 23 |
{COB_DATE_VENC} | Data completa de vencimento da cobrança | 23/05/2018 |
{COB_DATE_PAG_Y} | Ano de pagamento da cobrança | 2018 |
{COB_DATE_PAG_M} | Mês de pagamento da cobrança | Maio |
{COB_DATE_PAG_D} | Dia de pagamentoda cobrança | 22 |
{COB_DATE_PAG} | Data completa do pagamento da cobrança | 22/05/2018 |
Caso tenha dúvidas de outras variáveis, acesse a wiki específica de variáveis
Enviar SMS
Depois de ter configurado o gateway e o template, basta enviar enviar o SMS clicando em Novo
- Nome: O nome para esse envio.
- Templates: Selecione o modelo que foi criado.
- atalho para configurar o template.
- Variáveis: Insira a variável que deseja que traga alguma informação. Porém se já criou um template não será necessário inserir.

Depois de criar o modelo de envio, será habilitado uma nova aba Mensagens, selecione os clientes que deseja que seja enviado os SMS.
Clique em Adicionar registro.
Pode-se selecionar os clientes usando os filtros ou inserir de forma individual.
Filtros:
- Cliente - Status: Filtre por Habilitado, Desabilitado, Interessado, Removido ou - (todos).
- CPE - Status: Filtre por Habilitado, Desabilitado, Bloqueado, Pendente ou - (todos).
- Cobrança - Tipo: Filtre pelo tipo Internet, Avulsa, Suporte, ou Todas.
- Status: Filtre a situação da cobrança por Pago, Aberto, Atrasado, Removido ou Todas.
- Data: Filtre a data das cobranças por:
- Vencimento:
- Mês - Cobranças do mês, conforme a data setada.
- Semana - Cobranças da semana, conforme a data setada, a contagem da semana é de segunda a domingo.
- Dia - Cobranças do dia, conforme a data setada.
- > - Cobranças com a data maior, conforme a data setada.
- < - Cobranças com a data menor, conforme a data setada.
- Pagamento:
- Mês - Cobranças pagas do mês, conforme a data setada.
- Semana - Cobranças pagas da semana, conforme a data setada, a contagem da semana é de segunda a domingo.
- Dia - Cobranças pagas do dia, conforme a data setada.
- > - Cobranças pagas com a data maior, conforme a data setada.
- < - Cobranças pagas com a data menor, conforme a data setada.
- Vencimento:
- Limit: Filtre para listar a quantidade de cobranças que seu cliente tem, sendo 1, 2, 3 ou - (todos), esse filtro irá duplicar o nome do seu cliente na lista de envio.
- Todos os clientes: Use este filtro se deseja selecionar clientes específicos (individual).
- Todas as Unidades: Use este filtro para listar o cliente de determinado escritório.
- Painéis: Use este filtro para listar o cliente de determinado painel.
- SMS:
- SMS Marketing - Filtrar os números cadastrados, que for da opção Marketing.
- SMS Cobrança - Filtrar os números cadastrados, que for da opção Cobrança.
Depois de listar seus clientes clique em Adicionar Registro, para que seja enviado o SMS.

OBS: A quantidade de caracteres para o envio do SMS, por padrão deve ser de 144 pt, contando as variáveis. O Controllr não acusará erro de limitação. Deve ser verificado qual é limite de caracteres padrão do seu gateway contratado e deve ser verificado se seu gateway envia contando como 2 SMS de uma vez, se passar da quantidade de caracteres padrão.