Resumo

A integração Wati Bitrix24 permite que as empresas se comuniquem perfeitamente com os clientes via WhatsApp diretamente na plataforma Bitrix24 CRM. Com esta integração, você pode:

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

Este guia explica o processo passo a passo para integrar o Wati com o Bitrix24.

Observação: Boletins informativos agora são Campanhas – mesmos recursos poderosos, nome atualizado!

Instruções

Requisitos de Acesso

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

Por que Integrar Bitrix24?

Principais Benefícios

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

Principais Recursos da Integração Bitrix24

Envie 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 a partir de fluxos de trabalho ou campanhas de marketing.
Mensagens Bidirecionais
- Receba e responda a mensagens de serviço diretamente dos Canais Abertos do Bitrix24.
Integração CRM
- As mensagens de entrada são automaticamente vinculadas ao lead/contato relevante no Bitrix24 CRM.
Integração de Canais Abertos
- Armazene todas as conversas de clientes e atribua-as a vários agentes em uma fila.
Criação Automática de Contatos
- Mensagens recebidas disparam a criação automática de lead/contato/negócio.
- Evite duplicações vinculando mensagens a contatos existentes.

Como Integrar Wati com Bitrix24

Etapa 1: Obtenha Credenciais de API do Wati

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

Etapa 2: Crie um Webhook de Entrada no Bitrix24

No Bitrix24, vá para Menu de Aplicações → 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 rotulado "Webhook para chamar a API REST".

Este webhook permitirá a comunicação perfeita entre Wati e Bitrix24.

Etapa 3: Configure o Wati no Bitrix24 Marketplace

Instale o Aplicativo Wati:
Primeiro, instale o aplicativo Wati do Bitrix24 Marketplace. Uma vez instalado, navegue até as configurações do aplicativo.
Insira os Detalhes da API e do Webhook:
Cole os seguintes detalhes em seus respectivos campos:
- Ponto de Extremidade da API Wati (copiado da Etapa 1)
- Token de Acesso (copiado da Etapa 1)
- URL do Webhook de Entrada Bitrix (copiado da Etapa 2)
- Salve suas configurações ao terminar.

Configuração do Canal Aberto

Para a configuração do canal aberto, você precisará criar uma nova aplicação nos Recursos do Desenvolvedor do Bitrix24. Veja como:

Faça login no Bitrix24 como Administrador
- Acesse seu aplicativo Bitrix24 e faça login como Administrador.
- No menu do lado esquerdo, 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 a Aplicação Local
- Escolha a opção Aplicação Local.

Na página de configuração do aplicativo, insira os seguintes detalhes:
- Caminho do Manipulador: https://apps.izaap.in/apps/wati/index2.php
- Caminho de Instalação Inicial: https://apps.izaap.in/apps/wati/install_open_channel.php
- Texto do Item de Menu (Inglês - en): Configuração de Aplicação do Canal Aberto Wati
Atribua as seguintes permissões:
- Conectores de mensageiros externos (imconnector)
- Canais Abertos (imopenlines)
Clique em Salvar na parte inferior da página.
Copie o ID do Cliente e a Chave Secreta
- Após salvar a configuração, copie o ID do Cliente da Aplicação e a Chave Secreta.
- Clique em Reinstalar na mesma página para instalar o aplicativo. Certifique-se de ver uma mensagem de sucesso.

Cole o ID do Cliente e a Chave Secreta no Wati Marketplace
- Volte para a página de índice do aplicativo Wati Marketplace.
- Cole o ID do Cliente e a Chave Secreta copiados em seus respectivos campos.

Acesse e Configure o Centro de Contato

Vá para a Página do Centro de Contato
- Navegue até a página do Centro de Contato: https://<seu-dominio>/services/contact_center/.
- Selecione a conexão Canal Aberto Wati.

Conecte e Configure o Canal Aberto Wati
- No menu suspenso do canal aberto, escolha Canal Aberto Wati e clique em Conectar.
- Após conectar, você pode usar este canal aberto para:
  - Receber mensagens de clientes via Wati.
  - Responder a mensagens diretamente no canal aberto.
- Use a opção Configurar no canal aberto para ajustar as configurações conforme necessário.
- Na página de configuração, selecione Wati como a origem do CRM no menu suspenso de origem.

Notas Importantes

Substitua <seu-dominio>: Certifique-se de substituir <seu-dominio> pelo seu domínio Bitrix24 real.
Teste a Integração: Após a configuração, teste a integração para garantir que as mensagens estejam fluindo corretamente entre Wati e Bitrix24.

Etapa 4: Sincronize Modelos Wati com Bitrix24

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

Etapa 5: Envie Mensagens de Modelo via Fluxo de Trabalho

No Bitrix24 CRM, vá para Fluxos de Trabalho → Atividades de Aplicação → [Wati API] Enviar Mensagem de Modelo.
Insira:
- Número de telefone do cliente.
- Nome do modelo Wati.
- Chave e valor do parâmetro do modelo.
Clique em Enviar.

Após enviar a mensagem, a resposta estará disponível na seção de resultados adicionais do fluxo de trabalho.

Observação Importante Sobre os Modelos Wati:

