[WEBJS] [Chatwoot App] /api/contacts/check-exists fails with phone numbers containing '+' prefix when called from Chatwoot app

[alessandrovolpin]

Bug Report: /api/contacts/check-exists fails with phone numbers containing '+' prefix when called from Chatwoot App

Environment

• WAHA Version: 2025.9.8
• Engine: WEBJS
• Tier: PLUS
• Browser: Chromium 141.0.7390.54 (Debian GNU/Linux 12 bookworm)
• Integration: Chatwoot App enabled
• Session: WhatsApp session authenticated and connected

Description

The /api/contacts/check-exists endpoint consistently returns a 500 error when the phone number parameter includes the international prefix + (e.g., +39xxxxxxxxxx). This issue occurs specifically when messages are sent from the Chatwoot interface, which automatically formats phone numbers with the + prefix according to international standards.

Steps to Reproduce

1. Enable Chatwoot App integration in WAHA
2. Configure a Chatwoot inbox connected to a WAHA WhatsApp session
3. Send a message from Chatwoot interface to a number ( with or without + )
4. Chatwoot App calls /api/contacts/check-exists?phone=+39xxxxxxxxxx&session=SESSION_NAME
5. The endpoint fails with 500 error

Expected Behavior

The endpoint should successfully validate phone numbers with international prefix +, returning:

{
  "numberExists": true,
  "chatId": "39xxxxxxx@c.us"
}

OR

CHATWOOT App integration should convert the number removing the +

Actual Behavior

The endpoint returns a 500 error with a cryptic Puppeteer evaluation error:

{
  "statusCode": 500,
  "timestamp": "2025-10-09T09:42:20.532Z",
  "exception": {
    "message": "b",
    "name": "b",
    "stack": "b: b\n    at #evaluate (/app/node_modules/puppeteer-core/lib/cjs/puppeteer/cdp/ExecutionContext.js:391:56)\n    at async ExecutionContext.evaluate (/app/node_modules/puppeteer-core/lib/cjs/puppeteer/cdp/ExecutionContext.js:277:16)\n    at async IsolatedWorld.evaluate (/app/node_modules/puppeteer-core/lib/cjs/puppeteer/cdp/IsolatedWorld.js:100:16)\n    at async CdpFrame.evaluate (/app/node_modules/puppeteer-core/lib/cjs/puppeteer/api/Frame.js:364:20)\n    at async CdpPage.evaluate (/app/node_modules/puppeteer-core/lib/cjs/puppeteer/api/Page.js:822:20)\n    at async WPage.evaluate (/app/dist/core/engines/webjs/WPage.js:13:20)\n    at async WebjsClientPlus.getNumberId (/app/node_modules/whatsapp-web.js/src/Client.js:1583:16)\n    at async WhatsappSessionWebJSPlus.checkNumberStatus (/app/dist/core/engines/webjs/session.webjs.core.js:364:24)"
  },
  "request": {
    "path": "/api/contacts/check-exists?phone=%2B39xxxxxxxxxx&session=SESSION_NAME",
    "method": "GET",
    "query": {
      "phone": "+39xxxxxxx",
      "session": "SESSION_NAME"
    }
  },
  "version": {
    "version": "2025.9.8",
    "engine": "WEBJS",
    "tier": "PLUS",
    "browser": "/usr/bin/chromium"
  }
}

Test Results

❌ WITH + prefix (FAILS):

curl -X GET "http://localhost:3000/api/contacts/check-exists?phone=%2B39xxxxxxxxxx&session=SESSION_NAME" \
  -H "X-Api-Key: YOUR_API_KEY"

Result: 500 error with "b: b" Puppeteer evaluation error

✅ WITHOUT + prefix (WORKS):

curl -X GET "http://localhost:3000/api/contacts/check-exists?phone=39xxxxxxxxxx&session=SESSION_NAME" \
  -H "X-Api-Key: YOUR_API_KEY"

Result:

{"numberExists":true,"chatId":"39xxxxxxxxxx@c.us"}

Relevant Logs

[10:42:16.897] INFO (48): GET /api/contacts/check-exists?phone=%2B39xxxxxxxxxx&session=SESSION_NAME  {"app":"ChatWoot","component":"ChatWootInboxMessageCreatedConsumer","jobId":"7"}

