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

# App Integrations

> Connect 150+ apps to give your agents real-world capabilities.

## What are integrations?

Integrations connect your Sonara agents to external apps and services. Once connected, your agents can take real actions during conversations  - like creating a Salesforce lead, sending a Slack message, booking a Google Calendar event, or updating a spreadsheet.

## Available apps

Sonara supports **150+ app integrations** across popular categories:

| Category               | Examples                                |
| ---------------------- | --------------------------------------- |
| **Email**              | Gmail, Outlook                          |
| **Communication**      | Slack, Microsoft Teams, Discord         |
| **CRM**                | Salesforce, HubSpot, Pipedrive          |
| **Calendar**           | Google Calendar, Outlook Calendar       |
| **Project Management** | Asana, Monday.com, Jira                 |
| **Productivity**       | Google Sheets, Notion, Trello, Airtable |
| **E-commerce**         | Shopify, WooCommerce                    |
| **Support**            | Zendesk, Freshdesk, Intercom            |
| **Developer**          | GitHub, Jira, Linear                    |
| **And many more**      | Stripe, Zapier, Twilio, etc.            |

## Connecting an app

<Steps>
  <Step title="Open agent integrations">
    Navigate to your agent's configuration and find the **App Integrations** section.
  </Step>

  <Step title="Click Add Integration">
    Browse or search the app catalog. Each app shows its name, logo, and connection status.
  </Step>

  <Step title="Select tools">
    Choose which actions your agent should have access to. For example, for Gmail you might enable:

    * Send Email
    * Read Inbox
    * Search Messages

    Use **Select All** or pick individual tools. You can see the total count of selected tools.
  </Step>

  <Step title="Authenticate">
    Choose an authentication method and connect your account. See [Authentication methods](#authentication-methods) below.
  </Step>
</Steps>

## Authentication methods

Different apps support different ways to authenticate:

### OAuth (Connect yourself)

The most common method. Click **Authenticate**, sign in to the external service in a popup, and grant the requested permissions. The connection activates immediately.

### Share link

Generate a shareable authentication link for your customers or team members. Useful when the person who needs to authorize isn't the one setting up the agent.

* Links expire after **72 hours**
* Copy the link and share it via email or chat
* You can regenerate new links at any time
* The connection status updates automatically once the link is used

### API Key

Paste an API key directly. Use the **Test Connection** button to verify the key works before saving.

### Bearer Token

Paste a bearer token for token-based authentication.

### Basic Auth

Enter a username and password for services that use basic authentication.

## Managing integrations

### Viewing connected apps

The App Integrations section shows all connected apps with:

* App name and logo
* **Connection status**: Green "Connected" or Orange "Pending"
* **Auth method badge**: OAuth, API Key, Bearer, or Basic
* Delete button to remove the integration

### Updating tools

Click on any connected app to update which tools are enabled:

1. The tool configuration modal opens with your current selections
2. Toggle individual tools on or off
3. Use **Select All / Deselect All** for bulk changes
4. Click **Save Changes**

### Refreshing pending connections

If a connection shows as "Pending" (e.g., waiting for an OAuth popup to complete), click the **Refresh** button to check if authentication has been completed.

### Removing an integration

Click the **Delete** icon on any connected app. Confirm the deletion  - this removes the connection and the agent loses access to all tools from that app.

## Connection status

| Status      | Meaning                                                    |
| ----------- | ---------------------------------------------------------- |
| **Active**  | Authenticated and ready to use                             |
| **Pending** | Waiting for authentication to complete (e.g., OAuth popup) |
| **Expired** | Credentials have expired  - re-authenticate to restore     |

## How agents use integrations

During a conversation, the agent automatically decides when to use an integration based on the caller's request and the tool descriptions. For example:

> **Caller:** "Can you schedule a meeting for next Tuesday at 2pm?"
>
> **Agent:** Uses the Google Calendar integration to create the event, then confirms with the caller.

<Tip>
  Write clear descriptions for each tool so the agent knows exactly when to use it. For example: "Use this tool when the customer asks to schedule, reschedule, or cancel an appointment."
</Tip>

## Use cases

| Use case             | Apps & tools                                                                    |
| -------------------- | ------------------------------------------------------------------------------- |
| **Customer service** | Gmail (reply to emails), Zendesk (create tickets), Slack (notify team)          |
| **Sales**            | Salesforce (create leads), Google Calendar (book demos), HubSpot (update deals) |
| **HR**               | Google Sheets (update records), Slack (send notifications), Gmail (send offers) |
| **Support**          | Jira (create issues), Intercom (manage conversations), Notion (update docs)     |