🔌 Integrações

Conecte o Chatwoot com suas ferramentas favoritas para criar um ecossistema completo.

📋 Integrações Disponíveis

Webhooks

Eventos em tempo real

OpenAI

ChatGPT integrado

Dialogflow

Google Chatbot

Slack

Notificações no Slack

Linear

Gestão de issues

WooCommerce

E-commerce

🎣 Webhooks

Webhooks enviam dados do Chatwoot para seu sistema em tempo real.

Configurar Webhook

“Configurações” → “Integrações” → “Webhooks”
“Novo Webhook”
Configure:

URL:

https://seu-sistema.com/chatwoot-webhook

Eventos: Escolha quais eventos enviar:

✅ Conversa criada
✅ Mensagem criada
✅ Conversa atualizada (status, atribuição)
✅ Contato criado/atualizado

Salvar

Payload Exemplo

Conversa criada:

{
  "event": "conversation_created",
  "id": 123,
  "inbox_id": 5,
  "contact": {
    "id": 456,
    "name": "João Silva",
    "email": "joao@empresa.com",
    "phone": "+5511987654321"
  },
  "messages": [],
  "status": "open",
  "created_at": "2025-01-17T10:30:00Z"
}

Mensagem criada:

{
  "event": "message_created",
  "conversation_id": 123,
  "message": {
    "id": 789,
    "content": "Olá, preciso de ajuda",
    "message_type": "incoming",
    "sender": {
      "id": 456,
      "name": "João Silva"
    },
    "created_at": "2025-01-17T10:31:00Z"
  }
}

Casos de Uso

1. CRM Sync:

Webhook: Contato criado
→ Criar/atualizar contato no Salesforce/HubSpot

2. Notificação Custom:

Webhook: Mensagem com palavra "urgente"
→ Enviar SMS para gerente

3. Analytics:

Webhook: Conversa resolvida
→ Registrar métrica no Google Analytics

4. Backup:

Webhook: Qualquer evento
→ Salvar em banco de dados externo

🧠 OpenAI (ChatGPT)

Integre ChatGPT para respostas inteligentes.

Configurar

Obtenha API Key em platform.openai.com
“Integrações” → “OpenAI”
Cole API Key
Escolha modelo:
- gpt-4 - Mais inteligente
- gpt-3.5-turbo - Mais rápido e barato
Configure prompt do sistema:

Você é um assistente de atendimento da {{empresa}}.
Seja educado, prestativo e profissional.

Informações sobre a empresa:
- Horário: Seg-Sex 9h-18h
- Produtos: A, B, C
- Política: [link]

Se não souber algo, diga "Vou verificar com um especialista".

Ativar

Modos de Uso

Captain (Piloto Automático):

IA responde diretamente o cliente
Use para: FAQ, qualificação, suporte simples

Copilot (Assistente):

IA sugere respostas para agente
Agente decide se usa ou edita

Recursos

✅ Resposta automática de perguntas
✅ Resumo de conversas longas
✅ Tradução automática
✅ Análise de sentimento do cliente
✅ Sugestão de labels automáticas

🤖 Dialogflow (Google)

Crie chatbots avançados com Dialogflow.

Configurar

Crie projeto no Google Cloud
Ative Dialogflow API
Crie Service Account e baixe JSON
No Chatwoot:
- “Integrações” → “Dialogflow”
- Project ID: cole o ID
- Credentials: upload do JSON
Ativar para inboxes desejados

Criar Intents

Intent 1: Saudação

Training Phrases:
- "Olá"
- "Oi"
- "Bom dia"

Response:
"Olá! Bem-vindo(a). Como posso ajudar?"

Intent 2: Horário

Training Phrases:
- "Qual o horário?"
- "Vocês abrem que horas?"
- "Horário de funcionamento"

Response:
"Nosso horário: Segunda a Sexta, 9h às 18h."

Handoff para Humano

Configure quando bot deve transferir:

// No fulfillment do Dialogflow
if (intent === 'falar_com_humano') {
  return {
    action: 'handoff',
    message: 'Transferindo para atendente...'
  }
}

💬 Slack

Receba notificações no Slack.

Configurar

Crie Slack App em api.slack.com
Ative Incoming Webhooks
Copie Webhook URL
No Chatwoot:
- “Integrações” → “Slack”
- Cole Webhook URL
- Escolha eventos para notificar

Notificações

💬 Nova conversa - WhatsApp

João Silva: "Preciso de ajuda urgente!"

Inbox: WhatsApp Suporte
Status: Aberto
Label: #urgente

[Ver conversa]

Responder do Slack

Configure Slack Integration avançada para:

✅ Responder conversas do Slack
✅ Atribuir conversas
✅ Mudar status

📝 Linear

Crie issues automaticamente a partir de conversas.

Configurar

Gere API Key no Linear
“Integrações” → “Linear”
Cole API Key
Escolha Team padrão

Criar Issue

Na conversa:
1. Cliente reporta bug
2. Agente clica "Criar Issue no Linear"
3. Preenche título e descrição
4. Issue criada com link da conversa

