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

# Подключайте приложения (Google, Slack, HubSpot и другие)

> Дайте своим агентам реальные возможности — проверять календари, обновлять CRM, отправлять сообщения в Slack — в несколько кликов, без кода.

Подключения приложений позволяют голосовому агенту выполнять действия в инструментах, которые ваша команда уже использует, прямо во время разговора: проверять доступность в календаре, искать звонящего в CRM, добавлять лида в таблицу, публиковать сводку в Slack. Вы один раз подключаете аккаунт в разделе **Подключения → Приложения** (`/dashboard/app-connections`), выбираете, что агенту разрешено делать, и прикрепляете подключение к любому агенту в его конструкторе.

Сейчас доступно шесть приложений:

| Приложение          | Что ваш агент может делать с ним                                                  |
| ------------------- | --------------------------------------------------------------------------------- |
| **Google Calendar** | Просматривать доступность и управлять событиями календаря.                        |
| **Google Sheets**   | Добавлять сведения о лидах и результаты звонков в таблицу.                        |
| **Slack**           | Находить каналы, искать сообщения и публиковать сообщения при наличии разрешения. |
| **HubSpot**         | Находить контакты, обновлять записи и добавлять заметки.                          |
| **Salesforce**      | Искать записи, обновлять лиды и регистрировать действия.                          |
| **Cal.com**         | Проверять доступность и управлять бронированиями.                                 |

Для всего, чего нет в этом списке, создайте пользовательское
[API-подключение](/ru/guides/api-connections) или добавьте
[MCP-сервер](/ru/guides/mcp-servers).

## Подключите аккаунт

<Steps>
  <Step title="Откройте Подключения → Приложения и нажмите Добавить приложение">
    Откроется список из шести приложений. Можно подключить несколько аккаунтов
    одного приложения — после подключения рядом с каждым отображается количество «подключено».
  </Step>

  <Step title="Авторизуйте аккаунт">
    Большинство приложений используют OAuth: открывается всплывающее окно, вы входите в аккаунт поставщика
    и подтверждаете доступ, после чего подключение появляется на странице. **Cal.com —
    исключение** — оно подключается с помощью API-ключа. Вставьте ключ
    и нажмите **Проверить и подключить**; ключ проверяется в Cal.com
    перед шифрованием и сохранением.
  </Step>

  <Step title="Только для Google Sheets: выберите таблицу">
    Подключению Sheets необходимо знать, в какую таблицу и вкладку записывать
    данные. Сразу после подключения откроется панель настройки — вставьте
    URL таблицы (или её ID), нажмите **Проверить таблицу** и
    выберите вкладку. Панель подтвердит найденные столбцы. Пока это не
    сделано, на карточке подключения отображается **Требуется настройка**.
  </Step>
</Steps>

<Note>
  Проверка Google OAuth для ThunderPhone сейчас находится на рассмотрении, поэтому
  Google показывает предупреждение «непроверенное приложение» при предоставлении согласия для Google
  Calendar и Google Sheets. Диалог **Добавить приложение** проведёт вас
  через два нажатия, необходимые для продолжения (**Дополнительно → Перейти к ThunderPhone**).
</Note>

Для подключения и управления подключениями приложений требуется роль
**администратора** или **владельца** в организации.

## Управляйте действиями агента

Каждое подключение имеет переключатели разрешений для каждой операции — откройте карточку
подключения, чтобы управлять ими. Операции чтения включены по умолчанию; операции,
которые записывают или изменяют ваши данные, по умолчанию **выключены**, пока вы не включите их:

| Приложение      | Включено по умолчанию                                                | Выключено по умолчанию                                 |
| --------------- | -------------------------------------------------------------------- | ------------------------------------------------------ |
| Google Calendar | Просмотр событий и доступности, создание событий                     | Изменение событий, отмена событий                      |
| Google Sheets   | Добавление строк                                                     | —                                                      |
| Slack           | Просмотр каналов и последних сообщений, поиск сообщений              | Публикация сообщений                                   |
| HubSpot         | Поиск и чтение контактов и компаний                                  | Создание или обновление контактов и добавление заметок |
| Salesforce      | Поиск и чтение лидов, контактов и возможностей                       | Создание или обновление записей и регистрация действий |
| Cal.com         | Просмотр типов событий и проверка доступности, создание бронирований | Перенос или отмена бронирований                        |

Операция, которую вы отключили, просто недоступна агенту — соответствующие
инструменты никогда не предлагаются ему во время звонков.

## Инструменты, доступные вашему агенту

После подключения интеграции к агенту доступные операции становятся
вызываемыми инструментами во время разговоров:

* **Google Calendar** — `calendar_list_events`, `calendar_check_availability`,
  `calendar_create_event`, `calendar_update_event`, `calendar_cancel_event`
* **Google Sheets** — `sheets_append_row` (записывает данные в настроенные
  таблицу и вкладку)
* **Slack** — `slack_list_channels`, `slack_search_messages`,
  `slack_post_message`
* **HubSpot** — `hubspot_search_contacts`, `hubspot_get_contact`,
  `hubspot_upsert_contact`, `hubspot_add_note`
* **Salesforce** — `salesforce_search_records`, `salesforce_get_record`,
  `salesforce_upsert_lead`, `salesforce_log_activity`
* **Cal.com** — `calcom_list_event_types`, `calcom_check_availability`,
  `calcom_create_booking`, `calcom_cancel_booking`

Вам не нужно писать схемы ни для одной из них — ThunderPhone определяет инструменты
и направляет вызовы через подключённый аккаунт.

## Подключите интеграцию к агенту

Интеграции не работают, пока их не использует агент. Откройте агента в
конструкторе ([Создать агента](/ru/guides/build-an-agent)) и добавьте интеграцию
в разделе **Подключённые приложения**. На плитке интеграции на странице приложений
указано, сколько операций включено и сколько агентов её используют.

## Отключение

Откройте плитку интеграции и отключите её там. Агенты, которые её
использовали, потеряют эти инструменты при следующем звонке.

## Следующие шаги

<CardGroup cols={2}>
  <Card title="Превратите любой API в действие агента" icon="plug" href="/ru/guides/api-connections">
    Мастер вставки cURL для сервисов без встроенной интеграции.
  </Card>

  <Card title="Добавьте MCP-сервер" icon="server" href="/ru/guides/mcp-servers">
    Подключите собственный сервер инструментов через Streamable HTTP.
  </Card>
</CardGroup>