[CHATWOOT] - Group messages: hide or replace the @lid code after the participant name

Open Beginner friendly
#2,369 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 5 days

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
77/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Domain
api, backend

Research direction

Start with apps/chatwoot/consumers/waha/base.js and trace how participant is passed into the whatsapp.group.message template; check how findPNByLid resolves a participant’s phone. Implement one of the listed formatting options while preserving the existing participant value for compatibility. Done when group messages can omit or replace an opaque @lid identifier and existing custom templates continue to work.

Written by the indexing model from the issue text.

Description

Is your feature request related to a problem? Please describe.

In the Chatwoot App, incoming group messages show the author as Name (identifier). Since WhatsApp moved group participants to LIDs, that identifier is now an opaque code, e.g.:

👥 Ana (138478520127698@lid)

For agents in Chatwoot the code is noise: it says nothing and makes every group message harder to read. Before LIDs it was the phone number, which was at least useful.

The format is hardcoded in apps/chatwoot/consumers/waha/base.js:

participant = `${name} (${participant})`;

and the whatsapp.group.message template only receives the combined participant string, so custom templates cannot change it.

Describe the solution you'd like

Any of these would solve it (the first one is the most flexible):

  1. Pass the parts to the template as separate variables (e.g. participantName, participantId, and participantPhone when the LID can be resolved with findPNByLid), keeping participant as it is today for backwards compatibility. Then each user can choose the format with the existing templates option.
  2. When the participant is a @lid and the phone number is known, show the phone instead of the LID: Ana (+34 600 000 000).
  3. An option to show only the name when it is available.

Describe alternatives you've considered

Patching the compiled file in our container, but it has to be reviewed on every WAHA update.

Additional context

WAHA 2026.9.2 (devlikeapro/waha:gows-arm), Chatwoot App with es-ES locale, Chatwoot 4.18.

Dominant language
TypeScript
Stars
7.6k
Forks
1.8k
Avg merge
4d 20h
Merged PRs (30d)
1

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from devlikeapro/waha

All issues in devlikeapro/waha

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.