[Extension] How to monitor your chatbot flow errors with the Logs and error monitoring extension

1. Introduction

2. Features

3. Installation and configuration

4. How to analyze monitored errors

5. How to configure email alerts

6. Logs by contact

7. Support

Brief description: Monitor your chatbot flow errors in Blip, see which contacts were impacted, and receive email alerts to fix failures before they affect more users.

Introduction

The Logs and error monitoring extension records failures that occur while your chatbot flows are running in Blip. You can track each error in a single dashboard, with the technical message, the flow block where the failure occurred, and the list of affected contacts. This way, you can identify silent failures and take action before the problem happens again with other users.

For example, if an HTTP request block starts failing because an API went down, the error appears in the dashboard grouped with all occurrences from the last 7 days. You can see how many contacts were impacted, open the technical details of the failure, and receive an automatic email as soon as it happens.

Features

• Dashboard with flow errors grouped by type, showing the number of occurrences and a chart for the last 7 days.

• Technical details for each error: impacted contact, source bot, flow block, action type, user input, and execution time.

• CSV export of the contacts impacted by an error.

• Email alerts when an error occurs in the flow, with the option to send only for the first occurrence.

• Email alerts based on tracked events, filtered by category.

• Logs by contact tab for viewing the traces of a specific contact.

• Automatic monitoring of all connected bots when the extension is installed on a Router.

Supported on the following channels: all channels available on the Blip platform.

Installation and configuration

1. Activate the Logs and error monitoring extension in Blip Store and install it on the bot you want to monitor. If your operation uses a Router, install the extension on the Router to automatically monitor all bots connected to it.

2. In the bot dashboard, open the options menu (three-dot icon) to locate the installed extension.

3. Click the extension to open the monitoring dashboard. From this point on, the extension automatically starts recording flow errors, with no additional configuration required.

Attention: errors and logs are available for 7 days. After this period, the oldest records are automatically removed and no longer appear in the dashboard.

How to analyze monitored errors

The dashboard lists errors grouped by type. Each item displays the failure message, a chart showing the distribution of occurrences over the last 7 days, the total number of occurrences during the period, and the time when the error last occurred. Use the Refresh button to reload the list.

Click an error to expand the details of the latest occurrence. In this panel, you can view the impacted contact, date, source bot, flow block where the failure occurred, execution time, action type, and input sent by the user. The debug icon opens the complete action configuration in JSON format, which is useful for understanding the technical cause of the error.

Analyze each error by observing which block it occurs in, whether it is recurring, how many contacts were impacted, and whether any recent change to the flow may have caused the failure. With these details, you can determine whether the problem comes from a misconfigured condition in Builder, a failed HTTP request, or a variable that was not populated.

In the expanded panel, click Download CSV with impacted users to export the list of contacts affected by the error. Use the file to cross-reference the data with other information or trigger a recovery action for these contacts. To remove an error that has already been addressed, click Delete error.

How to configure email alerts

1. In the monitoring dashboard, click Manage alerts.

2. Fill in the Email to receive alerts field with the address that will receive the notifications.

3. Enable Enable error alerts to receive an email whenever an error occurs in the chatbot. Select Send only when the error appears for the first time to avoid repeated emails for the same error.

4. Enable Enable event-based alerts to be notified about specific events. Select the Event categories you want to monitor and, if desired, select the option to send only for the first occurrence.

5. Click Save. The alerts will apply to the next recorded errors and events.

Logs by contact

In the Logs by contact tab, you can view the history of a specific contact. Search by the contact ID or select one of the most recent contacts who chatted with the bot to view the traces recorded during the interaction. This helps you investigate an issue reported by a user without having to search for the error in the general dashboard.

Support

If you have questions during installation or error analysis, contact the Wiv support team by email at support@wiv.com.br.

Need more help? Explore our content on Blip Academy or Blip Community, watch tutorials on our YouTube channel, or get your questions answered through our support channel 😃