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

De BrByte Wiki
 
(34 revisões intermediárias por 3 usuários não estão sendo mostradas)
Linha 1: Linha 1:
=Marketing SMS=
+
<div class="section-gray">
 +
<div class="row no-padding">
 +
<div class="col-lg-4 effect-loaded"><div class="img-responsive align-center">[[Arquivo:Controllr.png|200px|link=]]</div></div>
 +
<div class="col-lg-8 effect-loaded">
 +
<p>Abaixo tem os menus de cadastros de referência ao uso do APP Messenger para construção e envio do SMS e Email.</p>
  
No APP Marketing SMS  [[arquivo:dev-sms-campaign.png|link=]]
+
<splist parent=Controllr/Aplicativos/Cadastros/Messenger showparent=no sort=asc sortby=title liststyle=unordered showpath=no kidsonly=no debug=0 />
 +
</div>
 +
</div>
 +
</div>
  
É possível realizar o envio de SMS para grupos específicos de [[Controllr/Aplicativos/Cadastros/Clientes | 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...
+
[[Category:Controllr]]
 
+
[[Category:Cadastros]]
 
 
<div class="img-responsive align-center">[[Arquivo:controllr-aplicativos-cadastros-marketing-sms.png|link=]]</div>
 
 
 
 
 
Primeiro deverá configurar o Gateway de envio de SMS. Basta clicar em [[arquivo:config.png|link=]] Configuração.
 
 
 
 
 
=Configuração=
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:controllr-aplicativos-cadastros-marketing-sms-configuracao.png|link=]]</div>
 
 
 
 
 
O Serviço estará com o status desabilitado, então irá contratar um dos gateways que está integrado com o Controllr.
 
 
 
==[[Voipr | Voipr]]==
 
 
 
 
 
Temos 5 opções Gateways para o envio de SMS, basta contratar o que melhor lhe agrada.
 
 
 
* [https://voipr.brbyte.com/ Voipr]
 
 
 
* [http://torpedus.com.br/ Torpedus]
 
 
 
* [https://smsgateway.me/ SmsGateway.me]
 
 
 
* [http://www.khal.com.br/ Khal]
 
 
 
* [https://www.zenvia.com/produtos/messaging/sms Zenvia]
 
 
 
 
 
Depois de contratar um dos Gateway de sua preferência, deve-se integrar ao Controllr.
 
 
 
Acesse a aba [[arquivo:config.png|link=]] Configurações.
 
 
 
 
 
==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.
 
 
 
 
 
 
<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>
 
 
 
 
 
 
 
=Serviços de Gateways=
 
=='''Voipr'''==
 
 
 
* '''Serviço:''' Voipr
 
 
 
* '''Host:''' IP do seu servidor Voipr
 
 
 
* '''Porta:''' Porta de comunicação WEB (Padrão 8080)
 
 
 
* '''Campaign Key:''' É a chave gerada na criação da sua Campanha no seu Voipr.
 
 
 
* '''Client Key:''' É a chave gerada no cadastro do Cliente no seu Voipr.
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_confg_voipr.png|link=]]</div>
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_confg_voipr_2.png|link=]]</div>
 
 
 
 
 
<span style="color:red">'''OBS: No Voipr, quando criar a sua campanha, marque o tipo texto, pois utilizará o template do Controllr.'''</span>
 
 
 
=='''SmsGateway.me'''==
 
 
 
* '''Serviço:''' SmsGateway.me
 
 
 
* '''Usuário:''' Seu e-mail de login do Gateway
 
 
 
* '''Senha:''' Sua senha de acesso ao Gateway
 
 
 
* '''ID do dispositivo:''' É o ID do seu Android, que o APP gera.
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_confg_smsgateway.png|link=]]</div>
 
 
 
 
 
 
 
'''1º''' Faça seu cadastro no site do [https://smsgateway.me/ SmsGateway.me]
 
 
 
'''2º''' Instale o Aplicativo no seu Android. [https://play.google.com/store/apps/details?id=networked.solutions.sms.gateway.api SMS Gateway API]
 
 
 
'''3º''' Faça seu login no APP do SmsGateway, que instalou no seu Android e pronto. Já pode enviar SMS para seus clientes.
 
 
 
A função desse Gateway é transformar seu Android em um Gateway de envio.
 
 
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_confg_smsgateway_api_login.png|link=|400px]][[Arquivo:controllr_marketing_sms_confg_smsgateway_api_id.png|link=|400px]]</div>
 
 
 
 
 
