Gestão Bem · Atendimento

Conectar o WhatsApp pelo GoWA

O caminho alternativo ao app oficial da Meta: você conecta o número lendo um QR code, sem aprovação da Meta e sem custo por mensagem.

Atualizado em 22/09/2026 · GoWA (go-whatsapp-web-multidevice) + integração nativa com o Chatwoot

Antes de escolher este caminho O GoWA usa o WhatsApp Web (não oficial), então o número fica sujeito às regras da Meta — o risco de bloqueio existe e use um número dedicado, não o principal da empresa. Se compliance for inegociável, use o tutorial da API oficial.

1Como isso está montado

GoWA roda como um app do painel, em https://gowa.apps.gestaobem.com (com tela de login própria — a senha fica nas variáveis do app no Cleat).
A integração com o Chatwoot é nativa: o GoWA cria (ou reaproveita) a caixa de entrada WhatsApp e registra o webhook de resposta — não existe serviço intermediário.
A sessão do WhatsApp fica no disco do servidor, então o pareamento sobrevive a deploys e reinícios.

WhatsApp do cliente → GoWA (número pareado) → inbox “WhatsApp” no Chatwoot → agente responde → webhook volta pro GoWA → WhatsApp

2Entre no painel do GoWA

Acesse https://gowa.apps.gestaobem.com e informe a senha de acesso — a mesma do APP_BASIC_AUTH do app GoWA no painel (o usuário não é pedido).

Tela de login do painel do GoWA, com a marca Gestão Bem — A entrada é uma tela própria, com a cara da Gestão Bem — não aparece mais o popup de usuário e senha do navegador.

Depois de entrar você cai na tela de Devices, onde ficam os números conectados.

Painel do GoWA na tela Devices, com o dispositivo Atendimento e o botão Pair — O painel é o dashboard do GoWA: mensagens, chats, grupos e o gerenciamento dos dispositivos.

3Adicione o dispositivo e leia o QR code

Clique em Add device e dê um nome (ex.: Atendimento).
Clique em Pair no dispositivo criado — o QR aparece.
No celular do número: WhatsApp → Configurações → Aparelhos conectados → Conectar um aparelho e aponte para o QR.

Deu certo? O dispositivo sai de “not paired yet” para conectado, e o número aparece na lista. Cada QR expira em segundos e se renova sozinho na tela — se demorar para ler, é só clicar em Pair de novo (por isso o QR não vira print neste tutorial: ele é gerado na hora).

4Confira no Chatwoot

Nada precisa ser criado do lado do Chatwoot: ao subir, o GoWA registra a caixa de entrada. Em Configurações → Caixas de Entrada você deve ver a WhatsApp (canal API) — é nela que as conversas chegam.

Lista de caixas de entrada do Chatwoot com a caixa WhatsApp — A caixa “WhatsApp” é criada e reaproveitada automaticamente pelo GoWA.

Agora mande uma mensagem de outro celular para o número conectado: ela aparece em Conversas, com o contato criado automaticamente. A resposta do agente sai pelo WhatsApp — e, se você ligar a assinatura de agente, a mensagem chega prefixada com o nome de quem respondeu.

5O que dá para configurar

Tudo por variáveis do app, no painel do Cleat (valores novos valem no próximo deploy):

Variável	Para que serve
`CHATWOOT_ENABLED` / `CHATWOOT_AUTO_CREATE`	Liga a integração e a criação automática da caixa de entrada.
`CHATWOOT_INBOX_NAME`	Nome da caixa de entrada (padrão WhatsApp).
`CHATWOOT_WEBHOOK_URL` / `CHATWOOT_WEBHOOK_SECRET`	Endereço e segredo que o Chatwoot usa para devolver a resposta do agente. Mantenha o segredo no lugar.
`CHATWOOT_SIGN_MSG`	Prefixa a resposta com o nome do agente.
`CHATWOOT_IMPORT_MESSAGES`	Importa o histórico recente da conversa ao parear (desligado por padrão).
`DB_URI` / `DB_KEYS_URI`	Onde a sessão do WhatsApp é guardada (no disco do servidor, fora do release).
`APP_BASIC_AUTH`	Usuário e senha do painel: a senha é a digitada na tela de login e o par completo continua valendo para chamadas diretas na API.

6Problemas comuns

Sintoma	O que fazer
QR expira antes de ler	Espere o próximo (renova na tela) ou clique em Pair de novo.
Dispositivo cai / “not connected”	Abra o dispositivo e reconecte; se pedir QR, leia de novo. A sessão anterior fica no disco e evita parear do zero na maioria dos casos.
Mensagem não aparece no Chatwoot	Confira se a caixa de entrada existe e se o `CHATWOOT_WEBHOOK_SECRET` continua igual dos dois lados (basta um deploy para reaplicar).
Resposta do agente não sai no WhatsApp	Verifique o webhook da caixa de entrada: ele precisa apontar para o GoWA com o `?secret=` no fim.
Número bloqueado pelo WhatsApp	Risco inerente ao caminho não oficial. Evite disparos em massa e mantenha um número dedicado.

Precisa de outro número? Repita o passo 3 com um novo dispositivo (ex.: Financeiro): cada dispositivo pareado recebe um QR próprio, e todos entregam na mesma caixa de entrada — dá para filtrar pelo número depois, nas conversas.