Коннекторы

• —Коннектор связывает внешнее приложение с ассистентом, чтобы тот мог искать там данные и действовать там. Подключить можно Slack, Notion, Google Drive, HubSpot и ещё около тысячи приложений. «Найди коммерческое предложение в Drive и скажи, что там написано о ценах.» «Опубликуй это обновление в канале продаж.» Коннекторы находятся в разделе «Коннекторы» в боковой панели.
• —Чтобы подключить приложение, выберите его в списке, укажите, для кого оно и что может делать ассистент, а затем завершите подключение на странице входа самого приложения или вставьте там ключ от приложения. Пароль или ключ никогда не проходит через чат OpenEmail, его API или ассистента. Пока вы не закончите, коннектор остаётся в ожидании, а после этого становится активным.
• —Коннектор предназначен только для вас или для всего рабочего пространства, а ассистент может либо только искать через него данные, либо ещё и вносить изменения. Позже это можно изменить, а коннектор можно приостановить и возобновить. При отключении доступ отзывается и во внешнем приложении. Если приложение перестаёт принимать подключение, коннектор просит переподключить его, и новая ссылка возвращает его тем же самым коннектором.
• —В чате ассистент видит, что подключено, находит нужное действие в приложении и читает сразу. Для всего, что что-то меняет в приложении, например для отправки сообщения, создания или обновления записи либо удаления, он сначала показывает карточку, которую вы должны одобрить, даже если вы прямо попросили об этом. Коннектор, который только ищет данные, отклоняет изменения, а то, что возвращает приложение, воспринимается как информация и никогда как инструкции.
• —Задача использует коннекторы, только если в её разделе «Дополнительные инструменты» включены «Коннекторы», и только те, что подключены для рабочего пространства, и никогда тот, который принадлежит одному человеку. Читает она сама. Каждое изменение в приложении ждёт в разделе «Ждут вас», что бы задача ни могла делать сама в остальном, а задача, которая использует коннекторы, никогда не отвечает на письма сама: каждый ответ ждёт вашего одобрения.
• —Каждый вызов, сделанный через коннектор, записывается и хранится 90 дней: когда, какое приложение и какое действие, читал он или что-то менял, удался ли он и пришёл ли он из чата, из задачи, из API или от агента. То, что было отправлено в приложение, и то, что пришло в ответ, OpenEmail никогда не хранит.
• —Кто что делает, определяют три разрешения: одно позволяет видеть коннекторы и то, что через них было сделано, второе позволяет поручать ассистенту их использовать, а третье позволяет подключать, приостанавливать и отключать приложения и задавать, что может делать ассистент. У владельцев и администраторов есть все три, у роли Member первые два, а у Viewer первое. Тот, кто может подключить приложение, может подключить его для себя или для рабочего пространства.
• —Тариф вмещает 2 коннектора на Free, 10 на Starter и 50 на Business для аккаунта и ещё столько же для рабочего пространства. Enterprise не задаёт собственного лимита, и нигде не может быть больше 200. Когда рабочее пространство переходит на тариф поменьше, самые новые коннекторы сверх лимита приостанавливаются, а не удаляются.
• —Подключения хранит внешний провайдер, который также до года хранит запись того, что ассистент отправляет в приложение и что приложение отвечает. Он указан на странице «Политика конфиденциальности».
• —Коннекторы доступны в REST API по адресам /connectors, /connector-apps, /connector-categories и /connector-calls, в каждом SDK как connectors, в командной строке как openemail connectors и на MCP-сервере. Через API изменение выполняется сразу, и никого не спрашивают, поэтому решает вызывающая сторона. Три события вебхуков сообщают вашим системам, когда коннектор рабочего пространства подключён, отключён или требует переподключения.

Подключение занимает минуту, а вход происходит на странице самого приложения.

1. 1Откройте «Коннекторы» в боковой панели и найдите приложение в разделе «Каталог» по названию или по категории.
2. 2Выберите, для кого коннектор: только для вас или для всего рабочего пространства.
3. 3Выберите, что ассистент может делать через него: только искать данные или ещё и вносить изменения.
4. 4Завершите подключение на странице входа приложения или вставьте там ключ от приложения. Пока вы не закончите, коннектор остаётся в ожидании, а после этого становится активным.

• —Ваш пароль или ключ от приложения никогда не проходит через чат OpenEmail, его API или ассистента.
• —Когда приложение перестаёт принимать подключение, коннектор сообщает, что его нужно переподключить. Новая ссылка возвращает его тем же самым коннектором, поэтому задачи, которые его используют, продолжают работать.
• —Приостановите коннектор, чтобы ассистент перестал им пользоваться, и возобновите его, когда он снова понадобится.
• —Отключение удаляет коннектор, а доступ, который был у него во внешнем приложении, отзывается и там.
• —Коннекторы могут быть выключены для всего сервиса. Тогда страница скрыта.

• —У владельцев и администраторов есть все три. У встроенной роли Member есть connectors:read и connectors:use, а у Viewer есть connectors:read.
• —Одно и то же разрешение охватывает оба вида коннекторов: тот, кто может подключить приложение, может подключить его для себя или для рабочего пространства.

Коннекторы доступны в REST API по адресам /connectors, /connector-apps, /connector-categories и /connector-calls, в каждом SDK и в CLI под именем connectors, а также в инструментах MCP, которыми пользуется и ассистент.