Resumo

A integração do WATI com o Bitrix24 permite que empresas se comuniquem de forma contínua com clientes via WhatsApp diretamente na plataforma de CRM do Bitrix24. Com essa integração, você pode:

Enviar campanhas no WhatsApp usando modelos aprovados pela META.
Responder a consultas de clientes dentro do Bitrix24.
Atribuir mensagens a agentes disponíveis.
Criar automaticamente leads ou contatos.

Este guia explica o processo passo a passo para integrar o WATI ao Bitrix24.

Instruções

Requisitos de Acesso

Você deve ter uma assinatura ativa do WATI Pro ou Business Plan.
A integração está disponível exclusivamente para clientes do plano Pro+.

Por que Integrar o Bitrix24?

Principais Benefícios

Mensagens de WhatsApp Diretas: Comunique-se com clientes diretamente no Bitrix24.
Criação Automática de Leads e Contatos: Crie e atualize contatos automaticamente com base em mensagens recebidas.
Comunicação Centralizada: Todas as interações do WhatsApp são armazenadas no CRM do Bitrix24.
Eficiência no Fluxo de Trabalho: Atribua e gerencie conversas usando os Canais Abertos do Bitrix24.

Principais Recursos da Integração com o Bitrix24

Envio de Mensagens de Modelo do WhatsApp
- Use o WATI para enviar mensagens de modelo aprovadas pelo WhatsApp a partir do Bitrix24.
- As mensagens podem ser iniciadas em workflows ou campanhas de marketing.
Mensagens Bidirecionais
- Receba e responda a mensagens de serviço diretamente dos Canais Abertos do Bitrix24.
Integração com CRM
- Mensagens recebidas são vinculadas automaticamente ao lead/contato relevante no CRM do Bitrix24.
Integração com Canais Abertos
- Armazene todas as conversas com clientes e atribua-as a vários agentes em uma fila.
Criação Automática de Contatos
- Mensagens recebidas acionam a criação automática de leads/contatos/negócios.
- Evite duplicações vinculando mensagens a contatos existentes.

Como Integrar o WATI ao Bitrix24

Passo 1: Obtenha as Credenciais da API no WATI

Faça login na sua conta do WATI.
Navegue até Mais → Documentação da API.
Copie o Token de Acesso e a URL do Endpoint da API.

Passo 2: Crie um Webhook de Entrada no Bitrix24

No Bitrix24, vá para Menu de Aplicativos → Recursos do Desenvolvedor → Outros → Webhook de Entrada → Criar.
Atribua permissões para:
- CRM
- Serviço de Mensagens
- Chat e Notificações
Copie a URL do Webhook do campo "Webhook para chamar a API REST".

Este webhook permitirá a comunicação contínua entre o WATI e o Bitrix24.

Passo 3: Configure o WATI no Marketplace do Bitrix24

Instale o Aplicativo WATI:
- Primeiro, instale o aplicativo WATI no Marketplace do Bitrix24. Após a instalação, acesse as configurações do aplicativo.
Insira os Detalhes da API e do Webhook:
- Cole os seguintes detalhes nos campos correspondentes:
  - Endpoint da API do WATI (copiado no Passo 1)
  - Token de Acesso (copiado no Passo 1)
  - URL do Webhook de Entrada do Bitrix24 (copiado no Passo 2)
- Salve as configurações.

Configuração do Canal Aberto

Para configurar o canal aberto, você precisará criar um novo aplicativo nos Recursos do Desenvolvedor do Bitrix24. Siga estas etapas:

Faça Login no Bitrix24 como Administrador

Acesse seu aplicativo Bitrix24 e faça login como Administrador.
No menu lateral, selecione Recursos do Desenvolvedor.

Navegue até Casos de Uso Comuns

Na aba Casos de Uso Comuns, role até o final da página.
Clique na opção Outros.

Configure o Aplicativo Local

