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

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 — e o Sign out fica no rodapé da barra lateral.

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

  1. Clique em Add device e dê um nome (ex.: Atendimento).
  2. Clique em Pair no dispositivo criado — o QR aparece.
  3. 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ávelPara que serve
CHATWOOT_ENABLED / CHATWOOT_AUTO_CREATELiga a integração e a criação automática da caixa de entrada.
CHATWOOT_INBOX_NAMENome da caixa de entrada (padrão WhatsApp).
CHATWOOT_WEBHOOK_URL / CHATWOOT_WEBHOOK_SECRETEndereço e segredo que o Chatwoot usa para devolver a resposta do agente. Mantenha o segredo no lugar.
CHATWOOT_SIGN_MSGPrefixa a resposta com o nome do agente.
CHATWOOT_IMPORT_MESSAGESImporta o histórico recente da conversa ao parear (desligado por padrão).
DB_URI / DB_KEYS_URIOnde a sessão do WhatsApp é guardada (no disco do servidor, fora do release).
APP_BASIC_AUTHUsuá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

SintomaO que fazer
QR expira antes de lerEspere o próximo (renova na tela) ou clique em Pair de novo.
O painel pede “Connect to your gowa server”É a própria UI validando a conexão com a API: informe o usuário e a senha do APP_BASIC_AUTH. Acontece uma vez por navegador — no dia a dia a tela de login da Gestão Bem já basta.
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 ChatwootConfira 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 WhatsAppVerifique o webhook da caixa de entrada: ele precisa apontar para o GoWA com o ?secret= no fim.
Número bloqueado pelo WhatsAppRisco 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.