Messenger Bot Analytics

Once your bot is launched, there are lots of ways to collect valuable insights and analytics on how it is being used and what people on Messenger think about it.

Contents

Facebook Analytics (beta)

Facebook Analytics is a powerful tool for developers on all of Facebook's platforms to understand their audience and optimize their apps. It now supports Messenger Bots!

Using it, you can view detailed demographic info about your users. You can also log your own custom events. For a complete list of default app events and information on custom events, see App Events with Bots for Messenger.



Try it NowLearn More

Page Insights

You can also view your bot's Facebook page and check the Messages tab under Insights.

This is a good spot to check your spam and block rates. Keep them low by focusing on a good user experience!

Exporting Page Insights Data

You can export analytics data by navigating to App Analytics under Messenger. This is restricted to admins of the app.

Messaging Insights API

With the Messaging Insights API (provided via the Pages Insights API), you can programatically retrieve the same information that appears in the Page Insights tab of your Facebook Page. To retrieve one or more metrics, send a GET request to the /insights endpoint, and include a comma-separated list of metric names to retrieve:

curl -X GET "https://graph.facebook.com/v2.8/me/insights/?metric=<LIST_OF_METRICS>&access_token=<PAGE_ACCESS_TOKEN>"

The following Messenger-specific metrics are available. For more information, see the Messaging Insights API Reference.

MetricDescription

page_messages_active_threads_unique

Daily unique active conversations count.

page_messages_blocked_conversations_unique

The number of conversations with the Page that have been blocked.

page_messages_reported_conversations_unique

The number of conversations from your Page that have been reported by people for reasons such as spam, or containing inappropriate content.

page_messages_reported_conversations_by_report_type_unique

The number of conversations from your Page that have been reported by people for reasons such as spam, or containing inappropriate content. broken down by report type:

  • SPAM
  • INAPPROPRIATE
  • OTHER

page_messages_feedback_by_action_unique

Deprecated

page_messages_feedback_by_action_unique is deprecated as of November 7, 2017.

This metric will be removed in Graph API v2.12.

Please migrate your code to use our other Messaging Insights metrics, which provide comparable information.

Daily unique conversation counts broken down by user feedback actions, including

  • messaging turn-ons
  • messaging turn-offs
  • thread deletions
  • report spams
  • others

Ratings and Reviews

People can leave a 5-star review and provide freeform feedback on your bot from Manage > Leave Feedback.

App-level View

Ratings and reviews for all Messenger bots an app is associated with will be emailed to the app owner(s) daily. Ratings and reviews are also available in the developer console under Products > Messenger > Bot Ratings.

Page-level View

Reviews and ratings for Messenger bots are also available at a page-level in the 'Messenger Reviews' tab of Page settings. This is a convenient way for Page owners who do not have access to the Facebook app associated with their bot to see their ratings and reviews.

Integrating with Third-party Analytics Services

You may also consider integrating your existing analytics provider into your Messenger Bot.

Most analytics providers allow you to create server side events, these can then be used to measure retention, engagement, errors and other metrics that are important to your experience.