Escolha a opção Aplicativo Local.

Na página de configuração do aplicativo, insira os seguintes detalhes:
- Caminho do Manipulador: https://apps.izaap.in/apps/wat/index2.php
- Caminho de Instalação Inicial: https://apps.izaap.in/apps/wat/install_open_channel.php
- Texto do Item do Menu (Inglês - en): Wat Open Channel Application Configuration
Atribua as seguintes permissões:
- Conectores de mensagens externas (imconnector)
- Canais Abertos (imopenlines)
Clique em Salvar no final da página.

Copie o ID do Cliente e a Chave Secreta

Após salvar a configuração, copie o ID do Cliente do Aplicativo e a Chave Secreta.
Clique em Reinstalar na mesma página para instalar o aplicativo. Confirme a mensagem de sucesso.

Cole o ID do Cliente e a Chave Secreta no Marketplace do WATI

Volte à página inicial do aplicativo WATI no Marketplace do Bitrix24.
Cole o ID do Cliente e a Chave Secreta nos campos correspondentes.

#Acessar e Configurar o Centro de Contatos

Acessar a Página do Centro de Contatos

Navegue até a página do Centro de Contatos: https://<seu-domínio>/services/contact_center/.
Selecione a conexão Wati Open Channel.

Conectar e Configurar o Canal Aberto Wati

No menu suspenso de canais abertos, escolha Wati Open Channel e clique em Conectar.
Após a conexão, você poderá:
- Receber mensagens de clientes via WATI.
- Responder às mensagens diretamente no canal aberto.
Usar a opção Configurar no canal aberto para ajustar as definições conforme necessário.
Na página de configuração, selecione Wati como a fonte do CRM no menu suspenso de fontes.

Observações Importantes

Substitua <seu-domínio>: Certifique-se de substituir <seu-domínio> pelo domínio real do seu Bitrix24.
Teste a Integração: Após a configuração, teste a integração para verificar se as mensagens estão sendo transmitidas corretamente entre o WATI e o Bitrix24.

Passo 4: Sincronizar Modelos do WATI com o Bitrix24

Abra o aplicativo WATI no Marketplace do Bitrix24.
Clique em Sincronizar Modelos para atualizar os modelos do WATI no Bitrix24.

Passo 5: Enviar Mensagens de Modelo via Workflow

No CRM do Bitrix24, acesse: Workflows → Atividades de Aplicativos → [Wati API] Enviar Mensagem de Modelo.
Preencha os seguintes campos:
- Número de telefone do cliente
- Nome do modelo do WATI
- Chave e valor do parâmetro do modelo
Clique em Enviar.

Após o envio, a resposta estará disponível na seção de resultados adicionais do workflow.

Observação Importante sobre Modelos do WATI:

Nos modelos do WATI, as variáveis de parâmetro são delimitadas por chaves {}. Ao configurar seu workflow:
- Insira as variáveis de parâmetro no campo Chave do Parâmetro do Modelo.
- Especifique os valores correspondentes na mesma ordem em que aparecem no modelo do WATI.
Se os campos Chave do Parâmetro do Modelo e Valor forem deixados em branco, o sistema usará automaticamente as chaves e valores definidos no modelo do WATI.
A resposta do workflow incluirá detalhes como: Status da mensagem, Número de telefone do destinatário, Informações do modelo do WATI.

Passo 6: Enviar Campanhas no WhatsApp

O envio de campanhas em massa pelo WhatsApp para seus clientes é fácil com o CRM Bitrix24. Siga estes passos simples para configurar e lançar sua campanha:

Acessar o Menu de Marketing

No CRM Bitrix24, navegue até o menu Marketing.
No menu superior, selecione Campanha.

Selecionar o Tipo de Campanha

Escolha Campanha de SMS como tipo de campanha.
Selecione o modelo do WhatsApp que deseja usar para sua campanha.

Configurar a Campanha

