[GOWS] [Chatwoot] - Brazilian Number Normalization Causing Contact Duplication in Chatwoot

[Jaya-Braga]

Description

Since updating to WAHA 2025.9.6, the automatic normalization of Brazilian phone numbers (adding the 9th digit) is causing contact duplication in Chatwoot integration.

Steps to Reproduce

1. Have an existing contact in Chatwoot without the 9th digit (e.g., 551187654321) - number as originally registered in WhatsApp
2. Update WAHA to version 2025.9.6 or higher
3. Receive a new message from this contact
4. WAHA automatically normalizes the number by adding the 9th digit (5511987654321)
5. Chatwoot doesn't recognize it as the same contact and creates a new duplicate record with the normalized number

Expected Behavior

WAHA should check if a contact already exists in Chatwoot (with or without the 9th digit) before creating a new one, or at minimum, provide a configuration option to control this normalization behavior for Chatwoot integration.

Current Behavior

Every message received after the 2025.9.6 update creates duplicate contacts for numbers that already existed in Chatwoot without the 9th digit. This results in:

• Duplicate contacts in the database
• Fragmented conversation history
• Confusion for support agents
• Issues with automations that depend on unique contact identifiers

Environment

• WAHA Version: 2025.9.6, 2025.9.7, 2025.9.8, 2025.10.0 (issue persists across all versions)
• Engine: GOWS
• Integration: Native WAHA App to Chatwoot
• Chatwoot Version: Mega 4.7.0

Proposed Solutions

Option 1: Pre-check Before Contact Creation (Recommended)

Before creating a new contact in Chatwoot, WAHA could check if a contact already exists with either format:

• Original format: 551187654321
• Normalized format: 5511987654321

If found, use the existing contact ID instead of creating a new one.

Option 2: Configuration Flag

Add a configuration option to control Brazilian number normalization behavior:

WAHA_CHATWOOT_NORMALIZE_BR_NUMBERS: true/false

This would allow users to disable normalization if they already have an established contact base.

Option 3: Bidirectional Matching

Implement a matching algorithm in the Chatwoot webhook handler that:

1. Receives the normalized number from WhatsApp
2. Queries Chatwoot for contacts with both number formats
3. Returns the existing contact if found in either format
4. Only creates a new contact if neither format exists

Option 4: Migration Script

Provide a migration script/endpoint that:

1. Identifies duplicate contacts (same number with/without 9th digit)
2. Merges conversation history
3. Updates references to use a single contact ID
4. Removes duplicates

Technical Context

The Brazilian 9th digit was introduced in mobile numbers years ago, but many existing WhatsApp contacts still use the old 8-digit format in their registration. WAHA's normalization is technically correct for current standards, but it breaks backward compatibility with existing Chatwoot contact databases.

Additional Notes

I've also reported this to Chatwoot, but since the normalization happens on WAHA's side before sending to Chatwoot, it might be more efficient to handle this in WAHA's integration layer.

Would appreciate any guidance on:

• Whether this is considered a bug or expected behavior
• If there's a workaround available
• Timeline for a potential fix
• If you'd accept a PR addressing this issue

Impact: High - Affects all Brazilian users with existing Chatwoot databases after WAHA updates

[github-actions]

Portuguese

---

Title: [GOWS] [Chatwoot] - Normalização de números brasileiros causando duplicação de contatos no Chatwoot

Descrição

Desde a atualização para WAHA 2025.9.6, a normalização automática dos números de telefone brasileiros (adicionando o 9º dígito) está causando duplicação de contatos na integração do Chatwoot.

Etapas para reproduzir

1. Ter um contato existente no Chatwoot sem o 9º dígito (por exemplo, 551187654321) - número originalmente registrado no WhatsApp
2. Atualize o WAHA para a versão 2025.9.6 ou superior
3. Receba uma nova mensagem deste contato
4. WAHA normaliza automaticamente o número adicionando o 9º dígito (5511987654321)
5. Chatwoot não o reconhece como o mesmo contato e cria um novo registro duplicado com o número normalizado

Comportamento esperado

WAHA deve verificar se já existe um contato no Chatwoot (com ou sem o 9º dígito) antes de criar um novo, ou no mínimo, fornecer uma opção de configuração para controlar este comportamento de normalização para integração do Chatwoot.

Comportamento Atual

Cada mensagem recebida após a atualização 2025.9.6 cria contatos duplicados para números que já existiam no Chatwoot sem o 9º dígito. Isso resulta em:

• Contatos duplicados no banco de dados
• Histórico de conversas fragmentado
• Confusão para agentes de suporte
• Problemas com automações que dependem de identificadores de contato exclusivos

Ambiente

• Versão WAHA: 2025.9.6, 2025.9.7, 2025.9.8, 2025.10.0 (o problema persiste em todas as versões)
• Motor: GOWS
• Integração: Aplicativo WAHA nativo para Chatwoot
• Versão do Chatwoot: Mega 4.7.0

Soluções propostas

Opção 1: pré-verificação antes da criação do contato (recomendado)

Antes de criar um novo contato no Chatwoot, WAHA pode verificar se já existe um contato com qualquer formato:

• Formato original: 551187654321
• Formato normalizado: 5511987654321

Se for encontrado, use o ID de contato existente em vez de criar um novo.

Opção 2: Sinalizador de configuração

Adicione uma opção de configuração para controlar o comportamento de normalização de números brasileiros:

WAHA_CHATWOOT_NORMALIZE_BR_NUMBERS: verdadeiro/falso

Isso permitiria que os usuários desabilitassem a normalização se já tivessem uma base de contatos estabelecida.

Opção 3: correspondência bidirecional

Implemente um algoritmo de correspondência no manipulador de webhook do Chatwoot que:

1. Recebe o número normalizado do WhatsApp
2. Consulta Chatwoot para contatos com ambos os formatos de número
3. Retorna o contato existente se encontrado em qualquer formato
4. Só cria um novo contato se nenhum formato existir

Opção 4: script de migração

Forneça um script/endpoint de migração que:

1. Identifica contatos duplicados (mesmo número com/sem 9º dígito)
2. Mescla o histórico de conversas
3. Atualiza as referências para usar um único ID de contato
4. Remove duplicatas

Contexto Técnico

O 9º dígito brasileiro foi introduzido nos números de celular há anos, mas muitos contatos existentes do WhatsApp ainda usam o antigo formato de 8 dígitos em seu cadastro. A normalização da WAHA é tecnicamente correta para os padrões atuais, mas quebra a compatibilidade retroativa com os bancos de dados de contatos Chatwoot existentes.

Notas Adicionais

Também relatei isso ao Chatwoot, mas como a normalização acontece do lado do WAHA antes de enviar para o Chatwoot, pode ser mais eficiente lidar com isso na camada de integração do WAHA.

Agradeceríamos qualquer orientação sobre:

• Se isso é considerado um bug ou um comportamento esperado
• Se houver uma solução alternativa disponível
• Cronograma para uma possível correção
• Se você aceitar um PR abordando esse problema

Impacto: Alto - Afeta todos os usuários brasileiros com bancos de dados existentes do Chatwoot após atualizações do WAHA

[devlikepro]

Too complex, merge contacts using chatwoot interface after it happens

[github-actions]

Portuguese

---

Title:

Muito complexo, mescle contatos usando a interface chatwoot depois que isso acontecer