Blog · Integração

Chatwoot nativo na GoZAP: atendimento humano e automação no mesmo fluxo.

A integração nativa GoZAP + Chatwoot conecta seu bot de automação ao painel de atendimento humano. Handoff automático, histórico unificado e retomada da automação após o atendimento.

GoZAPIntegração8 min de leitura

Automação resolve 80% dos atendimentos. O problema é o outro 20% — os casos que precisam de um humano. A integração GoZAP + Chatwoot resolve isso: o bot atende, detecta a necessidade de escalonamento e transfere para um agente humano no Chatwoot, com todo o histórico de conversa já carregado.

Quando o agente resolve o caso e marca a conversa como resolvida, a automação retoma automaticamente — sem precisar de um novo trigger. O ciclo completo acontece no mesmo número de WhatsApp, invisível para o cliente.

"O cliente não sabe que falou com um bot. Sabe apenas que foi atendido rápido e bem."
Como configurar
01
Conectando a instância GoZAP ao Chatwoot
Setup

No painel GoZAP, vá em Integrações → Chatwoot. Insira a URL da sua instância Chatwoot, o token de acesso da conta e selecione a caixa de entrada (inbox) de destino. O GoZAP cria automaticamente um canal WhatsApp nessa inbox.

Configuração via API
curl-X POST https://api.gozap.dev/instance/minha-instancia/chatwoot \-H"Authorization: Bearer {API_KEY}" \-d'{ "chatwootUrl": "https://app.chatwoot.com", "chatwootToken": "YOUR_CHATWOOT_USER_TOKEN", "accountId": 1, "inboxId": 3, "syncHistoryDays": 7 }'───────────────────────────────────────────────────── Canal WhatsApp criado na inbox #3 Histórico dos últimos 7 dias sincronizado
O que a integração sincroniza
Mensagens de texto, áudio, imagens e documentos
Status de leitura — confirmação de entrega no Chatwoot
Contatos — nome e número sincronizados automaticamente
Labels — etiquetas do Chatwoot aplicadas na conversa WA
02
Handoff automático: bot → agente humano
Handoff

Configure palavras-chave ou condições no seu bot para acionar o handoff. Quando detectado, o GoZAP pausa a automação naquela conversa e abre um ticket no Chatwoot, atribuindo ao agente disponível na fila configurada. O histórico aparece imediatamente no painel do agente.

Acionando handoff via API
# Pausar bot e escalar para atendente humanocurl-X POST https://api.gozap.dev/conversation/handoff \-H"Authorization: Bearer {API_KEY}" \-d'{ "instance": "minha-instancia", "phone": "5511999998888", "reason": "cliente_solicitou_humano", "teamId": 2, "priority": "high" }'───────────────────────────────────────────────────── Bot pausado para: 5511999998888 Ticket #4821 aberto — Fila: Suporte (Team 2)
03
Retomada da automação após atendimento
Retomada

Quando o agente resolve o ticket no Chatwoot (status "Resolvido"), o GoZAP detecta o evento via webhook do Chatwoot e reativa a automação para aquela conversa. Você define qual etapa do fluxo retomar — o início, um ponto específico, ou deixar inativo até a próxima mensagem do contato.

Webhook do Chatwoot → GoZAP
# Chatwoot envia este evento ao resolver o ticket# GoZAP intercepta e reativa automação{"event": "conversation.resolved","conversation": { "id": 4821, "status": "resolved" },"meta": { "phone": "5511999998888" }}# GoZAP reativa com a mensagem de encerramento configurada:"Seu atendimento foi concluído! Posso te ajudar com mais alguma coisa?"───────────────────────────────────────────────────── Automação reativada — próximo trigger aguardado
04
Relatórios unificados bot + humano
Analytics

O painel GoZAP consolida métricas de automação com as de atendimento humano do Chatwoot. Veja em tempo real quantas conversas estão com bot, quantas com agentes, tempo médio de resolução e taxa de escalamento por período.

GET /api/analytics/overview
{"period": "2026-08-29","totalConversations": 1842,"resolvedByBot": 1476, // 80.1%"escalatedToHuman": 366, // 19.9%"avgResolutionTime": {"bot": "1m 12s","human": "8m 43s" },"csat": 4.7}───────────────────────────────────────────────────── CSAT 4.7/5.0 — bot + humano integrados
O que você vê no dashboard unificado
Conversas ativas: bot vs. agente em tempo real
Taxa de escalamento por horário e agente
Tempo médio de primeira resposta (humano)
CSAT por canal e por agente individualmente
Integração nativa inclusa
Chatwoot + GoZAP sem configuração adicional

A integração Chatwoot está disponível em todos os planos GoZAP. Configure em 5 minutos no painel ou via API. Chatwoot self-hosted ou cloud — ambos são suportados.