Especifique o tipo de provedor de SMS (selecione WATI ou seu provedor preferido).
Crie um segmento de público-alvo para sua campanha (ex.: um grupo específico de clientes).

Inserir Nomes dos Modelos

Na caixa de texto da mensagem, insira os nomes dos modelos neste formato:[wati_template, wati_template2]
Você pode copiar os nomes dos modelos na seção Broadcast da sua conta WATI e colá-los aqui.

Agendar a Campanha

Salve os detalhes da campanha.
Selecione a data e horário para envio da campanha.

Acompanhar Status de Entrega

Após o envio da campanha, você pode acompanhar o status de entrega na página Listagem de Campanhas de SMS.

Passo 7: Configurar Webhooks no WATI

Os webhooks são uma forma eficiente de monitorar mensagens recebidas de clientes e acompanhar o status das mensagens enviadas no WATI. Ao configurar webhooks, você garante que seu sistema seja atualizado em tempo real. Veja como configurar webhooks na sua conta WATI:

Guia Passo a Passo para Configurar Webhooks

Acesse sua conta WATI:
- Faça login na sua conta WATI. Caso não tenha uma conta, será necessário criá-la primeiro.
Acesse as configurações de Webhook:
- No menu Mais, selecione Webhooks e clique em Adicionar Webhook.

Insira a URL do Webhook:
- Insira as seguintes URLs de webhook, substituindo SEU DOMÍNIO BITRIX24 pela URL real do seu portal Bitrix24:

URL para Mensagens Recebidas

`https://apps.izaap.in/apps/wati/message_received_webhook_handler.php?DOMAIN=SEU DOMÍNIO BITRIX24`

URL para Mensagens de Modelo Enviadas/Falhas

`https://apps.izaap.in/apps/wati/template_message_delivered_webhook_handler.php?DOMAIN=SEU DOMÍNIO BITRIX24`

URL para Mensagens de Sessão Enviadas

`https://apps.izaap.in/apps/wati/message_delivered_webhook_handler.php?DOMAIN=SEU DOMÍNIO BITRIX24`

Selecione o tipo de evento:
- Escolha o tipo de evento apropriado no menu suspenso para garantir que o webhook seja acionado para as ações corretas (ex.: mensagem recebida, mensagem enviada).
Ative o Webhook:
- Selecione a opção Ativado no menu suspenso para ativar o webhook.
Salve as configurações:
- Clique em Salvar para aplicar as alterações.

Observações Importantes

Substitua seu domínio Bitrix24: Não esqueça de substituir SEU DOMÍNIO BITRIX24 nas URLs pelo domínio real do seu portal Bitrix24.
Teste os webhooks: Após a configuração, recomenda-se testar os webhooks para verificar se estão funcionando corretamente.

Perguntas frequentes (FAQs)

Perguntas gerais

1. O que é a integração do WATI com o Bitrix24?

→ A integração do WATI com o Bitrix24 permite que empresas enviem e recebam mensagens do WhatsApp diretamente dentro do CRM Bitrix24, proporcionando uma comunicação com o cliente de forma fluida.

2. Quem pode usar essa integração?

→ Essa integração está disponível para clientes do plano WATI Pro+.

3. Por que devo integrar o WATI com o Bitrix24?

→ Isso ajuda a centralizar a comunicação, automatizar a criação de leads/contatos e melhorar a eficiência dos fluxos de trabalho ao gerenciar conversas dentro do Bitrix24.

Configuração e instalação

4. Quais são os pré-requisitos para integrar o WATI com o Bitrix24?

Ter uma assinatura ativa do plano WATI Pro ou Business.
Acesso ao Bitrix24 com as permissões necessárias.

5. Onde encontro as credenciais da API do WATI?

→ Acesse sua conta WATI, vá em Mais → Documentação da API e copie o Access Token e a URL do API Endpoint.

6. Como criar um webhook de entrada no Bitrix24?