Nos modelos Wati, as variáveis de parâmetro são cercadas por chaves {}. Ao configurar seu fluxo de trabalho:
- Insira as variáveis de parâmetro do modelo no campo Chave do Parâmetro do Modelo.
- Especifique seus valores correspondentes na mesma ordem em que aparecem no modelo Wati.
Se você deixar os campos Chave do Parâmetro do Modelo e Valor em branco, o sistema usará automaticamente as chaves e valores definidos no modelo Wati.
A resposta do fluxo de trabalho incluirá detalhes como o status da mensagem, o número de telefone do destinatário e as informações do modelo Wati.

Etapa 6: Envie Campanhas de WhatsApp

Enviar campanhas de WhatsApp em massa para seus clientes é fácil com o Bitrix24 CRM. Siga estas etapas simples para configurar e lançar sua campanha:

Acesse o Menu de Marketing
- No Bitrix24 CRM, navegue até o menu Marketing.
- No menu superior, selecione Campanha.

Escolha o Tipo de Campanha
- Selecione Campanha de SMS como tipo de campanha.
- Escolha o modelo de WhatsApp que você deseja usar para sua campanha.

Configure a Campanha
- Especifique o tipo de provedor de SMS (escolha Wati ou seu provedor preferido).
- Crie um segmento de destino para sua campanha (por exemplo, um grupo específico de clientes).

Insira Nomes de 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 de sua conta Wati na seção Campanha e colá-los aqui.

Agende sua Campanha
- Salve os detalhes da campanha.
- Escolha a data e a hora para enviar sua campanha.
Monitore o Status de Entrega
- Após o envio da campanha, você pode monitorar o status de entrega na página Listagem de Campanhas de SMS.

Etapa 7: Configure Webhooks no Wati

Webhooks são uma maneira poderosa de acompanhar as mensagens recebidas dos clientes e monitorar o status das mensagens enviadas no Wati. Ao configurar webhooks, você garante que seu sistema permaneça atualizado em tempo real. Vamos seguir as etapas para configurar webhooks em sua conta Wati.

Guia Passo a Passo para Configurar Webhooks

Faça login na sua conta Wati:
Comece fazendo login na sua conta Wati. Se você ainda não tem uma conta, precisará criar uma primeiro.
Navegue até as Configurações de Webhooks:
Após fazer login, vá para o menu Mais, depois selecione Webhooks e clique em Adicionar Webhook.

Insira a URL do Webhook:

Você precisará inserir os seguintes URLs de webhook fornecidos abaixo. Certifique-se de substituir SEU DOMÍNIO BITRIX24 pelo URL real do seu portal Bitrix24.

URL do Webhook de Mensagem Recebida

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

URL do Webhook de Mensagem de Modelo Enviada/Falhou

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

URL do Webhook de Mensagem de Sessão Enviada

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

Selecione o Tipo de Evento:

Após inserir o URL do webhook, escolha o tipo de evento apropriado no menu suspenso. Isso garante que o webhook seja acionado para as ações corretas (por exemplo, mensagem recebida, mensagem enviada, etc.).

Ative o Webhook:

Certifique-se de selecionar a opção Ativado no menu suspenso para ativar o webhook.

Salve suas Configurações:

Assim que tudo estiver configurado, clique em Salvar para aplicar suas alterações.

Observações Importantes

Substitua Seu Domínio Bitrix24: Não se esqueça de substituir SEU DOMÍNIO BITRIX24 nos URLs do webhook pelo URL real do seu portal Bitrix24. Isso garante que os webhooks estejam corretamente vinculados ao seu sistema.

Teste Seus Webhooks: Após a configuração, é uma boa ideia testar os webhooks para garantir que eles estejam funcionando como esperado.

Perguntas Frequentes (FAQs)

Perguntas Gerais

1. O que é a integração entre Wati e Bitrix24?

Esta integração permite que você se comunique com clientes no WhatsApp diretamente do Bitrix24 CRM, incluindo o envio de mensagens de modelo, recebimento de respostas e gerenciamento de conversas.

2. Quais são as principais ações que posso realizar com esta integração?

Você pode enviar mensagens de modelo do WhatsApp aprovadas pela Meta, responder a mensagens de clientes, atribuir conversas a agentes e criar ou atualizar leads e contatos automaticamente.

3. Qual é a diferença entre boletim informativo e campanhas?

Boletim informativo agora é referido como "campanhas". A funcionalidade permanece a mesma; apenas o nome foi atualizado.

Requisitos de acesso e assinatura

4. Quais requisitos de assinatura são necessários para usar esta integração?

Você deve ter uma assinatura ativa do plano Wati Pro ou Business, e a integração está disponível apenas para clientes do plano Pro.

Recursos e gerenciamento de mensagens

5. A integração suporta mensagens bidirecionais?

Sim. Você pode receber e responder a mensagens de serviço do WhatsApp por meio dos Canais Abertos do Bitrix24.

6. Como as mensagens recebidas são vinculadas aos dados do CRM?

Todas as mensagens recebidas são automaticamente vinculadas aos leads ou contatos correspondentes no Bitrix24 CRM, ajudando a evitar registros duplicados.

Configuração e instalação

7. Alguma ação é necessária após concluir a configuração da integração?

Sim. Recomenda-se sincronizar os modelos Wati com o Bitrix24 e testar o envio e recebimento de mensagens para garantir que a integração esteja funcionando corretamente.

Webhook e sincronização

8. Por que é necessário configurar Webhooks?

Webhooks permitem que você receba mensagens de clientes em tempo real e rastreie o status das mensagens, garantindo que os dados permaneçam sincronizados entre Wati e Bitrix24.

Integrando o Wati com o Bitrix24