Mudanças entre as edições de "Controllr/Aplicativos/Cadastros/Messenger"

De BrByte Wiki
Linha 119: Linha 119:
  
 
{| class="table table-bordered table-striped" style="margin:auto;"
 
{| class="table table-bordered table-striped" style="margin:auto;"
! style="text-align:center" colspan="3"| [https://www.khalsms.com.br Khal]
+
! style="text-align:center" colspan="3"| [https://www.khalsms.com.br Khal PlaySMS]
 
|-
 
|-
 
! style="text-align:center; width:16%;"| Campo
 
! style="text-align:center; width:16%;"| Campo
Linha 180: Linha 180:
 
|}
 
|}
  
 +
==Outros==
  
==Envio Automático==
+
Além dos gateways de SMS integrados no Controllr. Poderá escolher outro gateway de sua preferência, que disponibiliza o envio dos SMS via API, com a montagem de uma URL de disparo.
  
* '''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.
+
<div class="img-responsive align-center">[[Arquivo:controllr-aplicativos-cadastros-marketing-sms-configuracao-outros.png|link=]]</div>
  
* '''Quantidade de envios:''' Quantidade de SMS, que devem ser enviados no intervalo de envio.
 
  
 +
{| class="table table-bordered table-striped" style="margin:auto;"
 +
! style="text-align:center" colspan="3"| Outros
 +
|-
 +
! 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;"| Outros
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Usuário
 +
| style="text-align:left; vertical-align:middle;"| O seu usuário do gateway contratado
 +
| style="text-align:left; vertical-align:middle;"| api-sms
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Senha
 +
| style="text-align:left; vertical-align:middle;"| Senha do gateway contratado
 +
| style="text-align:left; vertical-align:middle;"| senha-conta-api
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Host
 +
| style="text-align:left; vertical-align:middle;"| Site aonde será iniciado a comunicação do envio via API com o gateway contratado.
 +
| style="text-align:left; vertical-align:middle;"| www.api-sms.com.br
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Porta
 +
| style="text-align:left; vertical-align:middle;"| Porta que o Controllr deve se comunicar com o Host do gateway contratado
 +
| style="text-align:left; vertical-align:middle;"| 443
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| API/URL
 +
| style="text-align:left; vertical-align:middle;"| Deve ser inserido a URL-API com os parâmetros corretos para ser enviado o SMS do gateway contratado.<br>Cada gateway tem padrão de ser montado a sua URL-API. Mas pelo protocolo de envio de SMS tem palavras chaves de devem ser inseridas na URL-API. O Controllr irá puxar essas palavras chaves através de variáveis:<br>• '''{u}''': Puxa o nome do usuário cadastrado na configuração do seu gateway de envio<br>• '''{p}''': Puxa a senha cadastrada na configuração do seu gateway de envio<br>• '''{d}''': Puxa o número que será enviado o SMS do cadastro do seu cliente<br>• '''{m}''': Puxa a mensagem que será enviada dos modelos de envio
 +
| style="text-align:left; vertical-align:middle;"| API/URL: /api/simpleSend.ft?user={u}&password={p}&destinatario={d}&msg={m}
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| SSL
 +
| style="text-align:left; vertical-align:middle;"| Marque se a comunicação do Controllr com o Host de envio será com criptografia SSL ou não. Geralmente SSL (HTTPS) usam a porta 443 e os sem criptografia (HTTP) usam a porta 80
 +
| style="text-align:left; vertical-align:middle;"| <font size="4" style="color:blue;" ><i class="far fa-check-square"></i></font>
 +
|-
 +
|}
  
'''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.
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_send_automatico.png|link=]]</div>
 
 
 
 
<span style="color:red">'''OBS: Tente manter os valores dos campos <span style="color:black">''iguais''</span> ou que o<span style="color:black"> ''intervalo de envio''</span> seja <span style="color:black">''maior''</span> que a <span style="color:black">''quantidade de envios''</span>. Para que não congestione uma grande quantidade de envios no seu Gateway SMS.'''</span>
 
 
 
 
 
