# Intercom

:::tip Available
This integration is available in Frihet. Configure it in **Settings → Integrations → Intercom**.
:::

Connect your Intercom account to Frihet to import your contacts as clients. If you use Intercom to communicate with your users and manage support, this integration allows you to bring those contacts into Frihet to invoice them, without having to duplicate data between your communication platform and your ERP.

## What it does

- **Import contacts as clients** — Intercom contacts become Frihet clients with name, email, phone, and company
- **Bridge between support and invoicing** — Go from a support conversation to creating an invoice without re-entering data
- **Updated client base** — Bring contacts you already have registered in Intercom into Frihet
- **Automatic deduplication** — Already imported contacts are not duplicated in subsequent imports

## Requirements

- Active account in [Intercom](https://www.intercom.com)
- Frihet Pro or Premium plan
- Intercom Access Token (generated from Developer Hub)

## How to connect

### Step 1: Get your Access Token in Intercom

1. Log in to [app.intercom.com](https://app.intercom.com)
2. Go to **Settings** (gear icon)
3. Navigate to **Integrations → Developer Hub**
4. If you don't have an app created, click on **New app** and give it a name like "Frihet ERP"
5. Inside the app, go to the **Authentication** section
6. Copy the **Access Token** displayed

:::caution Note
The Access Token grants access to your Intercom workspace data. Store it securely and do not share it.
:::

### Step 2: Configure in Frihet

1. In Frihet, go to **Settings → Integrations**
2. Search for **Intercom** and click on the card
3. Paste your **Access Token** in the corresponding field
4. Click on **Test connection** to verify
5. If the connection is successful, click on **Save**

## How it works

Frihet connects to the Intercom API using your Access Token with Bearer authentication. When you initiate an import, Frihet queries the contacts registered in your Intercom workspace and creates them as clients in Frihet.

The import is on-demand. Both leads and registered users in Intercom are imported. Already imported contacts are identified by their Intercom ID and are not duplicated.

### Data mapping

| Data in Intercom | Field in Frihet |
|------------------|-----------------|
| Name | Client name |
| Email | Client email |
| Phone | Client phone |
| Company name | Client company |

## Use cases

### SaaS with Intercom support

Your users communicate with you via Intercom chat. When a user wants to upgrade to a paid plan or needs an invoice, you import their contact into Frihet and create the invoice with the correct data without asking for it again.

### Agency with clients in Intercom

You use Intercom to manage communication with your clients. Instead of maintaining two separate databases (one in Intercom and another in Frihet), you import contacts and maintain a single source of truth for invoicing.

### Company migrating to Frihet

You already have a consolidated contact base in Intercom. By connecting the integration, you can bring all those contacts into Frihet at once and start invoicing without wasting time on manual data entry.

## Troubleshooting

### Connection error

- Verify that the Access Token is correct and corresponds to your workspace
- Check that the app in Developer Hub has not been deleted or deactivated
- If you regenerated the token, update it in Frihet — the old one will stop working

### Contacts are not imported

- Make sure you have contacts registered in Intercom (leads or users)
- Contacts without a name or email are skipped during import
- Verify that the Access Token has read permissions for contacts

### Incomplete data

- Only fields that have data in Intercom are imported
- If a contact does not have a phone or associated company, those fields will remain empty in Frihet
- You can complete the data manually in Frihet after the import

## Next steps

- [Connect HubSpot as a CRM alternative](./hubspot)
- [Connect Pipedrive for pipeline management](./pipedrive)
- [Manage your clients in Frihet](../clientes/gestion-clientes)
---