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

# Intercom

> Connect Intercom to manage customer conversations with Duckie

Connect Intercom to let Duckie handle customer conversations in your Intercom inbox.

## Capabilities

| Capability             | Supported                         |
| ---------------------- | --------------------------------- |
| **Knowledge Source**   | ✓ Sync help center articles       |
| **Deployment Trigger** | ✓ Respond to conversations        |
| **Tool Actions**       | ✓ Reply, tag, close conversations |

## Setup

### Connect via OAuth

1. Go to **Settings → Connections** in Duckie
2. Find **Intercom** and click **Connect**
3. You'll be redirected to Intercom to authorize
4. Grant Duckie access to your workspace
5. You'll be redirected back to Duckie

<Info>
  Duckie requests read and write access to conversations, contacts, and help center articles.
</Info>

## Using as a Knowledge Source

Sync your Intercom Help Center:

1. Go to **Train → Knowledge**
2. Click **Add Source**
3. Select **Intercom**
4. Choose which collections to sync
5. Click **Start Sync**

## Using as a Deployment Trigger

Deploy an agent to your Intercom inbox:

1. Go to **Deploy**
2. Click **Create Deployment**
3. Select your agent
4. Choose **Intercom** as the trigger
5. Configure events:
   * **New conversation** — When a customer starts a chat
   * **Customer reply** — When a customer responds

### Event Filters

* **Inbox**: Only conversations in specific inboxes
* **Tags**: Only conversations with specific tags

## Available Tools

| Tool                   | Description                      |
| ---------------------- | -------------------------------- |
| `intercom_reply`       | Send a reply to the conversation |
| `intercom_add_tag`     | Tag a conversation               |
| `intercom_close`       | Close the conversation           |
| `intercom_snooze`      | Snooze for later                 |
| `intercom_get_contact` | Get customer details             |

## Best Practices

### Route by Inbox

Use different agents for different inboxes:

* Sales inbox → Sales-trained agent
* Support inbox → Support-trained agent

### Use Intercom's Built-in Features Together

Duckie works alongside Intercom's features:

* Use Intercom's routing rules to direct conversations
* Duckie handles the actual response

## Troubleshooting

### "Conversation not found"

* The conversation may have been deleted or archived
* Check that Duckie has access to the correct workspace

### "Unable to send reply"

* Verify Duckie still has write permissions
* Re-authenticate if the connection shows errors