Documentação do Processo de Integração com o WhatsApp

Autor: Bruno Martiniano Freire

Revisão: Fernando Jeferson

Sumário

Introdução

A integração foi feita utilizando o componente Whats4Delphi. Sendo assim não se trata de uma integração com a API oficial do WhatsApp, apesar de fazer uso de um meio oficial o qual falaremos a seguir.

Para alinhamento antes de aprofundar no assunto o WhatsApp é um aplicativo mobile de comunicação através de mensagens de texto onde é possível enviar arquivos em anexo às mensagens como Foto, Vídeo, Áudio, Pdf entre outros.

O aplicativo possui também uma versão web que é o meio utilizado pelo componente para poder receber e enviar as mensagens e anexos. Dito isto, é importando entender que esta versão web da aplicação será executada no aplicativo de monitoramento de envios (veremos mais sobre ele posteriormente).

Pode ser que até o dia que esteja lendo esta documentação alguma dessas regras tenham sido alteradas ou até acrescidas de algum outro ponto importante. Caso isso aconteça e venha a “quebrar” a aplicação, entre em contato com o suporte.

Módulo de Contatos

Dentro do Nereus foi criado um módulo onde é possível realizar o cadastro de contatos que serão utilizados para a finalidade de troca de mensagens com o WhatsApp.

Dentro deste cadastro é possível definir se o contato se encontra ativo ou não, além de informar se será permitido o envio de promoções via WhatsApp para este número.

Outro recurso interessante é que ao cadastrar um novo contato, este ficara com um ícone do WhatsApp cinza que posteriormente mudará de cor para Verde ou Vermelho indicando que o número é válido ou não como contato do WhatsApp, então é importante atentar-se neste detalhe para garantir que a comunicação será certa com o cliente.

Na tela de listagem dos contatos é possível realizar a importação dos contatos vindos do cadastro de Pessoa. Para isso basta apenas o contato possuir um número de celular com mais de 8 dígitos na ficha do cadastro de pessoa e a pessoa estar vinculado à empresa filtrada nesta tela.

É possível acessar o cadastro de pessoas de dentro do cadastro do contato

Módulo de Listas de Transmissão

O intuito deste módulo é poder cadastrar modelos de mensagens que serão enviadas de acordo com o tipo definido.
CRM >Lista de Transmissão

Tipos de Transmissão

Explicando cada tipo de lista:

  • PROMOCAO – listas do tipo promoção ao serem processadas, irá gerar mensagens para todos os contatos que estiverem habilitados para receber promoção.
  • INTERNO – Enviar mensagem para os funcionários internos da empresa.
  • COTACAO – Enviar lembrete para precificação com informações como link para acesso da plataforma de cotação web, listagem dos produtos em cotação, data de vigência para precificação entre outras informações.
  • ORCAMENTO – Enviar orçamento para um ou mais clientes a partir do módulo de gestão de pedidos.
  • ANIVERSARIO – Enviar tanto mensagem de parabenização para aniversariantes do dia como possíveis ofertas para aniversariantes do mês.
  • COBRANCA | DIVERSOS | PESQUISA DE SATISFAÇÃO – Para futuras implementações.
  • Incluir
  • Monte a mensagem como desejado e clique em Salvar


Nestes modelos é possível inserir “Tags Curingas” que serão alteradas com algumas informações buscadas na base de dados no ato do processamento da lista. Sendo assim, é possível reaproveitar a mesma lista quantas vezes desejar.
É possível agendar uma data e hora para o envio das mensagens ao processar uma lista de transmissão.
Para um próximo desenvolvimento que já está planejado, já é possível definir que a lista realizará processamento automático em determinados dias da semana além de já deixar pré-definido quais promoções serão consideradas ao realizar este processamento. Para isso basta marcar a lista como repetir e selecionar os dias da semana. (valido para envio de promoção, interno e aniversário)
È possível realizar o envio manual da Listra de transmissão
Opções > Processar Lista de Transmissão ( CTRL + T )