=='''Khal Play SMS'''==
 
 
Para conectar com o '''Khal PlaySMS''' preencha as informações de ID e o tipo da senha fornecidos pela da Khal.
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_confg_khal_playSMS.png|link=]]</div>
 
 
Caso queira uma mensagem do tipo [https://www.khal.com.br/artigo/flash-sms 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
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_confg_zenvia.png|link=]]</div>
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_confg_zenvia_identificador.png|link=]]</div>
 
 
 
 
 
 
'''1º''' Acesse o site do [https://www.zenvia.com/produtos/messaging/sms 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 [https://connect.zenvia360.com/manager/ 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
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_zenvia_email.png|link=]]</div>
 
 
<span style="color:red">'''ATENÇÃO: A senha utilizada no Controllr é a Senha API.'''</span>
 
 
 
==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.
 
  
<div class="img-responsive align-center">[[Arquivo:Controllr_marketing_sms_confg_outros.png|link=]]</div>
 
  
 
===Variáveis da API===
 
===Variáveis da API===

Edição das 10h59min de 30 de maio de 2020

Marketing SMS

No APP Marketing SMS Dev-sms-campaign.png

É 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...


Controllr-aplicativos-cadastros-marketing-sms.png


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


Configuração

Controllr-aplicativos-cadastros-marketing-sms-configuracao.png


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 PlaySMS
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

Outros

Além dos gateways de SMS integrados no Controllr. Poderá escolher outro gateway de sua preferência, que disponibiliza o envio dos SMS via API, com a montagem de uma URL de disparo.


Controllr-aplicativos-cadastros-marketing-sms-configuracao-outros.png


Outros
Campo Descrição Exemplo
Serviço Selecione o serviço do Gateway que irá contratar. Outros
Usuário O seu usuário do gateway contratado api-sms
Senha Senha do gateway contratado senha-conta-api
Host Site aonde será iniciado a comunicação do envio via API com o gateway contratado. www.api-sms.com.br
Porta Porta que o Controllr deve se comunicar com o Host do gateway contratado 443
API/URL Deve ser inserido a URL-API com os parâmetros corretos para ser enviado o SMS do gateway contratado.
Cada gateway tem padrão de ser montado a sua URL-API. Mas pelo protocolo de envio de SMS tem palavras chaves de devem ser inseridas na URL-API. O Controllr irá puxar essas palavras chaves através de variáveis:
{u}: Puxa o nome do usuário cadastrado na configuração do seu gateway de envio
{p}: Puxa a senha cadastrada na configuração do seu gateway de envio
{d}: Puxa o número que será enviado o SMS do cadastro do seu cliente
{m}: Puxa a mensagem que será enviada dos modelos de envio
API/URL: /api/simpleSend.ft?user={u}&password={p}&destinatario={d}&msg={m}
SSL Marque se a comunicação do Controllr com o Host de envio será com criptografia SSL ou não. Geralmente SSL (HTTPS) usam a porta 443 e os sem criptografia (HTTP) usam a porta 80



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


Controllr app cadastros sms facilitamovel config.png


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


Controllr app cadastros sms kingtelecom config.png


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


Controllr app cadastros sms kingtelecom token.png


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


Controllr app cadastros sms allcancesms config.png


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


Controllr app cadastros sms hotmobile config.png



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...


Controllr marketing sms template.png


Para criar um template, clique em Add.png 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.


Controllr marketing sms template novo.png


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 Add.png Novo


  • Nome: O nome para esse envio.
  • Templates: Selecione o modelo que foi criado. Config.png - 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.


Controllr marketing sms send.png


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 Add.png 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.
  • 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 Backup.png Adicionar Registro, para que seja enviado o SMS.


Controllr marketing sms send filter.png


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.