# Integração Chatwoot

**🚧 INTEGRAÇÃO BETA - Sistema de integração com Chatwoot para atendimento unificado**

**⚠️ AVISO**: Esta integração está em fase BETA. Use por sua conta e risco. Recomendamos testes em ambiente não-produtivo antes do uso em produção.

Esta categoria contém recursos para configurar e gerenciar a integração com o Chatwoot, uma plataforma de atendimento ao cliente open-source. A integração permite centralizar conversas do WhatsApp no Chatwoot.

### Recursos disponíveis:
- 🔧 **Configuração Completa**: Configure URL, tokens e credenciais do Chatwoot
- 📬 **Sincronização Bidirecional**: Mensagens novas entre WhatsApp e Chatwoot são sincronizadas automaticamente
- 📱 **Gerenciamento de Contatos**: Sincronização automática de nomes e telefones
- 🔄 **Atualização LID→PN**: Migração automática de Local ID para Phone Number
- 🏷️ **Nomes Inteligentes**: Sistema de nomes com til (~) para atualização automática
- 🚫 **Separação de Grupos**: Opção para ignorar grupos na sincronização
- 👤 **Assinatura de Mensagens**: Identificação do agente nas mensagens enviadas
- 🔗 **Webhook Automático**: URL gerada automaticamente para configurar no Chatwoot

### 🏷️ Sistema de Nomes Inteligentes:
- **Nomes com til (~)**: Atualizados automaticamente quando contato modifica nome no WhatsApp
- **Nomes específicos**: Para nome fixo, remover til (~) do nome no Chatwoot
- **Exemplo**: "~João Silva" = automático, "João Silva" = fixo
- **Migração LID→PN**: Sem duplicação de conversas durante a transição
- **Respostas nativas**: Aparecem diretamente no Chatwoot sem marcações externas

### ⚠️ Limitações conhecidas:
- **Sincronização de histórico**: Não implementada - apenas mensagens novas são sincronizadas

### Casos de uso:
- Atendimento centralizado no Chatwoot
- Equipes de suporte com múltiplos agentes
- Integração com CRM via Chatwoot
- Centralização de canais de comunicação
- Gestão automática de contatos e nomes

**Ideal para**: Empresas com equipes de atendimento, call centers, suporte técnico (em ambiente de testes)

**Requer**: Instância do Chatwoot configurada, tokens de API e ambiente de testes

**🚧 Lembre-se**: Integração em BETA - funcionalidades podem mudar sem aviso prévio