Why notifications matter
ChatKit lead alerts and team mentions notify your agents inside Chatwoot — but only if notifications are enabled in each agent's profile. This guide makes sure you never miss a lead.
Turn on push notifications (per agent)
- Log in to Chatwoot as the agent.
- Click your avatar (top-right) → Profile settings.
- Open the Notifications tab.
- Under Push notifications, click Enable push notifications and accept the browser prompt.
- Tick the events you want to be notified about — especially @mentions and Conversation assignment.
- Set your Notification sound and Email notifications preferences to taste.
That's it — your browser/desktop will now alert you the moment a lead submits a form and ChatKit posts the mention.
How ChatKit lead alerts work
When a visitor completes a form in a ChatKit bot flow:
- ChatKit posts a private note into the conversation with the collected answers.
- If the inbox has a Mention team configured (Settings → Leads & Alerts), the note includes a team mention — every member of that team gets a Chatwoot notification.
- The conversation is also tagged with the intent (e.g. Support, Refund) and the contact is enriched with the form data.
Troubleshooting
- I don't get mention notifications — confirm push notifications are enabled in your profile (above) and that you're a member of the mentioned team.
- The mention shows as plain text — make sure the team name in ChatKit Settings → Leads & Alerts → Mention team matches the exact Chatwoot team name.
- No alert at all — check the inbox's Notify agents on new leads toggle is ON.