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

De BrByte Wiki
Linha 262: Linha 262:
 
|-
 
|-
 
! style="text-align:left; vertical-align:middle;"| API/URL
 
! style="text-align:left; vertical-align:middle;"| API/URL
| style="text-align:right; vertical-align:middle;" colspan="2"| /api/simpleSend.ft?user={u}&password={p}&destinatario={d}&msg={m}
+
| style="text-align:right; vertical-align:middle;" colspan="2"|<code style="color:black;">/api/simpleSend.ft?user={u}&password={p}&destinatario={d}&msg={m}</code>
 
|-
 
|-
 
! style="text-align:left; vertical-align:middle;"| SSL
 
! style="text-align:left; vertical-align:middle;"| SSL

Edição das 14h00min de 17 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 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.