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

# Integrations

> Connect external apps to supercharge your workspace with 100+ third-party tools

Trilo connects to the tools your team already uses—GitHub, Gmail, Slack, Shopify, and many more. Once connected, AI coworkers can interact with these services directly, and workflows can automate actions across them.

## Personal vs. workspace integrations

Trilo has two types of integrations, and they work differently:

| Type          | Who can use it          | Where it works             | Examples                          |
| ------------- | ----------------------- | -------------------------- | --------------------------------- |
| **Personal**  | Only you                | Your DMs with AI coworkers | Gmail, LinkedIn, Google Calendar  |
| **Workspace** | Anyone in the workspace | Project chats, workflows   | GitHub, Instagram, Shopify, Slack |

**Personal integrations** are yours alone. When you connect Gmail, only you can ask AI coworkers to read or send emails from your account.

**Workspace integrations** are shared. When someone connects GitHub to a workspace, anyone in that workspace can use it—though admins control which projects have access.

## Available integrations

### Personal integrations

| App                 | What AI can do                                      | Tools    |
| ------------------- | --------------------------------------------------- | -------- |
| **Gmail**           | Read, search, and send emails from your account     | 25 tools |
| **Google Calendar** | Check availability, create events, manage schedules | 28 tools |
| **LinkedIn**        | View connections, post updates, manage messages     | 20 tools |

### Workspace integrations

| App                   | What AI can do                              | Tools                 |
| --------------------- | ------------------------------------------- | --------------------- |
| **GitHub**            | Read repos, create issues/PRs, manage code  | Repository-level      |
| **Instagram**         | Post content, manage business accounts      | 15 tools              |
| **Slack**             | Send messages, read channels, post updates  | Team messaging        |
| **Linear**            | Create and manage issues                    | Project management    |
| **Shopify**           | Check orders, manage products and inventory | Store operations      |
| **WhatsApp Business** | Send and receive business messages          | Customer messaging    |
| **Outlook**           | Email and calendar for Office 365           | Microsoft integration |
| **Intercom**          | Manage support conversations                | Customer support      |

<Info>
  More integrations are added regularly. Check the integrations settings page for the current list.
</Info>

## Connecting an integration

### Personal integrations

<Steps>
  <Step title="Open settings">
    Click your avatar, then **Settings**.
  </Step>

  <Step title="Go to Integrations">
    Find the **Integrations** section and click the **Personal** tab.
  </Step>

  <Step title="Click Connect">
    Find the app you want and click **Connect**.
  </Step>

  <Step title="Authorize access">
    You'll be redirected to the app's login. Sign in and grant Trilo permission.
  </Step>

  <Step title="Start using it">
    Chat with an AI coworker in your DMs and ask it to use the connected app.
  </Step>
</Steps>

### Workspace integrations

<Steps>
  <Step title="Open workspace settings">
    Click **Settings** in the sidebar, then **Integrations**.
  </Step>

  <Step title="Click the Team tab">
    Switch to view workspace-level integrations.
  </Step>

  <Step title="Connect an app">
    Find the app and click **Connect**. You'll authorize via OAuth.
  </Step>

  <Step title="Configure access">
    For some integrations (GitHub, Instagram), you'll need to choose specific accounts or resources.
  </Step>

  <Step title="Assign to projects">
    Choose which projects can use this integration.
  </Step>
</Steps>

## Project-level access

Workspace integrations aren't automatically available everywhere. Admins assign integrations to specific projects:

1. Open the project you want to configure
2. Go to **Project Settings > Integrations**
3. Add the workspace integrations this project should access
4. Configure any app-specific settings

### Why project-level control?

* **Security**: Not every project needs GitHub access
* **Relevance**: Marketing projects don't need code repositories
* **Clarity**: AI coworkers only see relevant tools

## Configuring integrations

Some integrations need extra configuration after connecting:

### GitHub

After connecting, choose which repositories the workspace can access:

* Click **Configure** on your GitHub integration
* Select specific repositories or grant access to all
* Each project can be configured to access different repos

### Instagram

Select which business accounts are available:

* Connect your Instagram business or creator account
* Choose which accounts projects can post from
* Configure posting permissions per project

### WhatsApp Business

Set up phone numbers for messaging:

* Connect your WhatsApp Business account
* Select which phone numbers to enable
* Assign numbers to projects that need them

### Shopify

Configure store access:

* Connect your Shopify store
* Select which stores are available (if you have multiple)
* Projects can access product, order, and inventory data

## Using integrations with AI

Once connected, AI coworkers can use integrations naturally in conversation:

**In project chat (workspace integrations):**

```
You: Check if there are any open issues on our GitHub repo labeled "urgent"
AI: I found 3 open issues labeled urgent...
```

**In DMs (personal integrations):**

```
You: What meetings do I have tomorrow?
AI: Checking your Google Calendar... You have 3 meetings scheduled...
```

**In workflows:**

Workflows can use any integration assigned to their project. The AI automatically has access to the connected tools.

## Managing integrations

### Viewing connected apps

Go to **Settings > Integrations** to see all connections:

* **Personal tab**: Your individual connections
* **Team tab**: Workspace-level connections
* **Status**: Shows whether each integration is active

### Disconnecting

To remove an integration:

1. Find it in the integrations list
2. Click the menu icon (three dots)
3. Select **Disconnect**
4. Confirm the removal

<Warning>
  Disconnecting a workspace integration affects everyone. Workflows and AI coworkers will lose access to that app.
</Warning>

### Reconnecting

If an integration stops working (expired token, permission changes):

1. You'll see an error status on the integration
2. Click **Reconnect**
3. Re-authorize with the external app
4. Everything should work again

## Integration security

### What permissions do integrations request?

Each integration requests only the permissions it needs. You'll see exactly what's being requested during the OAuth flow.

### Who can see my data?

* **Personal integrations**: Only you and AI coworkers you chat with
* **Workspace integrations**: Project members can use them, but data access depends on the integration

### Can I revoke access?

Yes. Disconnect the integration in Trilo, and also revoke access from the connected app's settings (Google, GitHub, etc.) for extra certainty.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Integration shows 'disconnected' or 'error'">
    The connection may have expired or permissions changed. Click **Reconnect** to re-authorize.
  </Accordion>

  <Accordion title="AI can't access an integration in a project">
    The integration might not be assigned to that project. Check **Project Settings > Integrations** and add it.
  </Accordion>

  <Accordion title="Can't connect—OAuth keeps failing">
    Try:

    * Clearing browser cookies and cache
    * Using a different browser
    * Checking if pop-ups are blocked
    * Verifying your account has the right permissions on the external app
  </Accordion>

  <Accordion title="Workflow can't use integration">
    Make sure:

    * The integration is connected at the workspace level
    * The integration is assigned to the workflow's project
    * Any required configuration (repos, accounts) is set up
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Workflows" icon="play" href="/ai-coworkers/workflows">
    Use integrations in automated workflows.
  </Card>

  <Card title="AI coworkers" icon="robot" href="/ai-coworkers/overview">
    Chat with AI that can use your connected apps.
  </Card>
</CardGroup>