> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/bots/whatsapp-bot/whatapp-chatbot-settings/alerts-settings.md).

# Alerts Settings

### What is Alerts Settings?

Alerts is where you configure notifications for lead interactions with your chatbot. It lets you turn on email notifications for new leads, choose who receives them, and control when the lead's information actually gets sent out — whether that's an email, or any other integration connected to your bot.

***

### When should you use this?

Use this feature when:

* You want your team to know immediately when a new lead interacts with the bot
* You need lead information routed to specific email addresses, or to any connected integration (CRM, webhook, etc.)
* You want to be notified when a returning lead revisits and re-engages with the bot
* You want control over exactly when lead data is pushed out, rather than only at the very end of the conversation

***

### Benefits of Alerts Settings

* 🚀 Keeps your team instantly informed of new leads, without checking the Inbox manually
* ⏱️ Reduces delay between a lead engaging and your team acting on it
* 🎯 Gives you control over exactly when lead data is sent, not just whether it's sent
* 🔄 Ensures returning leads don't go unnoticed with revisit notifications
* 📈 Improves lead follow-up speed and conversion

***

### Expected Outcome

After setting this up:

* Your configured email addresses will receive a notification whenever a new lead interacts with the bot
* Any integration connected to receive lead data will get that data at the timing you chose
* You will be notified separately if a lead revisits and interacts with the bot again

{% hint style="info" icon="lightbulb" %}
Tip: This is how your setup should function once completed — lead information reaches your inbox and any connected integration at exactly the point in the conversation you configured, not before and not after.
{% endhint %}

***

### How to Use Alerts Settings

1. Choose your WhatsApp Chatbot, and go to "Settings" module. Then, go to the "Alerts" sub-tab.

<figure><img src="/files/VjMMqcPT0wdJU29xVRGF" alt=""><figcaption></figcaption></figure>

2. Enter your "Email Subject" — this becomes the title of the email you receive whenever a new lead interacts with the bot.

<figure><img src="/files/X8tFqTGV4l5qRZ2vxV9r" alt=""><figcaption></figcaption></figure>

3. Turn on the "Email Notifications" toggle to start receiving an email every time a new lead interacts with the bot.

<figure><img src="/files/ElhrbmlNTRQ8MZd6inZW" alt=""><figcaption></figcaption></figure>

4. Add the "Email Address" or addresses that should receive notifications — type each one and press Enter to add multiple.

<figure><img src="/files/F6TX82hsXUtlwRSzvYrC" alt=""><figcaption></figcaption></figure>

5. Turn on "Lead Revisit Notifications" to get notified when a lead who already interacted with the bot comes back and engages again.

<figure><img src="/files/fu4VsMh7iaQaMraMSCxS" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Example**: A lead chats with the bot, leaves, and returns three days later to ask another question — you get a separate notification for that revisit.
{% endhint %}

6. When to send Lead Info — controls when the lead's captured data is sent out, to email or any connected integration (CRM, webhook, etc.). Choose one:
   1. Beginning of the flow — sent as soon as the conversation starts; may be incomplete.
   2. 5 minutes later — sent 5 minutes in, giving the lead time to share more first.
   3. End of the flow — sent once the chatflow finishes, so the data is as complete as possible.

<figure><img src="/files/dv7SgOjHwdakS1DE0wl7" alt=""><figcaption></figcaption></figure>

7. Click "Save Changes" to apply your settings. Your email notifications and any connected integrations will now follow this configuration.

***

### Best Practices

> 💡 If you have an integration that expects complete lead data (like a CRM), choose "End of the flow" so partial data doesn't get sent.

> ⚠️ Choosing "Beginning of the flow" can send incomplete lead information if the lead drops off before finishing the conversation.

> 🚀 Use "5 minutes later" as a middle ground when you want faster alerts than end-of-flow, but more complete data than beginning-of-flow.

> 🎯 Add every team member who needs visibility into new leads as a separate email address, so no one has to forward notifications manually.

***

### Troubleshooting

<details>

<summary>Issue: I'm not receiving any email notifications for new leads.</summary>

**Solution:** Confirm the "Email Notifications" toggle is turned on and that at least one valid email address has been added and saved.

</details>

<details>

<summary>Issue: I'm not getting notified when a lead revisits.</summary>

**Solution:** Check that "Lead Revisit Notifications" is toggled on separately — this is independent of the main "Email Notifications" toggle.

</details>

<details>

<summary>Issue: My connected integration isn't receiving lead data at the time I expect.</summary>

**Solution:** Check the "When to send Lead Info" setting — this controls the timing for all destinations, not just email. If it's set to "Beginning of the flow" or "5 minutes later," the integration will receive data earlier than the end of the conversation.

</details>

***

### FAQs

<details>

<summary>Does "When to send Lead Info" only affect email notifications?</summary>

No. It controls when the lead's information is sent to any destination connected to receive it — email notifications as well as any other integration set up on the bot, such as a CRM or webhook.

</details>

<details>

<summary>What happens if a lead abandons the chat before the configured send time?</summary>

If "Beginning of the flow" is selected, whatever information was captured up to that point is sent. If "5 minutes later" or "End of the flow" is selected and the lead drops off before that point, the data sent will reflect whatever was captured before the lead left.

</details>

<details>

<summary>Can I add more than one email address to receive notifications?</summary>

Yes, type each email address in the Email Address field and press Enter to add multiple recipients.

</details>

<details>

<summary>Is Lead Revisit Notification the same as a new lead notification?</summary>

No. New lead notifications fire on the lead's first interaction. Lead Revisit Notifications fire separately, when that same lead comes back and interacts again.

</details>

<details>

<summary>Can I change the email subject line after setup?</summary>

Yes, update the Email Subject field at any time and click Save Changes to apply the new subject line to future notifications.

</details>

***

### Related Articles

{% content-ref url="/pages/Cq9bB7zQMzuTT8Cbm0s7" %}
[3rd Party Apps Integrations](/bots/whatsapp-bot/3rd-party-apps-integrations.md)
{% endcontent-ref %}

{% content-ref url="/pages/3DVnTj2hcOd0FvClt8U7" %}
[Inbox/Chats](/inbox-chats/inbox-chats.md)
{% endcontent-ref %}

{% content-ref url="/pages/6ttpiKsmzt3DBoquI8zO" %}
[Managing Custom Attribute](/settings/managing-custom-attribute.md)
{% endcontent-ref %}

***

### Support

If you still have questions for our team, write to us at **<support@botpenguin.com>**. We'll get back to you within 48 hours.

***

### 🎉 Completion

🎉 Congratulations, you have successfully completed this section! You're one step closer to mastering BotPenguin.