Controllr/Aplicativos/Cadastros/Messenger

De BrByte Wiki
< Controllr‎ | Aplicativos‎ | Cadastros
Revisão de 17h39min de 27 de abril de 2020 por Miguel (discussão | contribs)

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

Temos 5 opções Gateways para o envio de SMS, basta contratar o que melhor lhe agrada.


Depois de contratar um dos Gateway de sua preferência, deve-se integrar ao Controllr.

Acesse a aba Config.png 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.


Controllr marketing sms send automatico.png


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.


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.


Controllr marketing sms confg voipr.png


Controllr marketing sms confg voipr 2.png


OBS: No Voipr, quando criar a sua campanha, marque o tipo texto, pois utilizará o template do Controllr.

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.


Controllr marketing sms confg smsgateway.png


 Faça seu cadastro no site do SmsGateway.me
 Instale o Aplicativo no seu Android. SMS Gateway API
 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.


Controllr marketing sms confg smsgateway api login.pngControllr marketing sms confg smsgateway api id.png


Khal

  • Serviço: Khal
  • Usuário: O telefone de acesso ao seu Gateway
  • Senha: Sua senha de acesso ao Gateway


Controllr marketing sms confg khal.png


 Contrate o plano de SMS que melhor lhe agrada e faça seu cadastro no site do Khal
 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 Painel SMS.
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 http://172.246.132.10 
A nova API do Khal é através do login http://172.246.132.11.
  Ao logar pode-se visualizar os SMS enviados em SMS > Fila de Transmissão.


Controllr marketing sms confg khal login.png

Khal Play SMS

Para conectar com o Khal PlaySMS preencha as informações de ID e o tipo da senha fornecidos pela da Khal.

Controllr marketing sms confg khal playSMS.png

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


Controllr marketing sms confg zenvia.png
Controllr marketing sms confg zenvia identificador.png



 Acesse o site do Zenvia e faça seu cadastro. 
 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.
 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

Controllr marketing sms zenvia email.png
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.

Controllr marketing sms confg outros.png

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.