> 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/website-mobile-app-bot/chatbot-settings/alerts.md). # Alerts This section contains essential information and usage guidelines for managing Alerts inside BotPenguin. ### What is Alerts? Alerts is a chatbot setting that notifies you by email whenever a new lead interacts with your chatbot. It allows you to configure the email subject, recipient addresses, and revisit notifications, and helps you stay on top of lead activity without needing to check the platform manually. *** ### When should you use this? Use this feature when: * You want to be notified by email whenever a new lead shares their phone number or email address with the chatbot * You need to route lead notifications to specific team email addresses * You are trying to track when a returning lead re-engages with the chatbot *** ### Benefits of Alerts * 🚀 Keeps your team instantly informed of new leads without checking the dashboard * ⏱️ Reduces the time spent manually monitoring chatbot conversations * 🎯 Improves lead follow-up speed with real-time email notifications * 🔄 Ensures no returning lead goes unnoticed with revisit alerts * 📈 Enhances lead management by routing notifications to the right inboxes *** ### Expected Outcome After setting this up: 1. You will receive an email notification whenever a lead shares a phone number or email address during a chatbot conversation 2. Your configured email addresses will get notified with the subject line you set 3. You will be notified when a lead revisits and interacts with the chatbot again (if enabled) {% hint style="info" icon="lightbulb" %} Tip: This is how your setup should function once completed. {% endhint %} *** ### Section A: How to use Alerts Settings 1. Go to the "Chatbot" section from the left sidebar.
2. Select your chatbot and click on "Settings."
3. Go to the Alerts tab.
*** ### Section B: Actions available in Alerts 1. Email Subject Field: 1. Enter the subject line for the email notifications. This will be the title of the email you receive when a new lead interacts with the chatbot.
2. Email Notifications Toggle: 1. Use this toggle to enable or disable email notifications. When enabled, you will receive an email whenever a new lead interacts with the chatbot.
{% hint style="info" icon="lightbulb" %} A lead is only captured — and only triggers an email notification — if the visitor has provided either a phone number or an email address during the conversation. If neither is shared, no notification is sent. {% endhint %} 3. Email Address Field: 1. Add the email addresses where you want to receive notifications. 2. You can add multiple email addresses by typing each one and pressing Enter.
4. Lead Revisit Notifications Toggle: 1. Enable this toggle to receive notifications when a lead revisits and interacts with the chatbot. 2. For example, if a lead interacts with the chatbot, leaves, and then returns later, you will receive a notification about their revisit.
5. Save Changes: 1. Click the Save Changes button to apply your settings. Your email notifications will now be active as per your configuration. *** ### Send Incomplete Responses This setting also affects when you receive email notifications, but it lives under Settings → General rather than the Alerts tab.
1. Send Incomplete Responses Toggle: 1. When enabled, you will receive email notifications even if the chatbot user hasn't finished the conversation. 2. This is useful if you want visibility into drop-offs or partially completed conversations, rather than only being notified once a conversation is fully complete. *** ### Best Practices > 💡 Use a clear, specific email subject line so notifications are easy to identify in a crowded inbox > ⚠️ Double-check every email address entered before saving — an incorrect address means missed lead notifications > 🚀 Enable Lead Revisit Notifications if your team follows up on leads over multiple touchpoints > 🎯 Pair Alerts with Send Incomplete Responses if you want visibility into drop-offs, not just completed conversations *** ### Troubleshooting
Not receiving any email notifications Confirm the "Email Notifications" toggle is enabled and at least one valid email address is added in the "Email Address" field.
Notifications missing for some leads Check whether the visitor shared a phone number or email — leads are only captured, and alerts only sent, when one of these is provided.
Not receiving revisit notifications Confirm the "Lead Revisit Notifications" toggle is enabled separately, as it does not turn on automatically with Email Notifications.
Not receiving alerts for incomplete conversations Enable "Send Incomplete Responses" under Settings → General — this is a separate toggle from the Alerts tab.
*** ### FAQs
Will I get an email notification if a lead only starts a conversation but shares no contact details? No. A notification is only triggered once the visitor provides a phone number or email address. A conversation with no contact details shared will not count as a captured lead.
Can I send Alert notifications to more than one email address? Yes. You can add multiple email addresses in the "Email Address" field by typing each one and pressing Enter.
Do I need to enable Send Incomplete Responses for Alerts to work? No, it's optional. Alerts works independently based on the Email Notifications toggle. Send Incomplete Responses (under Settings → General) is an additional setting that broadens when you get notified — including for conversations that weren't finished.
What counts as a "revisit" for Lead Revisit Notifications? A revisit is when a lead who has previously interacted with the chatbot leaves and then comes back to interact with it again. If Lead Revisit Notifications is enabled, you'll get a separate email for this re-engagement.
If I change the Email Subject after saving, does it apply to past notifications? No. Changing the Email Subject only affects notifications sent after you save the change — it does not update or resend past notifications.
*** ### Support If you still have questions for our team, write to us at . 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.