> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Intercom App

> Install the official Intercom app to create or update Intercom users for your Dodo Payments customers and add a note for each payment, refund, and dispute.

## What the Intercom app does

The Intercom app creates or updates an Intercom user for each customer. It also adds a note to the user for each payment, refund, and dispute. The app has no map from a product to a tag and does not make companies.

## Before you start

* You are an owner or an admin of the Dodo Payments business.
* You have an Intercom workspace and an app in the Intercom Developer Hub with an access token.

## Install, connect, and configure

**1. Install the app**

Open **Apps**, then **Explore**. Open **Intercom** (publisher **Dodo Payments**) and select **Install app**.

![The Installed tab of Apps with Intercom in the list and the status Active](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/intercom-4.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=810130b39cf314888b25cf99a7b69d57)

**2. Connect Intercom**

Select **Connect**. In the Intercom Developer Hub, open your app, then **Authentication**, and copy the access token. Paste it in the **Access Token** field. Pick the **Region** of your workspace: leave it empty for the US, or pick `eu` for Europe or `au` for Australia. Select **Connect**.

![The Connect Intercom dialog with the Region and Access Token fields](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/intercom-3.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=6b092cbafe6b391fb7187fe38bbf7b44)

**3. Make the people data attributes (optional)**

To use **Write the Dodo custom attributes**, open **Settings**, then **Data**, then **People** in Intercom. Make three people data attributes of the type Text: `dodo_customer_id`, `dodo_subscription_status`, and `dodo_status_updated_at`. Intercom refuses an attribute that does not exist.

**4. Choose the settings**

Open the **Configure** tab, set the options, and select **Save**.

![The Configure tab of the Intercom app with the three setting switches and the Products filter](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/intercom-1.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=f09f6736bf550368485a0d3392fd395a)

**5. Pick the filters**

Pick the products and currencies, then select **Save**.

![The Intercom Configure tab with the Products and Currencies filters](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/intercom-2.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=2726f83428bacc54318dd5f5732d4085)

## Settings

| Setting | What it does | Default |
| - | - | - |
| Add customers as users | Create or update a user by email for each successful payment and each new or renewed subscription. The app writes the name. It writes the Dodo customer ID as the external ID of a user that has no external ID. | On |
| Write the Dodo custom attributes | Also write `dodo_customer_id`, `dodo_subscription_status`, and `dodo_status_updated_at`. The app writes the status when a subscription goes on hold, is cancelled, or expires. | Off |
| Add a note for payments, refunds and disputes | Add one note to the user for each successful payment, each successful refund, and each opened dispute. | On |
| Products | Send user data only for the products that you pick. The notes do not use this filter. | All |
| Currencies | Send data only for the currencies that you pick. | All |

## What is sent and when

Dodo Payments sends data after the Dodo Payments event happens. The app sends the email address, the name, and the Dodo customer ID of the customer. With **Write the Dodo custom attributes** on, it also sends the subscription status and the time. A note shows the event, the amount in the major unit with the currency code, the product names, and the Dodo ID. The app sends no card data and no address.

When no user exists, the app creates a user with only the email for a note. The app updates the name of an existing user at each payment. A name that you changed in Intercom changes back to the name in Dodo Payments. The app writes the external ID only to a user that has no external ID.

Two limits apply:

* The Intercom search can show a new contact some minutes late. A status event for a user that the app made a few seconds before can fail.
* Before it adds a note, the app looks for an earlier note of the same Dodo ID. It does not find a note when the contact has more than 200 notes. In this case, a retry can add a second note.

## Test the app

**1. Use test mode**

Install and connect the app in test mode.

**2. Make a test payment**

Create a test payment with a test customer email.

**3. Check Intercom**

Open **Contacts** in Intercom. The test customer appears. If notes are on, the user has a note for the payment.

## Troubleshooting

| Problem | What to do |
| - | - |
| The connection fails | Copy the access token again in the Intercom Developer Hub. Check that the **Region** is the region of your workspace. Intercom gives an error for a token that is not valid. |
| Intercom refuses the update after you turn on **Write the Dodo custom attributes** | Make the three people data attributes of the type Text in Intercom. |
| A status update fails for a new user | The Intercom search was late for a user that the app made a few seconds before. This is a known limit. |
| A user has the wrong name | The app writes the name of Dodo Payments at each payment. Change the name in Dodo Payments. |
| **Connection needs attention** | Intercom stopped accepting the credentials. Select **Reconnect** and enter new credentials. |
| No data arrives | Check that the setting switch is on and that the product and currency filters do not skip the event. Check that the customer has an email address. |

## Disconnect and uninstall

Turn off the settings on the **Configure** tab to stop sending data. Uninstall the app to delete the Intercom connection. See [Manage and uninstall](https://docs.dodopayments.com/features/app-marketplace/manage-and-uninstall.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.