[10:42:16.920] ERROR (48): GET 500 /api/contacts/check-exists {"statusCode":500,"timestamp":"2025-10-09T09:42:16.919Z","exception":{"message":"b","name":"b","stack":"b: b\n    at #evaluate (/app/node_modules/puppeteer-core/lib/cjs/puppeteer/cdp/ExecutionContext.js:391:56)...

[10:42:20.535] ERROR (48): API Error: Request failed with status code 500
Data: {
  "statusCode": 500,
  "timestamp": "2025-10-09T09:42:20.532Z",
  "exception": {
    "message": "b",
    "name": "b",
    "stack": "b: b\n    at #evaluate (/app/node_modules/puppeteer-core/lib/cjs/puppeteer/cdp/ExecutionContext.js:391:56)...

Impact

This bug breaks the Chatwoot integration because:

1. Chatwoot automatically formats phone numbers with + prefix (international standard)
2. Every message sent DIRECTLY TO A NUMBER from Chatwoot interface triggers this error
3. The error causes the Chatwoot consumer to fail processing messages
4. Messages cannot be properly delivered through the Chatwoot → WAHA → WhatsApp flow

Root Cause Analysis

The error "b: b" suggests that:

1. The phone number with + is being passed to Puppeteer's page.evaluate()
2. The + character is likely causing a JavaScript evaluation/parsing error in the WhatsApp Web context
3. The error is occurring in WebjsClientPlus.getNumberId() when trying to validate the number format

Workaround

Currently, the only workaround is to modify the calling code to strip the + prefix before making the API call. However, this is not feasible when using the Chatwoot App integration, as it's internal to WAHA.

Suggested Fix

The endpoint should sanitize the phone number parameter by:

1. Removing the + prefix before processing
2. Or properly escaping/encoding the + when passing to Puppeteer evaluation context
3. Or validating and normalizing phone number format in WhatsappSessionWebJSPlus.checkNumberStatus()

This should be handled in the WAHA codebase at:

• /app/dist/core/engines/webjs/session.webjs.core.js:364 (before calling checkNumberStatus)
• Or in the ChatWoot consumer before calling the API endpoint

Additional Context

• The issue is reproducible 100% of the time
• Session remains connected and authenticated; the issue is purely with the contact validation endpoint
• Other API endpoints work correctly

[github-actions]

Portuguese

---

Relatório de bug: /api/contacts/check-exists falha com números de telefone contendo o prefixo '+' quando chamado do aplicativo Chatwoot

Ambiente

• Versão WAHA: 2025.9.8
• Motor: WEBJS
• Nível: MAIS
• Navegador: Chromium 141.0.7390.54 (debian GNU/Linux 12 bookworm)
• Integração: aplicativo Chatwoot ativado
• Sessão: sessão do WhatsApp autenticada e conectada

Descrição

O endpoint /api/contacts/check-exists retorna consistentemente um erro 500 quando o parâmetro de número de telefone inclui o prefixo internacional + (por exemplo, +39xxxxxxxxxx). Esse problema ocorre especificamente quando as mensagens são enviadas da interface Chatwoot, que formata automaticamente os números de telefone com o prefixo + de acordo com os padrões internacionais.

Etapas para reproduzir

1. Habilite a integração do aplicativo Chatwoot no WAHA
2. Configure uma caixa de entrada Chatwoot conectada a uma sessão WAHA WhatsApp
3. Envie uma mensagem da interface Chatwoot para um número (com ou sem +)
4. O aplicativo Chatwoot chama /api/contacts/check-exists?phone=+39xxxxxxxxxx&session=SESSION_NAME
5. O endpoint falha com erro 500

Comportamento esperado

O endpoint deve validar com sucesso números de telefone com prefixo internacional +, retornando:

{
  "númeroExiste": verdadeiro,
  "chatId": "39xxxxxxx@c.us"
}

OU

A integração do aplicativo CHATWOOT deve converter o número removendo o +

Comportamento real

O endpoint retorna um erro 500 com um erro enigmático de avaliação do Puppeteer:

{
  "statusCode": 500,
  "carimbo de data/hora": "2025-10-09T09:42:20.532Z",
  "exceção": {
    "mensagem": "b",
    "nome": "b",
    "stack": "b: b\n em #evaluate (/app/node_modules/puppeteer-core/lib/cjs/puppeteer/cdp/ExecutionContext.js:391:56)\n em assíncrono ExecutionContext.evaluate (/app/node_modules/puppeteer-core/lib/cjs/puppeteer/cdp/ExecutionContext.js:277:16)\n em assíncrono IsolatedWorld.evaluate (/app/node_modules/puppeteer-core/lib/cjs/puppeteer/cdp/IsolatedWorld.js:100:16)\n em assíncrono CdpFrame.evaluate (/app/node_modules/puppeteer-core/lib/cjs/puppeteer/api/Frame.js:364:20)\n em assíncrono CdpPage.evaluate (/app/node_modules/puppeteer-core/lib/cjs/puppeteer/api/Page.js:822:20)\n em assíncrono WPage.evaluate (/app/dist/core/engines/webjs/WPage.js:13:20)\n em assíncrono WebjsClientPlus.getNumberId (/app/node_modules/whatsapp-web.js/src/Client.js:1583:16)\n em WhatsappSessionWebJSPlus.checkNumberStatus assíncrono (/app/dist/core/engines/webjs/session.webjs.core.js:364:24)"
  },
  "solicitar": {
    "path": "/api/contacts/check-exists?phone=%2B39xxxxxxxxxx&session=SESSION_NAME",
    "método": "OBTER",
    "consulta": {
      "telefone": "+39xxxxxxx",
      "sessão": "SESSION_NAME"
    }
  },
  "versão": {
    "versão": "2025.9.8",
    "motor": "WEBJS",
    "camada": "MAIS",
    "navegador": "/usr/bin/chromium"
  }
}

Resultados do teste

❌ COM prefixo + (FALHA):

curl -X GET "http://localhost:3000/api/contacts/check-exists?phone=%2B39xxxxxxxxxx&session=SESSION_NAME" \
  -H "X-Api-Key: YOUR_API_KEY"

Resultado: erro 500 com erro de avaliação do Puppeteer "b: b"

✅ SEM prefixo + (Funciona):

curl -X GET "http://localhost:3000/api/contacts/check-exists?phone=39xxxxxxxxxx&session=SESSION_NAME" \
  -H "X-Api-Key: YOUR_API_KEY"

Resultado:

{"numberExists":true,"chatId":"39xxxxxxxxxx@c.us"}

Registros relevantes

[10:42:16.897] INFO (48): GET /api/contacts/check-exists?phone=%2B39xxxxxxxxxx&session=SESSION_NAME {"app":"ChatWoot","component":"ChatWootInboxMessageCreatedConsumer","jobId":"7"}

[10:42:16.920] ERRO (48): GET 500 /api/contacts/check-exists {"statusCode":500,"timestamp":"2025-10-09T09:42:16.919Z","exception":{"message":"b","name":"b","stack":"b: b\n em #avaliar (/app/node_modules/puppeteer-core/lib/cjs/puppeteer/cdp/ExecutionContext.js:391:56)...

[10:42:20.535] ERRO (48): Erro de API: falha na solicitação com código de status 500
Dados: {
  "statusCode": 500,
  "carimbo de data/hora": "2025-10-09T09:42:20.532Z",
  "exceção": {
    "mensagem": "b",
    "nome": "b",
    "stack": "b: b\n em #evaluate (/app/node_modules/puppeteer-core/lib/cjs/puppeteer/cdp/ExecutionContext.js:391:56)...

Impacto

Este bug interrompe a integração do Chatwoot porque:

1. Chatwoot formata automaticamente números de telefone com prefixo + (padrão internacional)
2. Cada mensagem enviada DIRETAMENTE PARA UM NÚMERO da interface Chatwoot aciona este erro
3. O erro faz com que o consumidor Chatwoot falhe no processamento de mensagens
4. As mensagens não podem ser entregues corretamente através do fluxo Chatwoot → WAHA → WhatsApp

Análise de causa raiz

O erro "b: b" sugere que:

1. O número de telefone com + está sendo passado para page.evaluate() do Puppeteer
2. O caractere + provavelmente está causando um erro de avaliação/análise de JavaScript no contexto do WhatsApp Web
3. O erro está ocorrendo em WebjsClientPlus.getNumberId() ao tentar validar o formato do número

Solução alternativa

Atualmente, a única solução alternativa é modificar o código de chamada para remover o prefixo + antes de fazer a chamada da API. No entanto, isso não é viável ao usar a integração do Chatwoot App, pois é interno ao WAHA.

Correção sugerida

O endpoint deve limpar o parâmetro do número de telefone:

1. Removendo o prefixo + antes do processamento
2. Ou escapando/codificando adequadamente o + ao passar para o contexto de avaliação do Puppeteer
3. Ou validando e normalizando o formato do número de telefone em WhatsappSessionWebJSPlus.checkNumberStatus()

Isso deve ser tratado na base de código WAHA em:

• /app/dist/core/engines/webjs/session.webjs.core.js:364 (antes de chamar checkNumberStatus)
• Ou no consumidor ChatWoot antes de chamar o endpoint da API

Contexto Adicional

• O problema é reproduzível 100% do tempo
• A sessão permanece conectada e autenticada; o problema é puramente com o endpoint de validação de contato
• Outros endpoints da API funcionam corretamente

[devlikepro]

2025.10.1 - WEBJS - fix + in phone - #1475

[github-actions]

Portuguese

---

Title:

2025.10.1 - WEBJS - correção + no telefone - #1475