Controllr/Aplicativos/Cadastros/Messenger

De BrByte Wiki
< Controllr‎ | Aplicativos‎ | Cadastros
Revisão de 19h11min de 18 de junho 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

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-aplicativos-cadastros-marketing-sms-template.png


Para criar um template, clique em Add.png Novo.


Controllr-aplicativos-cadastros-marketing-sms-template-novo.png


Template
Campo Descrição Exemplo
Nome Insira o nome do seu template Exemplo Template
Habilitado Marque para habilitar em modelo de template
Variáveis Ao montar um novo modelo de template, você pode usar palavras chaves para trazer alguma informação específica do Banco de Dados do seu Controllr
Tabela de Variáveis
Informações dos Clientes
{CLI_NAME} Imprime o nome/fantasia do cadastro do cliente Beltrano
{CLI_NAME_L} Imprime o sobrenome/razão social do cadastro do cliente de Tal
{CLI_NAME_FULL} Imprime o nome/razão social completo Beltrano de Tal
{CLI_USER} Imprime o usuário de login da área do cliente belt
{CLI_PASS} Imprime a senha de login da área do cliente belt
Informações do Escritório
{ISP_NAME_C} Imprime a Razão Social do escritório vinculado à este Contrato maria jose ltda
{ISP_NAME} Imprime o nome fantasia do escritório vinculado à este Contrato Internet Mais Mais
{ISP_ADDR_B} Imprime o bairro do escritório vinculado à este Contrato Jardim TV Morena
{ISP_ADDR} Imprime o endereço do escritório vinculado à este Contrato Rua Maués
{ISP_NUM} Imprime o número do escritório vinculado à este Contrato 200
{ISP_CITY} Imprime a cidade do escritório vinculado à este Contrato Campo Grande
{ISP_STATE} Imprime o estado do escritório vinculado à este Contrato Mato Grosso do Sul
{ISP_CEP} Imprime o CPE do escritório vinculado à este Contrato 79.050-110
{ISP_CNPJ} Imprime o CNPJ do escritório vinculado à este Contrato 23.065.656/0001-98
{ISP_PHONE} Imprime o telefone do escritório vinculado à este Contrato (67) 2233-4455
{ISP_EMAIL} Imprime o e-mail do escritório vinculado à este Contrato internetmaismais@telecom.com.br
{ISP_URL} Imprime o endereço do site do escritório vinculado à este Contrato http://www.internetmaismais.com.br
Informações da cobrança do contrato do seu cliente
{COB_CODE} Imprime o ID da cobrança 00000001
{COB_NUM_DOC} Imprime o número do documento da cobrança -
{COB_VAL_DOC} Imprime o valor da cobrança R$ 30,00
{COB_VAL_PAG} Imprime o valor pago dessa cobrança R$ 0,00
{COB_VAL_DISC} Imprime o valor de desconto até o vencimento dessa cobrança R$ 0,00
{COB_DATE_VENC_Y} Imprime o ano do vencimento dessa cobrança 2020
{COB_DATE_VENC_M} Imprime o mês do vencimento dessa cobrança 04
{COB_DATE_VENC_D} Imprime o dia do vencimento dessa cobrança 15
{COB_DATE_VENC} Imprime a data completa do vencimento dessa cobrança 2020-04-15
{COB_DATE_PAG_Y} Imprime o ano do pagamento dessa cobrança 2020
{COB_DATE_PAG_M} Imprime o mês do pagamento dessa cobrança 04
{COB_DATE_PAG_D} Imprime o dia do pagamento dessa cobrança 05
{COB_DATE_PAG} Imprime a data completa do pagamento dessa cobrança 2020-04-05
{COB_COD_BARRAS} Imprime o código de barras da cobrança enviada 00090.00001 00000.000000 00000.001016 6 82260000003000
{COB_URL_PRINT} Imprime a URL da cobrança para poder ser aberto no navegador.
Lembre-se de configurar os Endereços Externos, para poder aparecer a URL no e-mail que será enviado
http://192.168.142.23/client/print_svc/sign_billet?
{REC_URL_PRINT} Imprime a URL do recibo da cobrança para poder ser aberto no navegador.
Lembre-se de configurar os Endereços Externos, para poder aparecer a URL no e-mail que será enviado
http://192.168.142.23/client/print_svc/receipt?

Modelo de Envio

Após criar o(s) template(s), pode ser criado um modelo de envio conforme sua necessidade e sua mensagem.

Para criar um novo modelo de envio clique em Add.png Novo.

Modelo de Envio
Campo Descrição Exemplo
Nome Insira o nome do seu Modelo de Envio Teste envio
Habilitado Marque para habilitar esse modelo de envio
Template Marque o Template que você criou ou deixe em branco para criar um específico para esse modelo de envio. Se desejar criar o novo Template basta clicar na engrenagem Gear.png para ser redirecionado Exemplo Template
Variáveis Assim com em Template, pode ser adicionado variáveis para esse modelo de envio. -

Enviar SMS

Depois de criar o seu modelo de envio, poderá disparar os SMS.

Controllr-aplicativos-cadastros-marketing-sms-modelo-envio-mensagens.png


Para disparar um SMS clique em Add.png Novo.


Controllr-aplicativos-cadastros-marketing-sms-modelo-envio-mensagens-novo.png


Irá utilizar de diversos filtros para listar os clientes que deseja enviar o SMS.