Monitor de Envios

Como já comentado anteriormente, o Monitor de Envios é uma aplicação que fica que tem por finalidade ficar verificando o tempo todo se existe mensagem para enviar via WhatsApp além também de verificar se existe algum contato pendente de validação do número e caso existir ele executa a consulta na API do WhatsApp para esta finalidade retornando se o número tem ou não WhatsApp.

É importante ao executar pela primeira vez realizar a configuração de conexão com o banco de dados e informar o parâmetro Executar ao Abrir para que ao ser executada, a aplicação realize o Start do processo automaticamente. Uma ideia complementar é adicionar um Atalho do aplicativo na pasta de inicialização do Windows. Para localizar esta pasta basta executar o comando [Win + R] >> shell:startup

O parâmetro Acompanhar Log não precisa estar marcado, pois todo log da aplicação é salvo em arquivo desmembrado por data. Para visualizá-los basta acessar a pasta Logs que fica junto ao executável da aplicação.

Envio de Cotação

Para efetuar o envio de cotação é possível fazer tanto pelo módulo de Lista de Transmissão quanto pelo módulo de Cotação.

No módulo de Listas de transmissão é preciso selecionar o template da mensagem e acessar o menu Opções >> Processar Lista de Transmissão ou use o atalho [Ctrl + T].

Após isso usando [Ctrl + Espaço] é só selecionar as cotações a serem realizadas o envio.

A outra opção é enviar no próprio módulo de cotação bastando apenas selecionar as cotações desejadas usando [Ctrl + Espaço] e acessando o menu Opções >> Enviar Via WhatsApp.

Caso houver mais de um template de transmissão, será exibida uma tela para informar o desejado.

Envio de Orçamentos

O Envio de orçamentos pode ser feito a partir de 3 lugares distintos:

  • Módulo de Lista de Transmissão

Selecione o template da mensagem e acesse o menu Opções >> Processar Lista de Transmissão ou use o atalho [Ctrl + T].

  • Módulo de Gestão de Pedidos

No módulo de gestão de pedidos é possível selecionar os pedidos usando [Ctrl + Espaço] e efetuar o envio acessando o menu Opções >> Enviar orçamento Via WhatsApp. Está opção faz uso do layout cadastrado no módulo de lista de transmissão, e caso houver mais de um layout cadastrado, será exibida uma tela onde o usuário poderá selecionar qual modelo de mensagem deverá ser encaminhada.

  • Balcão de Vendas

No balcão de vendas acessando a consulta de pedidos [F7] é possível fazer o envio de pedido como orçamento. Para isso basta clicar no pedido desejado e acessar o menu Opções >> Enviar Orçamento via WhatsApp ou apenas pelo atalho [Ctrl + O].

Feito isso, agora é conferir os dados do cliente na tela que será exibida. Caso um cliente já tiver sido informado na venda [F9], será realizada uma consulta e ao lado direito aparecerá uma listem dos contatos cadastrado para essa pessoa. Porém em todo caso, é possível digitar esses dados no ato do envio. É importante e de responsabilidade do Operador que os dados informados sejam conferidos e atualizados no ato do envio para enviar aborrecimentos da parte dos clientes.

Envio de Promoções

Para efetuar o envio de promoções, é possível selecionar um registro de template do tipo PROMOCAO e efetuar o processamento do mesmo. Neste caso, TODOS os contatos que estiverem marcados como Permitir Receber Promoções será notificado com a mensagem referente às promoções selecionadas.

Para deixar uma ou mais promoções já vinculadas à um template de envio, basta acessar o cadastro da Lista de Transmissão e selecionar as promoções desejadas.

As promoções já marcadas no layout serão selecionadas automaticamente, porém é possível tanto remover quanto adicionar mais promoções antes de confirmar o processamento.

Ainda na ficha de cadastro da Lista de Transmissão é possível definir um agendamento de Data e Hora para envio das mensagens.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *