Integração da Uzapi com o Chatwoot

Visão geral

A integração da Uzapi com o Chatwoot permite utilizar uma instância do WhatsApp da Uzapi como um canal de atendimento dentro do Chatwoot.

Observação: A integração deve ser configurada inicialmente pela equipe de infraestrutura responsável pelo Chatwoot, pois é necessário alterar uma variável no arquivo .env da aplicação.

A integração é compatível com o Chatwoot a partir da versão 4.10, podendo ser utilizada também em versões posteriores.

1. Configuração do .env do Chatwoot

Primeiramente, acesse o arquivo .env da instalação do Chatwoot.

Localize a variável:

WHATSAPP_CLOUD_BASE_URL=

Configure-a apontando para a URL base da Uzapi, incluindo o username da conta.

Exemplo

WHATSAPP_CLOUD_BASE_URL=https://api.uzapi.com.br/autotic

Importante: Substitua autotic pelo username correspondente à conta Uzapi que será utilizada na integração.

Após realizar a alteração, salve o arquivo .env.

2. Criar uma caixa de entrada do WhatsApp no Chatwoot

Após configurar o .env, acesse o painel do Chatwoot e crie uma nova Caixa de Entrada (Inbox) do tipo WhatsApp.

Preencha os campos solicitados com os dados da conta Uzapi.

Dados da integração

Após preencher todos os campos, clique em Criar Canal.

3. Configurar o Webhook

Após a criação do canal, o Chatwoot irá gerar uma URL de Webhook.

Copiar a URL

Copie a URL de Webhook fornecida pelo Chatwoot.

Em seguida, acesse o painel da Uzapi e navegue até:

Uzapi → Instância → Visualizar Instância → Configuração

Cole a URL do Webhook no campo correspondente e salve a configuração.

4. Desativar eventos de grupo

Atenção: Ao configurar a URL do Webhook do Chatwoot na Uzapi, é necessário desativar os eventos de grupo.

Essa configuração deve ser realizada na instância da Uzapi antes de concluir a integração.

5. Validação da integração

Após concluir todas as etapas:

1. O .env do Chatwoot deve estar configurado com a URL base da Uzapi.
2. A caixa de entrada do tipo WhatsApp deve estar criada no Chatwoot.
3. A URL de Webhook gerada pelo Chatwoot deve estar configurada na instância da Uzapi.
4. Os eventos de grupo devem estar desativados na Uzapi.

Com essas configurações concluídas, a integração entre Uzapi e Chatwoot estará configurada.

6. Vídeo de apoio

Em caso de dúvidas sobre o processo de configuração, consulte o vídeo:

Integrando a API de WhatsApp Uzapi ao Chatwoot