Navegue até Menu de Aplicações → Recursos do Desenvolvedor → Outros → Webhook de Entrada → Criar.
Atribua as permissões necessárias.
Copie a URL do Webhook para utilizar no WATI.

7. Quais permissões devem ser atribuídas ao criar um webhook de entrada?

→ É necessário conceder permissões para:

CRM
Serviço de Mensagens
Chat e Notificações

8. Como instalar e configurar o aplicativo WATI no Bitrix24?

Instale o aplicativo WATI no Marketplace do Bitrix24.
Insira os dados da API e do webhook nas configurações do aplicativo.
Salve a configuração.

9. Como configurar os Canais Abertos no Bitrix24 para o WATI?

Crie um aplicativo local em Recursos do Desenvolvedor do Bitrix24.
Insira os caminhos do handler e de instalação.
Atribua permissões para conectores de mensageiros externos e Canais Abertos.
Salve a configuração e reinstale o aplicativo.

10. Onde devo inserir o Client ID e o Secret Key?

→ Após configurar os Canais Abertos, cole o Client ID e o Secret Key copiados nas configurações do aplicativo WATI no Marketplace.

Mensagens do WhatsApp e integração com o CRM

11. Posso enviar mensagens do WhatsApp a partir do Bitrix24?

→ Sim, é possível enviar mensagens do WhatsApp usando templates aprovados pelo WATI em fluxos de trabalho ou campanhas de marketing.

12. Como as mensagens recebidas do WhatsApp são tratadas no Bitrix24?

→ As mensagens são automaticamente vinculadas ao lead/contato correspondente e armazenadas nos Canais Abertos do Bitrix24.

13. Novas mensagens do WhatsApp criam contatos automaticamente?

→ Sim, as mensagens recebidas podem acionar a criação automática de leads/contatos, evitando entradas duplicadas.

Templates de mensagens e campanhas

14. Como sincronizar os templates do WATI com o Bitrix24?

→ Abra o aplicativo WATI no Marketplace do Bitrix24 e clique em Sincronizar Templates.

15. Como enviar mensagens com template via fluxo de trabalho?

No CRM do Bitrix24, acesse Fluxos de Trabalho → Atividades de Aplicação → [Wati API] Enviar Mensagem com Template.
Insira o número de telefone do cliente e os detalhes do template do WATI.
Clique em Enviar.

16. Como devo formatar os parâmetros dos templates em fluxos de trabalho?

Utilize chaves {} para as variáveis.
Insira os parâmetros na mesma ordem em que aparecem no template do WATI.
Se os campos forem deixados em branco, as chaves e valores padrão do template serão utilizados.

17. Posso enviar campanhas em massa do WhatsApp a partir do Bitrix24?

→ Sim, é possível enviar campanhas pelo Menu de Marketing no CRM do Bitrix24.

18. Como configurar uma campanha do WhatsApp no Bitrix24?

Acesse Marketing → Campanha.
Selecione SMS Campaign como o tipo.
Escolha o WATI como provedor e insira os nomes dos templates.
Agende e inicie sua campanha.

19. Como acompanhar a entrega das campanhas do WhatsApp?

→ O status da entrega está disponível na página de Listagem de SMS Campaign.

Webhooks e automação

20. O que são webhooks e por que devo usá-los?

→ Os webhooks permitem atualizações em tempo real para mensagens recebidas e status de entrega de mensagens.

21. Como configurar webhooks no WATI?

Acesse o WATI.
Vá em Mais → Webhooks → Adicionar Webhook.
Insira as URLs dos webhooks para mensagem recebida, enviada e status de entrega.
Selecione os tipos de eventos e ative o webhook.

22. Como testar se meus webhooks estão funcionando?

→ Após a configuração, envie uma mensagem de teste e verifique se os dados foram recebidos corretamente no Bitrix24.

Integração do Wati com o Bitrix24