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

De BrByte Wiki
Linha 289: Linha 289:
 
|-
 
|-
 
! style="text-align:left; vertical-align:middle;"| Usuário
 
! style="text-align:left; vertical-align:middle;"| Usuário
| style="text-align:left; vertical-align:middle;"| O seu usuário do gateway King SMS.<br>OBS: Para logar no seu painel de cliente do King SMS [https://painel.kingsms.com.br/cliente/login.php clique aqui]  
+
| style="text-align:left; vertical-align:middle;"| O seu usuário do gateway King SMS.<br>OBS: Para logar no seu painel de cliente do King SMS [https://painel.kingsms.com.br/cliente/login.php clique aqui!]  
 
| style="text-align:left; vertical-align:middle;"| usuario_king_sms
 
| style="text-align:left; vertical-align:middle;"| usuario_king_sms
 
|-
 
|-
Linha 312: Linha 312:
 
|}
 
|}
  
===Allcance SMS===
+
===[https://www.allcancesms.com.br/index.html#home 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
 
  
  
Linha 332: Linha 318:
  
  
 +
{| class="table table-bordered table-striped" style="margin:auto;"
 +
! style="text-align:center" colspan="3"| [https://www.allcancesms.com.br/index.html#home Allcance SMS]
 +
|-
 +
! style="text-align:center; width:8%;"| 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 Allcance SMS.<br>OBS: Para logar no painel do cliente [http://corporativo.allcancesms.com.br/app/login/ clique aqui!]
 +
| style="text-align:left; vertical-align:middle;"| usuario_allcance_sms
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Senha
 +
| style="text-align:left; vertical-align:middle;"| Senha do gateway Allcance SMS
 +
| style="text-align:left; vertical-align:middle;"| senha_allcance_sms
 +
|-
 +
! 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 Allcance SMS
 +
| style="text-align:left; vertical-align:middle;"| <nowiki>corporativo.allcancesms.com.br</nowiki>
 +
|-
 +
! 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 Allcance SMS
 +
| style="text-align:left; vertical-align:middle;"| 80
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| API/URL
 +
| style="text-align:right; vertical-align:middle;" colspan="2"|<code style="color:black;">/app/modulo/api/index.php?action=sendsms&lgn={u}&pwd={p}&numbers={d}&msg={m}</code>
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| SSL
 +
| style="text-align:right; vertical-align:middle;" colspan="2"| <font size="4" style="color:blue;" ><i class="far fa-square"></i></font>
 +
|-
 +
|}
  
===HotMobile===
+
===[https://www.hotmobile.com.br/moveis/index.html 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
 
  
  
Linha 353: Linha 359:
  
  
 +
{| class="table table-bordered table-striped" style="margin:auto;"
 +
! style="text-align:center" colspan="3"| [https://www.hotmobile.com.br/moveis/index.html HotMobile]
 +
|-
 +
! style="text-align:center; width:8%;"| 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 Hotmobile.<br>OBS: Para logar no painel do cliente [https://painel.hotmobile.com.br/a clique aqui!]
 +
| style="text-align:left; vertical-align:middle;"| usuario_hotmobile_sms
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Senha
 +
| style="text-align:left; vertical-align:middle;"| Senha do gateway Hotmobile SMS
 +
| style="text-align:left; vertical-align:middle;"| senha_hotmobile_sms
 +
|-
 +
! 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 Hotmobile SMS
 +
| style="text-align:left; vertical-align:middle;"| <nowiki>painel.hotmobile.com.br</nowiki>
 +
|-
 +
! 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 Hotmobile SMS
 +
| style="text-align:left; vertical-align:middle;"| 80
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| API/URL
 +
| style="text-align:right; vertical-align:middle;" colspan="2"|<code style="color:black;">/SendAPI/Send.aspx?usr={u}&pwd={p}&number={d}&msg={m}</code>
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| SSL
 +
| style="text-align:right; vertical-align:middle;" colspan="2"| <font size="4" style="color:blue;" ><i class="far fa-square"></i></font>
 +
|-
 +
|}
  
  

Edição das 13h11min 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 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.