=='''Khal'''==
 
 
 
* '''Serviço:''' Khal
 
 
 
* '''Usuário:''' O telefone de acesso ao seu Gateway
 
 
 
* '''Senha:''' Sua senha de acesso ao Gateway
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_confg_khal.png|link=]]</div>
 
 
 
 
 
'''1º''' Contrate o plano de SMS que melhor lhe agrada e faça seu cadastro no site do [http://www.khal.com.br/ Khal]
 
 
 
'''2º''' Depois de comprar o pacote de SMS e realizar o seu cadastro, '''o vendedor entrará em contato com o e-mail cadastrado''' e passará as
 
informações de usuário, senha e o link para logar no seu [http://172.246.132.10/app/login/ Painel SMS].
 
 
 
<span style="color:red">'''OBS: Após o vendedor entrar em contato no e-mail, informar que irá utilizar a API configurada para o ISP Controllr, pois o Khal trabalha com duas APIs'''
 
'''A forma de identificar a API correta é através do login do seu Gateway'''
 
'''A API que o Controllr trabalha é através do login <nowiki>http://172.246.132.10</nowiki>'''
 
'''A nova API do Khal é através do login <nowiki>http://172.246.132.11</nowiki>.'''</span>
 
:
 
 
 
'''3º'''  Ao logar pode-se visualizar os SMS enviados em ''SMS > Fila de Transmissão''.
 
 
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_confg_khal_login.png|link=]]</div>
 
 
 
=='''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===
 
 
 
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<br>
 
'''{p}''': Senha<br>
 
'''{d}''': Número do destinatário<br>
 
'''{m}''': Conteúdo da mensagem<br>
 
 
 
 
 
===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
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:Controllr_app_cadastros_sms_facilitamovel_config.png|link=]]</div>
 
 
 
 
 
===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
 
 
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_app_cadastros_sms_kingtelecom_config.png|link=]]</div>
 
 
 
 
 
O token é obtido no painel do cliente http://painel.kingsms.com.br/cliente menu Home -> Informações da Conta -> Token
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:Controllr_app_cadastros_sms_kingtelecom_token.png|link=]]</div>
 
 
 
 
 
 
 
===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
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:Controllr_app_cadastros_sms_allcancesms_config.png|link=]]</div>
 
 
 
 
 
 
 
===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
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:Controllr_app_cadastros_sms_hotmobile_config.png|link=]]</div>
 
 
 
 
 
 
 
 
 
=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...
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_template.png|link=]]</div>
 
 
 
 
 
Para criar um template, clique em [[arquivo:add.png|link=]] 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.
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_template_novo.png|link=]]</div>
 
 
 
 
 
 
 
=Variáveis=
 
<br>
 
{| class="wikitable table " style ="text-align:left; margin: auto; "
 
 
 
! 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
 
|-
 
|}
 
<br>
 
<br>
 
Caso tenha dúvidas de outras variáveis, acesse a wiki específica de [[Controllr/Manual/Variáveis|variáveis]]
 
<br>
 
<br>
 
 
 
=Enviar SMS=
 
 
 
Depois de ter configurado o gateway e o template, basta enviar enviar o SMS clicando em [[arquivo:add.png|link=]] Novo
 
 
 
 
 
* '''Nome:''' O nome para esse envio.
 
 
 
* '''Templates:''' Selecione o modelo que foi criado. [[arquivo:config.png|link=]] - 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.
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_send.png|link=]]</div>
 
 
 
 
 
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 [[arquivo:add.png|link=]] 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 [[arquivo:backup.png|link=|18px]] Adicionar Registro, para que seja enviado o SMS.
 
 
 
 
 
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_send_filter.png|link=]]</div>
 
 
 
 
 
 
 
<span style="color:red">'''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.'''</span>
 
 
 
 
 
__NOEDITSECTION__
 
[[Category:Marketin]]
 

Edição atual tal como às 09h54min de 28 de fevereiro de 2023

Controllr.png

Abaixo tem os menus de cadastros de referência ao uso do APP Messenger para construção e envio do SMS e Email.