Intercom

Setup

1. Select the Intercom integration

2. Enter your context field

This is the field that you set in the context in your application with the user ID that is associated with your Intercom users. For example, if you are identifying users with Intercom with current_user.id, and you have current_user.id in the user_id field of your context, then enter user_id in this field.

3. Connect via OAuth

Select the “Connect OAuth” button and give access to our app.

4. Save

That’s it! You can test the integration by clicking “Test”. Otherwise, just save it and you’re ready to go.

What gets sent to Intercom

When an error occurs, Honeybadger sends an event for the affected user with the following payload:

Field	Value
event_name	encountered-error
user_id	The value from your configured context field (see step 2)
created_at	Unix timestamp in seconds since the epoch (UTC)
metadata	{ "url": "<link to the fault in Honeybadger>" }

You can use this event in Intercom to build segments (e.g. “users who hit an error in the last 7 days”) or to drive a Workflow that sets a custom attribute on the user; for example, flipping a has_honeybadger_error attribute to true whenever the event fires.