No Linear:
📋 Bug: Login não funciona
Descrição: Cliente João não consegue logar...
Link: chatwoot.com/app/conversations/123
Labels: bug, priority-high

Automação

Regra de Automação:
SE label = #bug
ENTÃO criar issue no Linear automaticamente

🛒 WooCommerce

Integre sua loja WooCommerce.

Configurar

No WordPress:
- Instale plugin Chatwoot for WooCommerce
- Ative e configure
No Chatwoot:
- “Integrações” → “WooCommerce”
- Cole Store URL e API Key

Recursos

Dados do Cliente:

Conversa com João Silva

💰 Valor total de compras: R$ 2.500
📦 Total de pedidos: 8
🛒 Último pedido: #5432 (R$ 350)
⭐ Produto favorito: Categoria X

Ações Rápidas:

📦 Ver pedidos do cliente
🔍 Rastrear pedido específico
💰 Gerar cupom de desconto
🛒 Ver carrinho abandonado

🌐 Tradutor do Google

Traduza conversas em tempo real.

Configurar

Ative Google Translate API
Gere API Key
“Integrações” → “Google Translate”
Cole API Key

Usar

Automático:

Cliente escreve em espanhol:
"Hola, necesito ayuda"

Agente vê traduzido:
"Olá, preciso de ajuda"

Agente responde em português:
"Olá! Como posso ajudar?"

Cliente recebe em espanhol:
"¡Hola! ¿Cómo puedo ayudar?"

Manual:

Botão "Traduzir" na conversa
→ Escolhe idioma de destino
→ Mensagem traduzida

🔗 Outras Integrações

Zapier/Make

Conecte com 3000+ apps:

Trigger: Nova conversa no Chatwoot
Action 1: Criar linha no Google Sheets
Action 2: Enviar notificação no Telegram
Action 3: Adicionar task no Asana

API Personalizada

Desenvolva suas próprias integrações:

# Criar conversa via API
POST /api/v1/accounts/{account_id}/conversations
{
  "inbox_id": 1,
  "contact_id": 123,
  "message": {
    "content": "Olá!",
    "message_type": "outgoing"
  }
}

📖 Docs completas: API Reference

📊 Painel de Aplicativos

Gerencie todas integrações:

📱 Painel de Aplicativos

Ativas (5):
├─ ✅ OpenAI - 450 usos/mês
├─ ✅ Webhooks - 2.3k eventos/mês
├─ ✅ Slack - Notificações ativas
├─ ✅ Linear - 23 issues criadas
└─ ✅ WooCommerce - 120 clientes sincronizados

Disponíveis para instalar (10+):
├─ 📧 Gmail
├─ 📊 Google Analytics
├─ 🎫 Zendesk
└─ [Ver todos]

💡 Melhores Práticas

Segurança

✅ API Keys secretas: Nunca exponha publicamente
✅ HTTPS sempre: Webhooks só em URLs seguras
✅ Valide payloads: Verifique assinatura de webhooks
✅ Limites de rate: Implemente rate limiting

Performance

✅ Cache: Não faça mesma requisição sempre
✅ Async: Processe webhooks assincronamente
✅ Retry: Implemente retry com backoff
✅ Monitor: Acompanhe falhas e latência

Governança

✅ Documente: O que cada integração faz
✅ Teste staging: Nunca direto em produção
✅ Versionamento: Mantenha controle de versões

​🔌 Integrações

​📋 Integrações Disponíveis

Webhooks

OpenAI

Dialogflow

Slack

Linear

WooCommerce

​🎣 Webhooks

​Configurar Webhook

​Payload Exemplo

​Casos de Uso

​🧠 OpenAI (ChatGPT)

​Configurar

​Modos de Uso

​Recursos

​🤖 Dialogflow (Google)

​Configurar

​Criar Intents

​Handoff para Humano

​💬 Slack

​Configurar

​Notificações

​Responder do Slack

​📝 Linear

​Configurar

​Criar Issue

​Automação

​🛒 WooCommerce

​Configurar

​Recursos

​🌐 Tradutor do Google

​Configurar

​Usar

​🔗 Outras Integrações

​Zapier/Make

​API Personalizada

​📊 Painel de Aplicativos

​💡 Melhores Práticas

​Segurança

​Performance

​Governança

​🚀 Próximos Passos

API Reference

Automações

🔌 Integrações

📋 Integrações Disponíveis

🎣 Webhooks

Configurar Webhook

Payload Exemplo

Casos de Uso

🧠 OpenAI (ChatGPT)

Configurar

Modos de Uso

Recursos

🤖 Dialogflow (Google)

Configurar

Criar Intents

Handoff para Humano

💬 Slack

Configurar

Notificações

Responder do Slack

📝 Linear

Configurar

Criar Issue

Automação

🛒 WooCommerce

Configurar

Recursos

🌐 Tradutor do Google

Configurar

Usar

🔗 Outras Integrações

Zapier/Make

API Personalizada

📊 Painel de Aplicativos

💡 Melhores Práticas

Segurança

Performance

Governança

🚀 Próximos Passos