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

De BrByte Wiki
Linha 397: Linha 397:
 
=Template=
 
=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...
+
Depois de configurar o seu servidor de SMS. Agora deve-se configurar o Template (modelos de SMS), pode ser criados vários, como de cobrança, lembrete, etc...Já existem vários prontos, que são dos envios automáticos do sistema.
  
  

Edição das 13h18min de 18 de junho 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: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


Segue alguns gateways de SMS que usam a opção de envio via URL-API:


Facilita Movel

Controllr app cadastros sms facilitamovel config.png


Facilita Movel
Campo Descrição Exemplo
Serviço Selecione o serviço do Gateway que irá contratar. Outros
Usuário O seu usuário do gateway Facilita Movel usuario_facilita
Senha Senha do gateway Facilita Movel senha_facilita
Host Site aonde será iniciado a comunicação do envio via API com o gateway Facilita Movel www.facilitamovel.com.br
Porta Porta que o Controllr deve se comunicar com o Host do gateway Facilita Movel 443
API/URL /api/simpleSend.ft?user={u}&password={p}&destinatario={d}&msg={m}
SSL

King SMS

King SMS
Campo Descrição Exemplo
Serviço Selecione o serviço do Gateway que irá contratar. Outros
Usuário O seu usuário do gateway King SMS.
OBS: Para logar no seu painel de cliente do King SMS clique aqui!
usuario_king_sms
Senha Senha do gateway King SMS senha_king_sms
Host Site aonde será iniciado a comunicação do envio via API com o gateway King SMS painel.kingsms.com.br
Porta Porta que o Controllr deve se comunicar com o Host do gateway King SMS 80
API/URL /kingsms/api.php?acao=sendsms&login={u}&token=SEU_TOKEM&numero={d}&msg={m}
SSL

Allcance SMS

Controllr app cadastros sms allcancesms config.png


Allcance SMS
Campo Descrição Exemplo
Serviço Selecione o serviço do Gateway que irá contratar. Outros
Usuário O seu usuário do gateway Allcance SMS.
OBS: Para logar no painel do cliente clique aqui!
usuario_allcance_sms
Senha Senha do gateway Allcance SMS senha_allcance_sms
Host Site aonde será iniciado a comunicação do envio via API com o gateway Allcance SMS corporativo.allcancesms.com.br
Porta Porta que o Controllr deve se comunicar com o Host do gateway Allcance SMS 80
API/URL /app/modulo/api/index.php?action=sendsms&lgn={u}&pwd={p}&numbers={d}&msg={m}
SSL

HotMobile

Controllr app cadastros sms hotmobile config.png


HotMobile
Campo Descrição Exemplo
Serviço Selecione o serviço do Gateway que irá contratar. Outros
Usuário O seu usuário do gateway Hotmobile.
OBS: Para logar no painel do cliente clique aqui!
usuario_hotmobile_sms
Senha Senha do gateway Hotmobile SMS senha_hotmobile_sms
Host Site aonde será iniciado a comunicação do envio via API com o gateway Hotmobile SMS painel.hotmobile.com.br
Porta Porta que o Controllr deve se comunicar com o Host do gateway Hotmobile SMS 80
API/URL /SendAPI/Send.aspx?usr={u}&pwd={p}&number={d}&msg={m}
SSL


Template

Depois de configurar o seu servidor de SMS. Agora deve-se configurar o Template (modelos de SMS), pode ser criados vários, como de cobrança, lembrete, etc...Já existem vários prontos, que são dos envios automáticos do sistema.


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.