Mudanças entre as edições de "Controllr/Aplicativos/Cadastros/Messenger"
Linha 139: | Linha 139: | ||
=='''Khal Play SMS'''== | =='''Khal Play SMS'''== | ||
− | Para conectar com o Khal PlaySMS preencha as informações de | + | Para conectar com o '''Khal PlaySMS''' preencha as informações de ID e o tipo da senha fornecidos pela da Khal. |
<div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_confg_khal_playSMS.png|link=]]</div> | <div class="img-responsive align-center">[[Arquivo:controllr_marketing_sms_confg_khal_playSMS.png|link=]]</div> | ||
− | Caso queira uma mensagem do tipo Flash marque a opção '''Flash''' no menu. | + | Caso queira uma mensagem do tipo [[https://www.khal.com.br/artigo/flash-sms|Flash]] marque a opção '''Flash''' no menu. |
=='''Zenvia'''== | =='''Zenvia'''== |
Edição das 17h32min de 18 de novembro de 2019
Índice
Marketing SMS
Tópico referente a configuração do APP Marketing SMS
Utilizando-se deste App é possível realizar o envio de e-mail para grupos específicos de Cliente utilizando-se dos filtros disponíveis na seleção dos Clientes, podendo então criar campanhas para Cliente em atraso, clientes em dia.
![Controllr app marketing sms.png](/images/5/51/Controllr_app_marketing_sms.png)
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 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 Velocida: Informa o cliente que encontra-se com velocidade reduzida devido a pendenecia, 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](/images/3/3f/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](/images/2/2a/Controllr_marketing_sms_confg_voipr.png)
![Controllr marketing sms confg voipr 2.png](/images/9/99/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](/images/9/9c/Controllr_marketing_sms_confg_smsgateway.png)
1º Faça seu cadastro no site do SmsGateway.me
2º Instale o Aplicativo no seu Android. SMS Gateway API
3º 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.png](/images/2/2a/Controllr_marketing_sms_confg_smsgateway_api_login.png)
![Controllr marketing sms confg smsgateway api id.png](/images/3/3d/Controllr_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](/images/5/5a/Controllr_marketing_sms_confg_khal.png)
1º Contrate o plano de SMS que melhor lhe agrada e faça seu cadastro no site do Khal
2º 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.
3º Ao logar pode-se visualizar os SMS enviados em SMS > Fila de Transmissão.
![Controllr marketing sms confg khal login.png](/images/c/c2/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](/images/e/ec/Controllr_marketing_sms_confg_khal_playSMS.png)
Caso queira uma mensagem do tipo [[1]] 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](/images/4/4b/Controllr_marketing_sms_confg_zenvia.png)
![Controllr marketing sms confg zenvia identificador.png](/images/2/2e/Controllr_marketing_sms_confg_zenvia_identificador.png)
1º Acesse o site do Zenvia e faça seu cadastro.
2º 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.
3º 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](/images/a/af/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](/images/3/31/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](/images/e/e6/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](/images/3/38/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](/images/6/6f/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](/images/5/5e/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](/images/3/3e/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](/images/e/ea/Controllr_marketing_sms_template.png)
Para criar um template, clique em 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](/images/8/87/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 Controllr/Variáveis
Enviar SMS
Depois de ter configurado o gateway e o template, basta enviar enviar o SMS clicando em Novo
- Nome: O nome para esse envio.
- Templates: Selecione o modelo que foi criado.
- 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](/images/d/de/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 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.
- Vencimento:
- 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 Adicionar Registro, para que seja enviado o SMS.
![Controllr marketing sms send filter.png](/images/0/0d/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.