Enviar E-Mail
Campo Descrição Exemplo
Cliente - Status Marque qual o status do cliente deseja listar:
Reports.png Todas
Dot-green.png Ativos
Dot-blue.png Interessados
Dot-light.png Desabilitados
Reports.png Todas
CPE - Status Marque qual o status da autenticação de CPE que deseja listar:
Dot-light.png Desabilitado
Dot-green.png Ativado
Dot-yellow.png Alertado
Dot-yellow.png Pendente
Dot-red.png Bloqueado
Dot-gray.png Cancelado
Reports.png -
Reports.png -
Cobrança - Tipo Marque qual o tipo de cobrança deseja listar:
Cpe-mac.png Internet
Sale.png Avulso
Support.png Suporte
Reports.png -
Reports.png -
Status Marque o status da cobrança que deseja listar:
Dot-light.png Não Liberada
Dot-blue.png Aberto
Dot-red.png Atrasado
Dot-green.png Pago
Dot-gray.png Removido
Reports.png Todas
Reports.png Todas
Data Escolha um filtro de data para listar as cobranças
Dot-light.png Vencimento - Mês: Cobranças com vencimento esse mês, conforme a data setada no calendário Date-trigger.gif
Dot-light.png Vencimento - Semana: Cobranças com vencimento nesta semana, conforme a data setada no calendário Date-trigger.gif. A contagem da semana é de segunda a domingo
Dot-light.png Vencimento - Dia: Cobranças com vencimento neste dia, conforme a data setada no calendário Date-trigger.gif
Dot-blue.png Vencimento - >: Cobranças com vencimento com a data maior que esse dia, conforme a data setada no calendário Date-trigger.gif
Dot-red.png Vencimento - <: Cobranças com o vencimento com a data menor que esse dia, conforme a data setada no calendário Date-trigger.gif
Dot-light.png Pagamento - Mês: Cobranças com pagamento esse mês, conforme a data setada no calendário Date-trigger.gif
Dot-light.png Pagamento - Semana: Cobranças com pagamento nesta semana, conforme a data setada no calendário Date-trigger.gif. A contagem da semana é de segunda a domingo
Dot-light.png Pagamento - Dia: Cobranças com pagamento neste dia, conforme a data setada no calendário Date-trigger.gif
Dot-blue.png Pagamento - >: Cobranças com pagamento com a data maior que esse dia, conforme a data setada no calendário Date-trigger.gif
Dot-red.png Pagamento - <: Cobranças com o pagamento com a data menor que esse dia, conforme a data setada no calendário Date-trigger.gif
Reports.png -
Limite Dependendo do filtro de cobranças que aplicar, poderá enviar mais de um e-mail por vez. Se aplicar o filtro de data todas e marcar o limite como 5, irá listar 5 x o nome do cliente, pois ele tem 5 cobranças. 1
Contrato - Limite Da mesma lógica que o limite de cobranças, também pode ser aplicado no limite de contrato. 0
Seleção de Campos
Clientes Nessa opção poderá selecionar 1 ou mais clientes específicos, para poder disparar o(s) E-Mail(s) Todos os Clientes
Unidades (Escritório) Nessa opção poderá marcar o escritório que o cliente pertence, para poder disparar o(s) E-Mail(s) Todas as Unidades
Painéis Nessa opção poderá marcar o painel que o cliente pertence, para poder disparar o(s) E-Mail(s) Todos os Painéis
Dispositivos Nessa opção poderá marcar o dispositivo autenticador que o cliente pertence, para poder disparar o(s) E-Mail(s) Todos os Dispositivos
Planos de Acesso Nessa opção poderá marcar o plano de acesso que o cliente pertence, para poder disparar o(s) E-Mail(s) Todos os Planos
SMS Nessa opção poderá marcar o tipo de categoria do telefone marcado no telefone cadastro do seu cliente.
Reports.png Todos
Dot-gray.png SMS Marketing
Dot-gray.png SMS Cobrança
Todos
Save.png Adicionar Registro Após todos os filtros aplicados para a listagem do(s) cliente(s), para pode disparar o(s) E-Mail(s) basta clicar em Save.png Adicionar Registro

Controllr-aplicativos-cadastros-marketing-sms-modelo-envio-mensagens-novo-adicionar-registro.png

Listagem dos Envios

Após ter disparado o envio do(s) SMS. Terá uma lista de todos os envios e com os status.


Controllr-aplicativos-cadastros-marketing-sms-modelo-envio-mensagens.png


Listagem SMS
Campo Descrição Exemplo
Status Marque o status do envio do SMS:
Dot-light.png Nenhum
Dot-light.png Pendente
Dot-blue.png Enviado
Dot-red.png Falhou
Dot-green.png Leitura
Cancelado
Reports.png -
Reports.png -
Flush.png Flush Essa opção serve para excluir em massa todos os SMS disparados, dependendo do filtro que você aplicar. MUITO CUIDADO EM USAR ESTA OPÇÃO, uma vez removido não há como recuperar.

Listagem e Filtros

Poderá realizar filtros para listar modelos de envios específicos e e-mails também.

Controllr-aplicativos-cadastros-marketing-email.png


Listagem e Status
Menu Descrição
Status Marque o status que deseja listar os modelos de envio
Dot-green.png Habilitado
Dot-light.png Desabilitados
Reports.png Todas
Export.png Exportar Após aplicar os filtros, poderá realizar a exportação desse relatório no formato:
Dot-green.png Excel
Dot-light.png CSV
Dot-blue.png HTML
Colunas Ocultas Você pode complementar o seu relatório habilitando colunas ocultas dessa janela. Para aparecer a opção de colunas ocultas você deve passar o mouse em cima da coluna (qualquer coluna), então irá aparecer uma ceta para baixo. Clique nela e vá na opção Columns.gif Columns

Controllr-aplicativos-colunas-ocultas.png
Search.png Busca Nesse campo você pode realizar buscar específicas. Primeiro marque a opção que se refere a busca, depois no outro campo escreve o que buscar conforme a opção marcada, por fim clique na Search.pngLupa