## 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)

1. Log in to Chatwoot as the agent.
2. Click your **avatar** (top-right) → **Profile settings**.
3. Open the **Notifications** tab.
4. Under **Push notifications**, click **Enable push notifications** and accept the browser prompt.
5. Tick the events you want to be notified about — especially **@mentions** and **Conversation assignment**.
6. 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:

1. ChatKit posts a **private note** into the conversation with the collected answers.
2. 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.
3. 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.