Docs

Connections

Integrations and environment

Connect catalog services, protect credentials, and understand project-wide environment values.

Connect an external service

Open Integrations in a project to browse the catalog enabled by your Amazi administrator. A connection belongs to the whole project rather than one chat or application. Full access or ownership is required to connect, replace, or reveal protected values. Browsing the catalog remains available without the built-in integrations feature; opening managed integration details and connecting require that feature in the project owner's plan. This restriction does not prohibit the agent from developing application code. Actual use of an external service still requires its own access and working connection.

Use All or a group tab to filter the catalog. Each group has an icon beside its name, shown in the color configured for that group.

The integration header shows its logo, name and connected status. Its groups appear below the name, separated by commas; integrations without a group show Other integrations. Use the back arrow to return to the catalog. For a connected service, Disconnect is in the header; Update connection stays beside the credential form. Disconnecting requires confirmation and does not automatically change your application's code.

Enter credentials only in the integration form. Amazi stores them outside chat and gives the agent variable names, connection status, and usage instructions without returning stored secret values. If an active task needs a disconnected integration, it can pause and show the same secure form; after an authorized member connects it, Amazi reconciles the development runtime and continues the task.

After you connect or skip an integration, the action appears in the chat's work summary. Saving or skipping a secure request for environment variables is recorded there too. The history shows names and outcomes, without credential values.

To name a service in a request, type @ in project chat and select it from the integration list. Connected services appear first and are tagged. A mention inserts the service name into your draft; connecting it remains a separate action. See Agent and chat.

In the chat connection card, enter the values you have and select Connect, or select Skip to continue without connecting. Empty values can be completed later in the integration settings.

Review Environment

Environment combines:

  • custom project values;
  • variables supplied by integrations;
  • managed platform values.

Members with project view access can inspect names and sources. Only roles with environment-management access can reveal or change protected values. Integration values are edited at their owning connection instead of being duplicated as manual variables. Runtime-owned fixed values can be revealed in Environment; authorized members can also reveal the managed database owner's current DATABASE_URL when it is available. Fixed values remain read-only.

Amazi can assign an already connected integration variable to its consuming applications without reading or changing the credential. Ask it to update the variable's application assignments; this does not require manually copying the token or editing the integration values.

Every custom, integration, Gateway, and Voice variable has an explicit application selection. Only the selected applications receive it in development and in the next production release. Vite exposes to browser code only names beginning with VITE_; Amazi does not rename variables. Runtime-owned secrets are separate: eligible server applications receive storage credentials, and only the managed database owner receives DATABASE_URL.

Development and production

Changing a value reconciles the retained development runtime. An active production release keeps the environment snapshot from its build, so publish a project update when production must use the new value. This reconciliation avoids stale process state without rewriting environment files that belong to the project. Amazi AI Gateway is configured on a separate project surface.

Available integrations

Bitrix24

Groups: CRM, продажи и поддержка

Подключает CRM, задачи, контакты, компании, сделки и другие сущности конкретного портала Bitrix24 через входящий вебхук. Подходит для внутренних автоматизаций без отдельного OAuth-приложения.

  1. Откройте Приложения → Ресурсы разработчика → Готовые сценарии → Другое → Входящий вебхук.
  2. Разрешите только нужные разделы API, например CRM или Задачи, сохраните вебхук и выполните тестовый запрос.
  3. Скопируйте URL до секретного кода включительно, без имени метода: https://<portal>/rest/<user_id>/<secret>/.
  4. Вставьте его в BITRIX24_WEBHOOK_URL.

Required configuration

  • BITRIX24_WEBHOOK_URL — URL входящего вебхука: Полный секретный URL входящего вебхука до завершающего /, например https://portal.bitrix24.ru/rest/1/secret/. Не добавляйте имя REST-метода.

МойСклад

Groups: Интернет-магазины и маркетплейсы

Подключает товары, остатки, контрагентов, заказы, продажи, закупки, документы и справочники МойСклад через JSON API. Подходит для учёта, синхронизации и операционной автоматизации.

  1. Откройте Меню пользователя → Настройки → Токены.
  2. Нажмите + Токен, создайте отдельный токен для интеграции и сразу скопируйте его.
  3. По возможности создавайте токен под отдельным пользователем с минимально необходимыми правами.
  4. Вставьте значение в MOYSKLAD_ACCESS_TOKEN.

Required configuration

  • MOYSKLAD_ACCESS_TOKEN — Токен доступа: Секретный токен JSON API из раздела Меню пользователя → Настройки → Токены.

Яндекс Метрика

Groups: Маркетинг и аналитика

Подключает отчёты, счётчики, цели и сырые выгрузки Яндекс Метрики. Подходит для аналитики трафика, конверсий и эффективности маркетинга.

  1. Создайте приложение в Yandex OAuth с типом Для доступа к API или отладки.
  2. Выдайте metrika:read. Добавьте metrika:write только если агент должен менять настройки или загружать данные; для аккаунта организации добавьте passport:business.
  3. Откройте ссылку авторизации приложения, подтвердите доступ и скопируйте выданный OAuth-токен.
  4. Вставьте его в YANDEX_METRIKA_OAUTH_TOKEN.

Required configuration

  • YANDEX_METRIKA_OAUTH_TOKEN — OAuth-токен: Секретный OAuth-токен Яндекса с доступом metrika:read; metrika:write добавляйте только при необходимости изменений или импорта.

DaData — адреса и организации

Groups: Учёт, данные и документооборот

Ищет и подсказывает реквизиты организаций и ИП, проверяет компанию по ИНН или ОГРН и подсказывает адреса. Интеграция намеренно ограничена API подсказок и findById, поэтому нужен только один API-ключ.

  1. Зарегистрируйтесь в DaData и подтвердите почту.
  2. Откройте личный кабинет и скопируйте API-ключ.
  3. Вставьте его в DADATA_API_KEY. Поле Секретный ключ не требуется.

Required configuration

  • DADATA_API_KEY — API-ключ: Секретный API-ключ из личного кабинета DaData. Секретный ключ Cleaner для этой интеграции не нужен.

Telegram Bot

Groups: Мессенджеры, соцсети и почта

Позволяет агенту отправлять сообщения и файлы через корпоративного Telegram-бота, читать доступные обновления и работать с чатами, где бот уже добавлен. Подходит для уведомлений, отчётов и простых рабочих сценариев.

  1. Откройте @BotFather в Telegram и выполните /newbot либо выберите существующего бота через /mybots.
  2. Скопируйте API Token и вставьте его в TELEGRAM_BOT_TOKEN.
  3. Добавьте бота в нужные группы или каналы и выдайте только необходимые права.
  4. Для личного чата пользователь должен сначала нажать Start.

Required configuration

  • TELEGRAM_BOT_TOKEN — Токен бота: Секретный токен бота, выданный @BotFather; выглядит как <bot_id>:<secret>.

Google Drive & Sheets

Groups: Документы, знания и разработка

Даёт агенту доступ к выбранным папкам и файлам Google Drive и к чтению или изменению таблиц Google Sheets через сервисный аккаунт. Доступ ограничивается ресурсами, которыми поделились с адресом сервисного аккаунта.

  1. В Google Cloud включите Google Drive API и Google Sheets API.
  2. Создайте отдельный Service Account → Keys → Add key → Create new key → JSON.
  3. Откройте нужную папку или таблицу и поделитесь ею с client_email из JSON, назначив Viewer или Editor.
  4. Вставьте всё содержимое JSON-файла в GOOGLE_SERVICE_ACCOUNT_JSON.

Required configuration

  • GOOGLE_SERVICE_ACCOUNT_JSON — JSON сервисного аккаунта: Полное содержимое секретного JSON-ключа сервисного аккаунта Google Cloud, не путь к файлу.

Notion

Groups: Документы, знания и разработка

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

  1. В Notion Developer Portal создайте Internal connection и включите только нужные capabilities.
  2. На вкладке Configuration скопируйте Installation access token.
  3. На вкладке Content access добавьте нужные страницы или базы либо откройте страницу → ••• → Connections → Add connection.
  4. Вставьте токен в NOTION_ACCESS_TOKEN.

Required configuration

  • NOTION_ACCESS_TOKEN — Токен внутренней интеграции: Секретный Installation access token внутренней интеграции Notion.

GitHub

Groups: Документы, знания и разработка

Подключает репозитории, код, issues, pull requests, commits, releases и GitHub Actions. Доступ ограничивается выбранным владельцем, репозиториями и permissions fine-grained токена.

  1. GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens.
  2. Выберите владельца ресурсов, только нужные репозитории и минимальные permissions. Для чтения кода обычно нужен Contents: Read; права на Issues, Pull requests, Actions и запись добавляйте только по необходимости.
  3. Задайте срок действия, создайте токен и вставьте его в GITHUB_ACCESS_TOKEN.
  4. Если организация требует approval, дождитесь одобрения администратора.

Required configuration

  • GITHUB_ACCESS_TOKEN — Токен доступа с точными правами: Секретный fine-grained personal access token GitHub с доступом только к нужным репозиториям и операциям.

Slack

Groups: Мессенджеры, соцсети и почта

Позволяет агенту читать доступные каналы и треды, отправлять и обновлять сообщения и выполнять разрешённые действия от имени Slack-бота. Доступ зависит от OAuth scopes и каналов, куда добавлен бот.

  1. Создайте Slack app для нужного workspace.
  2. В OAuth & Permissions добавьте только необходимые bot scopes, например chat:write, channels:read, channels:history, groups:read, groups:history, users:read.
  3. Нажмите Install/Reinstall to Workspace и скопируйте Bot User OAuth Token (xoxb-...).
  4. Вставьте его в SLACK_BOT_TOKEN и пригласите бота в нужные каналы.

Required configuration

  • SLACK_BOT_TOKEN — OAuth-токен пользователя-бота: Секретный Slack bot token формата xoxb-..., полученный после установки приложения в workspace.

HubSpot

Groups: CRM, продажи и поддержка

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

  1. В HubSpot откройте Development → Legacy apps → Create legacy app → Private.
  2. Добавьте только нужные scopes для контактов, компаний, сделок, тикетов, свойств и других используемых объектов.
  3. Создайте приложение, откройте Auth, нажмите Show token → Copy.
  4. Вставьте токен в HUBSPOT_ACCESS_TOKEN.

Required configuration

  • HUBSPOT_ACCESS_TOKEN — Токен доступа приватного приложения: Секретный access token приватного приложения HubSpot с минимально необходимыми CRM scopes.

Eptera Booking API

Groups: Гостиницы и рестораны

Подключает Booking API Eptera, совместимый с ElektraWeb, для чтения данных отеля, проверки цен и доступности, а также выполнения разрешённых операций с бронированиями. Авторизация двухэтапная: исходный API Key обменивается через /login на временный JWT для рабочих запросов.

  1. Запросите у поддержки Eptera API Key для Booking API и числовой Hotel ID нужного отеля. Исходный ключ обычно имеет вид bookingapi#<hotel-id>$...; это не временный JWT из ответа /login.
  2. Вставьте исходный токен в EPTERA_API_KEY без слова Bearer, кавычек и пробелов по краям.
  3. Вставьте числовой идентификатор отеля в EPTERA_HOTEL_ID. Он используется в адресах вида /hotel/<hotel-id>/....
  4. Второй JWT вводить и обновлять вручную не нужно: агент отправит исходный ключ в POST https://bookingapi.eptera.ru/login, получит временный JWT из поля jwt и использует его для остальных запросов.
  5. Не публикуйте исходный ключ в коде, чате, логах или клиентском браузере. При отзыве или замене ключа обновите EPTERA_API_KEY здесь.

Required configuration

  • EPTERA_API_KEY — API Key (исходный токен): Исходный постоянный токен Booking API, выданный Eptera. Вставьте только значение вида bookingapi#<hotel-id>$... без префикса Bearer; временный JWT из /login сюда сохранять не нужно.
  • EPTERA_HOTEL_ID — Идентификатор отеля: Числовой идентификатор отеля Eptera. Используется в API-путях /hotel/<hotel-id>/... и должен входить в allowed-hotel-ids ответа /login.

1С-Битрикс: Управление сайтом

Groups: Интернет-магазины и маркетплейсы

Подключает собственный сайт или интернет-магазин на CMS «1С-Битрикс: Управление сайтом» через REST API для работы с контентом, каталогом, заказами, пользователями и доступными методами установленных модулей. Фактические возможности зависят от версии продукта, модулей и прав локального приложения.

  1. Убедитесь, что на сайте установлена версия 1С-Битрикс: Управление сайтом 16.6.0 или новее и включён модуль REST API. Его настройки находятся в Настройки → Настройки продукта → Настройки модулей → REST API.
  2. Создайте для интеграции отдельное локальное серверное приложение с минимально необходимыми разрешениями и HTTPS callback URL. Не используйте учётные данные администратора сайта вместо OAuth-приложения.
  3. Установите приложение и сохраните полученные OAuth-данные: REST endpoint (client_endpoint), URL обновления токена, client_id, client_secret, access_token и refresh_token.
  4. Заполните поля ниже полными значениями. REST endpoint должен иметь вид https://site.example/rest/, а URL обновления — https://site.example/oauth/token/ либо официальный URL OAuth-сервера, возвращённый вашей установкой.
  5. Выдавайте только нужные приложению права. При отзыве приложения или смене ключа обновите все связанные значения; не публикуйте токены в коде, браузере или логах.

Required configuration

  • BITRIX_CMS_REST_ENDPOINT — Адрес REST API: Полный HTTPS-адрес REST API из поля client_endpoint, обычно https://site.example/rest/.
  • BITRIX_CMS_OAUTH_TOKEN_URL — URL OAuth-токена: Полный HTTPS-адрес обновления OAuth-токена, например https://site.example/oauth/token/, либо URL официального OAuth-сервера из данных установки.
  • BITRIX_CMS_CLIENT_ID — Идентификатор клиента приложения: Идентификатор отдельного локального приложения 1С-Битрикс.
  • BITRIX_CMS_CLIENT_SECRET — Секрет клиента приложения: Секретный ключ локального приложения. Не используйте пароль администратора сайта.
  • BITRIX_CMS_ACCESS_TOKEN — OAuth-токен доступа: Текущий секретный access_token, полученный при установке приложения или последнем обновлении OAuth-пары.
  • BITRIX_CMS_REFRESH_TOKEN — OAuth-токен обновления: Текущий секретный refresh_token. После обновления OAuth сохраните новый access token и новый refresh token вместе.

1С:Предприятие

Groups: Учёт, данные и документооборот

Подключает опубликованную информационную базу 1С:Предприятия через стандартный REST-интерфейс OData 3.0. Позволяет читать доступные справочники, документы и регистры, а при выданных правах — создавать и изменять объекты, проводить документы и выполнять другие операции платформы.

  1. В конфигураторе 1С опубликуйте информационную базу на веб-сервере и включите опцию Публиковать стандартный интерфейс OData.
  2. Создайте отдельного пользователя интеграции и выдайте ему только необходимые роли и права на объекты. Не используйте личную или административную учётную запись.
  3. Убедитесь, что endpoint доступен по HTTPS. Обычно он имеет вид https://host/<publication>/odata/standard.odata/.
  4. Проверьте подключение запросом к $metadata, затем укажите OData URL, имя пользователя и пароль ниже.
  5. При смене пароля обновите подключение. Не размещайте учётные данные в URL, коде, браузере или логах.

Required configuration

  • ONEC_ODATA_URL — URL сервиса OData: Полный HTTPS-адрес стандартного OData-интерфейса опубликованной базы, включая завершающий /odata/standard.odata/.
  • ONEC_USERNAME — Имя пользователя интеграции: Имя отдельного пользователя информационной базы с минимально необходимыми ролями.
  • ONEC_PASSWORD — Пароль интеграции: Пароль отдельного пользователя интеграции.

amoCRM

Groups: CRM, продажи и поддержка

Подключение к CRM для работы со сделками, контактами, компаниями, задачами, воронками, примечаниями и вебхуками через API v4.

Как подключить

  1. Откройте нужный аккаунт amoCRM и перейдите в amoМаркет → три точки → Создать интеграцию.
  2. Создайте приватную или внешнюю интеграцию и выдайте ей только необходимые права.
  3. На вкладке Ключи нажмите Сгенерировать токен, выберите срок действия и сразу сохраните показанный долгосрочный токен: повторно его посмотреть нельзя.
  4. Укажите точный адрес аккаунта, например https://company.amocrm.ru, и долгосрочный токен в полях ниже.

Токен храните только на сервере. При компрометации отзовите его в amoCRM и выпустите новый. Для приёма событий подготовьте публичный HTTPS-адрес проекта и настройте подписки на вебхуки.

Required configuration

  • AMOCRM_BASE_URL — Адрес аккаунта amoCRM: Точный HTTPS-адрес аккаунта, например https://company.amocrm.ru.
  • AMOCRM_ACCESS_TOKEN — Долгосрочный токен: Долгосрочный токен приватной или внешней интеграции amoCRM.

Asterisk

Groups: Телефония и контакт-центры

Подключение к Asterisk через ARI для управления звонками, каналами, мостами, воспроизведением, записью и событиями телефонии.

Как подключить

  1. На сервере Asterisk включите встроенный HTTP-сервер в http.conf и обязательно настройте TLS.
  2. Включите ARI и создайте отдельного пользователя с минимально необходимыми правами в ari.conf.
  3. Добавьте в dialplan вызов Stasis(<имя-приложения>) для каналов, которыми должен управлять проект.
  4. Укажите полный HTTPS-адрес ARI, например https://pbx.example.com:8089/ari, имя пользователя, пароль и то же имя Stasis-приложения.

Не публикуйте ARI напрямую в интернет без сетевых ограничений, TLS и сильного пароля. Проект должен обращаться к ARI только с серверной стороны и поддерживать постоянное WSS-подключение для событий.

Required configuration

  • ASTERISK_ARI_BASE_URL — Адрес Asterisk ARI: Полный HTTPS-адрес корня ARI, например https://pbx.example.com:8089/ari.
  • ASTERISK_ARI_USERNAME — Пользователь ARI: Имя отдельного пользователя из ari.conf.
  • ASTERISK_ARI_PASSWORD — Пароль ARI: Сильный пароль пользователя ARI из ari.conf.
  • ASTERISK_ARI_APP — Имя Stasis-приложения: Имя приложения, переданное в Stasis(...) в dialplan.

Avito API

Groups: Интернет-магазины и маркетплейсы

Подключение к официальным API Авито для работы с профилем, объявлениями, сообщениями, статистикой и другими доступными сервисами аккаунта.

Как подключить

  1. Войдите в кабинет разработчика Авито и подключите нужные API-продукты для своего профессионального аккаунта. Доступность методов зависит от тарифа, категории и одобрения Авито.
  2. Создайте приложение или получите персональные данные доступа.
  3. Скопируйте Client ID и Client Secret в поля ниже.
  4. После подключения проверьте права приложения в каталоге API.

Секрет храните только на сервере. Проект будет сам получать краткоживущий OAuth-токен через client_credentials; вручную вводить access token не требуется.

Required configuration

  • AVITO_CLIENT_ID — Идентификатор клиента: Идентификатор приложения или персонального API-доступа из кабинета разработчика Авито.
  • AVITO_CLIENT_SECRET — Секрет клиента: Секрет приложения из кабинета разработчика Авито.

Confluence Cloud

Groups: Документы, знания и разработка

Подключение к Confluence Cloud REST API v2 для чтения и управления пространствами, страницами, комментариями, вложениями, метками и другими типами контента.

Как подключить

  1. Создайте в Atlassian API-токен со scopes и выдайте только права Confluence, необходимые проекту. Укажите срок действия токена и сохраните его сразу после создания.
  2. Укажите email Atlassian-аккаунта, от имени которого будет работать проект. Права API не превышают права этого пользователя в Confluence.
  3. Получите Cloud ID: откройте https://<ваш-сайт>.atlassian.net/_edge/tenant_info и скопируйте значение cloudId.
  4. Заполните Cloud ID, email и токен ниже.

Эта карточка настроена для scoped API-токенов через api.atlassian.com. Не вводите пароль Atlassian. После истечения срока выпустите новый токен и замените значение интеграции.

Required configuration

  • CONFLUENCE_CLOUD_ID — Идентификатор облака: Значение cloudId из https://<ваш-сайт>.atlassian.net/_edge/tenant_info.
  • CONFLUENCE_EMAIL — Электронная почта Atlassian: Email Atlassian-аккаунта, для которого создан API-токен.
  • CONFLUENCE_API_TOKEN — API-токен: Scoped API-токен Atlassian с минимально необходимыми правами Confluence.

Контур.Диадок

Groups: Учёт, данные и документооборот

Интеграция с API Контур.Диадока для работы с организациями, ящиками, контрагентами, сообщениями, юридически значимыми документами и документооборотом.

Как подключить

  1. Оставьте заявку на интеграцию с API Диадока и получите доступ в Кабинет интегратора.
  2. Создайте OIDC-приложение, скопируйте client_id и выпустите client_secret.
  3. Зарегистрируйте точный HTTPS Redirect URI вашего проекта и укажите его ниже без изменений.
  4. В интерфейсе проекта реализуйте вход пользователя через Контур и выдачу прав со scopes openid profile email offline_access Diadoc.PublicAPI.

Диадок рекомендует OpenID Connect; устаревшую авторизацию по логину и паролю использовать не нужно. Client Secret и полученные токены должны храниться только на сервере. Для подписания документов дополнительно потребуются сертификат, права и соблюдение регламентов конкретного документооборота — эта карточка не заменяет их настройку.

Required configuration

  • DIADOC_CLIENT_ID — Идентификатор клиента: Идентификатор OIDC-приложения из Кабинета интегратора Диадока.
  • DIADOC_CLIENT_SECRET — Секрет клиента: Секрет OIDC-приложения, выпущенный в Кабинете интегратора.
  • DIADOC_REDIRECT_URI — URI перенаправления: Точный HTTPS Redirect URI, зарегистрированный для приложения в Кабинете интегратора.

Discord

Groups: Мессенджеры, соцсети и почта

Подключение Discord-приложения и бота для сообщений, slash-команд, компонентов, событий серверов, модерации и других возможностей Discord API.

Как подключить

  1. Создайте приложение в Discord Developer Portal.
  2. На странице General Information скопируйте Application ID и Public Key.
  3. На странице Bot создайте или сбросьте Bot Token и сразу сохраните его.
  4. Включите только действительно необходимые Gateway Intents. Привилегированные intents могут потребовать отдельного разрешения Discord.
  5. В разделе установки сформируйте ссылку с минимальными scopes и permissions и установите приложение на нужный сервер.

Bot Token храните только на сервере. Если проект принимает interactions по HTTPS, укажите публичный endpoint в Developer Portal и обязательно проверяйте Ed25519-подпись каждого запроса.

Required configuration

  • DISCORD_APPLICATION_ID — Идентификатор приложения: Идентификатор приложения со страницы General Information в Discord Developer Portal.
  • DISCORD_PUBLIC_KEY — Публичный ключ: Публичный Ed25519-ключ приложения для проверки подписи HTTP interactions.
  • DISCORD_BOT_TOKEN — Токен бота: Секретный токен бота со страницы Bot. Не передавайте его третьим лицам.

Genesys Cloud

Groups: Телефония и контакт-центры

Серверная интеграция с Genesys Cloud Platform API для контакт-центра, аналитики, пользователей, маршрутизации, записей, уведомлений и других доступных ресурсов.

Как подключить

  1. В Genesys Cloud откройте Admin → Integrations → OAuth и создайте клиент типа Client Credentials.
  2. Назначьте клиенту только необходимые роли и divisions. Учтите, что client credentials не имеет пользовательского контекста, поэтому часть операций с живыми разговорами недоступна.
  3. Скопируйте Client ID и Client Secret.
  4. Укажите домен среды вашего региона без api. и login., например mypurecloud.com, mypurecloud.ie или usw2.pure.cloud. Сверьте его с официальным списком сред.

Client Secret храните только на сервере. Если функции нужны от лица конкретного пользователя, вместо этого потребуется отдельный OAuth Authorization Code flow — не расширяйте права server-to-server клиента вслепую.

Required configuration

  • GENESYS_CLOUD_ENVIRONMENT — Домен среды Genesys Cloud: Региональный домен без схемы и префиксов, например mypurecloud.com или usw2.pure.cloud.
  • GENESYS_CLOUD_CLIENT_ID — Идентификатор клиента: Client ID OAuth-интеграции типа Client Credentials.
  • GENESYS_CLOUD_CLIENT_SECRET — Секрет клиента: Секрет OAuth-интеграции типа Client Credentials.

Google Analytics 4

Groups: Маркетинг и аналитика

Подключение к Google Analytics 4 Data API для отчётов и метрик, а также к Admin API для разрешённых операций с конфигурацией свойства.

Как подключить

  1. Создайте или выберите проект в Google Cloud и включите Google Analytics Data API. Admin API включайте только если проект действительно меняет конфигурацию Analytics.
  2. Создайте отдельный сервисный аккаунт и выпустите для него JSON-ключ.
  3. В Google Analytics откройте Admin → Property access management и добавьте client_email из JSON-ключа. Для отчётов достаточно минимальной роли чтения.
  4. Скопируйте числовой GA4 Property ID (не Measurement ID вида G-...) и вставьте весь JSON-ключ в поля ниже.

JSON-ключ храните только на сервере. Не добавляйте сервисному аккаунту лишние роли в Google Cloud или Analytics и замените ключ при компрометации.

Required configuration

  • GOOGLE_ANALYTICS_PROPERTY_ID — Идентификатор ресурса GA4: Числовой идентификатор свойства GA4. Не используйте Measurement ID вида G-....
  • GOOGLE_ANALYTICS_SERVICE_ACCOUNT_JSON — JSON-ключ сервисного аккаунта: Полное содержимое JSON-ключа сервисного аккаунта, которому выдан доступ к свойству.

iikoCloud API

Groups: Гостиницы и рестораны

Подключение к iikoCloud API для организаций, меню, терминальных групп, заказов доставки, стоп-листов, номенклатуры и других доступных ресторанных операций.

Как подключить

  1. Подключите iikoCloud API для своей организации через iiko или обслуживающего партнёра и получите apiLogin. Доступные методы зависят от лицензии и настроек организации.
  2. Уточните региональный адрес API. Для российских организаций обычно используется https://api-ru.iiko.services.
  3. Вставьте адрес API и apiLogin в поля ниже.

apiLogin является секретом: храните его только на сервере. Проект сам получает краткоживущий токен через /api/1/access_token, а список доступных organization ID — через /api/1/organizations; вводить токен или organization ID вручную не требуется.

Required configuration

  • IIKO_CLOUD_BASE_URL — Адрес iikoCloud API: HTTPS-адрес API вашего региона, обычно https://api-ru.iiko.services для России.
  • IIKO_CLOUD_API_LOGIN — Логин API: Секретный apiLogin, выданный для доступа организации к iikoCloud API.

Instagram Messaging API

Groups: Мессенджеры, соцсети и почта

Подключение профессионального аккаунта Instagram для получения и отправки сообщений, обработки webhook-событий и управления диалогами через официальный Instagram API.

Как подключить

  1. Переведите аккаунт Instagram в профессиональный режим и создайте приложение Meta с продуктом Instagram.
  2. Настройте Instagram API with Instagram Login, добавьте Redirect URI и запросите только необходимые messaging-разрешения. Для публичного приложения может потребоваться App Review и Business Verification.
  3. Пройдите авторизацию аккаунта, получите долгоживущий access token и скопируйте Instagram Account ID.
  4. В настройках Webhooks укажите публичный HTTPS endpoint проекта, придумайте секретную строку Verify Token и подпишитесь только на нужные поля.
  5. Скопируйте App Secret, Account ID, access token и Verify Token в поля ниже.

Access token и App Secret храните только на сервере. Интеграция работает в пределах правил переписки, разрешений и окон взаимодействия Meta; она не предназначена для произвольных массовых рассылок.

Required configuration

  • INSTAGRAM_ACCOUNT_ID — ID аккаунта Instagram: Идентификатор авторизованного профессионального аккаунта Instagram.
  • INSTAGRAM_ACCESS_TOKEN — Токен доступа: Долгоживущий access token аккаунта с необходимыми messaging-разрешениями.
  • META_APP_SECRET — Секрет приложения Meta: Секрет приложения Meta для проверки подписей входящих webhook-запросов.
  • INSTAGRAM_WEBHOOK_VERIFY_TOKEN — Токен проверки вебхука: Придуманная вами случайная секретная строка, одинаковая в проекте и настройках Webhooks Meta.

Jivo Chat API

Groups: Мессенджеры, соцсети и почта

Двусторонний Chat API-канал Jivo для передачи обращений из собственного сайта или приложения операторам и получения их ответов через HTTPS-события.

Как подключить

  1. В приложении Jivo откройте Управление → Добавить канал → Chat API.
  2. Укажите публичный HTTPS endpoint проекта, который будет принимать события от Jivo, выберите операторов и создайте канал.
  3. Jivo покажет уникальный URL для отправки событий в канал. Скопируйте его целиком в поле ниже; случайная часть URL является секретом.
  4. Проверьте статус канала через <URL>/status, затем отправьте тестовое событие и убедитесь, что ответ оператора приходит на настроенный endpoint проекта.

Не публикуйте уникальный URL и не используйте его во frontend-коде. Входящие события могут повторяться, поэтому проект должен обрабатывать их идемпотентно.

Required configuration

  • JIVO_CHAT_API_ENDPOINT — URL Chat API-канала: Полный уникальный URL, созданный Jivo для отправки событий в Chat API-канал.

Контур API

Groups: Учёт, данные и документооборот

Подключение к API продуктов Контур для обмена данными с корпоративными сервисами. Конкретные методы, адрес API, права доступа и состав ключей зависят от выбранного продукта Контура.

Как подключить

  1. Выберите конкретный продукт Контур и убедитесь, что для него приобретён или предоставлен доступ к API.
  2. Зарегистрируйте приложение по инструкции этого продукта и получите client_id и ключ приложения/API.
  3. Укажите базовый URL именно продуктового API — например, для Контур.Экстерна это https://extern-api.kontur.ru.
  4. Если вы уже получили пользовательский access token, добавьте его. Иначе оставьте поле токена пустым: агент должен реализовать поддерживаемый продуктом OpenID Connect flow.
  5. Выдавайте приложению только необходимые scopes и не переносите ключи между разными продуктами Контура.

У сервисов Контура единый провайдер входа, но нет одного универсального API-ключа для всех продуктов. Сверяйте параметры с документацией выбранного сервиса.

Required configuration

  • KONTUR_API_BASE_URL — Базовый URL API: Базовый HTTPS-адрес API выбранного продукта Контур без пути конкретного метода.
  • KONTUR_CLIENT_ID — Идентификатор клиента: Идентификатор приложения, выданный для API выбранного продукта Контур.
  • KONTUR_API_KEY — Ключ приложения / API key: Секретный ключ приложения или API-ключ, выданный для выбранного продукта Контур.
  • KONTUR_ACCESS_TOKEN — Токен доступа: Необязательный действующий пользовательский access token. Если не указан, токен нужно получать поддерживаемым OpenID Connect flow.

Почта Mail.ru

Groups: Мессенджеры, соцсети и почта

Чтение, поиск и обработка писем через IMAP, а также отправка сообщений через SMTP в почтовом ящике Mail.ru.

Как подключить

  1. В Почте Mail откройте Настройки → Все настройки → Безопасность → Внешние сервисы и разрешите доступ по IMAP и SMTP.
  2. В разделе Пароли для внешних приложений создайте отдельный пароль для этой интеграции. Обычный пароль от ящика не подходит.
  3. Укажите полный адрес почты и созданный пароль приложения.

Интеграция использует защищённые соединения: IMAP imap.mail.ru:993 и SMTP smtp.mail.ru:465. Удаление пароля внешнего приложения немедленно отзовёт доступ.

Required configuration

  • MAIL_RU_EMAIL — Адрес почты: Полный адрес почтового ящика Mail.ru, например user@mail.ru.
  • MAIL_RU_APP_PASSWORD — Пароль приложения: Отдельный пароль для внешнего приложения, созданный в настройках безопасности Почты Mail.

MANGO OFFICE

Groups: Телефония и контакт-центры

Интеграция с Виртуальной АТС MANGO OFFICE: звонки, сотрудники, статистика, записи разговоров и события телефонии.

Как подключить

  1. В личном кабинете MANGO OFFICE откройте раздел интеграций и подключите API Виртуальной АТС.
  2. Скопируйте уникальный код АТС (vpbx_api_key) и ключ подписи (vpbx_api_salt).
  3. Вставьте их в соответствующие поля.
  4. Для входящих уведомлений настройте URL обработчика в личном кабинете MANGO OFFICE и ограничьте доступ согласно актуальной документации.

Ключ подписи храните как секрет. Его замена требует обновления настройки интеграции.

Required configuration

  • MANGO_VPBX_API_KEY — Код Виртуальной АТС: Уникальный код продукта ВАТС (vpbx_api_key) из настроек API MANGO OFFICE.
  • MANGO_VPBX_API_SALT — Ключ подписи: Секретный ключ (vpbx_api_salt) для вычисления SHA-256 подписи запросов.

MAX Bot API

Groups: Мессенджеры, соцсети и почта

Создание ботов в MAX: получение событий, отправка и редактирование сообщений, работа с чатами, кнопками и медиафайлами.

Как подключить

  1. Создайте чат-бота на платформе MAX для бизнеса или в кабинете разработчика.
  2. Откройте расширенные настройки бота и получите токен доступа.
  3. Придумайте отдельный webhook-секрет длиной 5–256 символов из латинских букв, цифр, _ и -.
  4. Укажите токен и секрет ниже.
  5. Для production настройте HTTPS webhook на порту 443 с доверенным сертификатом.

Токен даёт возможность управлять ботом — не публикуйте его. Webhook-секрет должен совпадать со значением, переданным при создании подписки.

Required configuration

  • MAX_BOT_TOKEN — Токен бота: Токен доступа, выданный в расширенных настройках чат-бота MAX.
  • MAX_WEBHOOK_SECRET — Секрет webhook: Случайный секрет для проверки заголовка X-Max-Bot-Api-Secret входящих webhook-запросов.

Мегаплан

Groups: CRM, продажи и поддержка

Интеграция с CRM Мегаплан для работы с клиентами, сделками, задачами, проектами, сотрудниками и другими сущностями через API v3.

Как подключить

  1. В своём аккаунте Мегаплана создайте приложение с доступом по API.
  2. На странице приложения скопируйте его UUID и API token. Авторизация приложения по логину и паролю больше не поддерживается.
  3. Укажите полный HTTPS-адрес аккаунта, например https://company.megaplan.ru, UUID и токен.
  4. Проверьте доступную схему API v3 непосредственно в аккаунте по адресу /api/v3/docs.

Права запросов соответствуют пользователю, создавшему приложение. Выдавайте приложению минимально необходимый доступ.

Required configuration

  • MEGAPLAN_BASE_URL — Адрес аккаунта: Полный HTTPS-адрес аккаунта Мегаплана, например https://company.megaplan.ru.
  • MEGAPLAN_APP_UUID — UUID приложения: UUID приложения с доступом к API, используемый как AccessId.
  • MEGAPLAN_API_TOKEN — Токен API: Секретный API token приложения из страницы его настройки.

Meta Messenger Platform

Groups: Мессенджеры, соцсети и почта

Интеграция Facebook-страницы с Messenger: получение сообщений и событий через webhook, отправка ответов и работа с диалогами через Graph API.

Как подключить

  1. Создайте приложение в Meta for Developers и добавьте продукт Messenger.
  2. Привяжите Facebook-страницу и получите её ID и Page Access Token с нужными разрешениями.
  3. Скопируйте App Secret из настроек приложения.
  4. Придумайте webhook verify token и укажите его и в Meta, и в этой форме.
  5. Настройте публичный HTTPS webhook, пройдите проверку challenge и подпишитесь только на необходимые события страницы.
  6. Перед production-доступом завершите требуемую Meta App Review и переведите приложение в Live mode.

Не используйте пользовательский access token вместо Page Access Token.

Required configuration

  • META_MESSENGER_PAGE_ID — ID Facebook-страницы: Числовой ID Facebook-страницы, подключённой к приложению Messenger.
  • META_MESSENGER_PAGE_ACCESS_TOKEN — Токен доступа страницы: Токен доступа страницы с разрешениями Messenger, полученный для этой Facebook-страницы.
  • META_MESSENGER_APP_SECRET — Секрет приложения: Секрет приложения Meta для проверки подписи входящих webhook-событий.
  • META_MESSENGER_WEBHOOK_VERIFY_TOKEN — Токен проверки вебхука: Случайная строка, совпадающая с verify token в настройках webhook приложения Meta.

Microsoft Teams

Groups: Мессенджеры, соцсети и почта

Интеграция с Microsoft Teams через Microsoft Graph: команды, каналы, чаты, сообщения, участники и уведомления.

Как подключить

  1. Зарегистрируйте приложение в Microsoft Entra ID.
  2. Скопируйте Tenant ID и Application (client) ID.
  3. Создайте client secret и сразу сохраните его значение.
  4. Добавьте только необходимые Microsoft Graph application permissions или используйте Resource-Specific Consent для конкретной команды/чата.
  5. Предоставьте admin consent, если он требуется выбранными разрешениями.

Для новых уведомлений не проектируйте интеграцию на устаревающих Microsoft 365 Connectors. Предпочитайте Graph, Teams app/бота или Teams Workflows согласно сценарию.

Required configuration

  • MICROSOFT_TENANT_ID — Идентификатор каталога: Идентификатор каталога Microsoft Entra, в котором зарегистрировано приложение.
  • MICROSOFT_TEAMS_CLIENT_ID — Идентификатор клиента: Application (client) ID зарегистрированного приложения Microsoft Entra.
  • MICROSOFT_TEAMS_CLIENT_SECRET — Секрет клиента: Значение секрета приложения Microsoft Entra, а не его Secret ID.

Mindbox

Groups: Маркетинг и аналитика

Интеграция с Mindbox для передачи данных клиентов, заказов и действий, запуска операций и сценариев через API v3.

Как подключить

  1. В административной панели Mindbox откройте настройки интеграции и выберите точку интеграции.
  2. Скопируйте её системный идентификатор (endpointId).
  3. Создайте или получите секретный сервисный ключ для этой точки.
  4. При необходимости постоянной идентификации устройства сгенерируйте UUID v4 и используйте одно стабильное значение для конкретной установки.
  5. Названия и схемы операций берите из настроек вашего проекта Mindbox — они индивидуальны.

Не передавайте секретный ключ в браузерный код. Для server-side запросов используйте защищённый backend.

Required configuration

  • MINDBOX_ENDPOINT_ID — Идентификатор точки интеграции: Системный идентификатор точки интеграции Mindbox (endpointId).
  • MINDBOX_SECRET_KEY — Секретный ключ: Секретный сервисный ключ точки интеграции для server-side API-запросов.
  • MINDBOX_DEVICE_UUID — UUID устройства: Необязательный стабильный UUID устройства/установки для операций, где он включён в настройках.

Ozon Seller API

Groups: Интернет-магазины и маркетплейсы

Интеграция кабинета продавца Ozon: товары, цены, остатки, заказы FBO/FBS, отправления, финансы, отчёты и чаты.

Как подключить

  1. В кабинете продавца Ozon откройте Настройки → Seller API.
  2. Создайте API-ключ с минимально необходимой ролью.
  3. Скопируйте Client ID продавца и значение API-ключа.
  4. Укажите их ниже.

Если доступ нужен только для аналитики, не выдавайте ключу права на изменение товаров и управление отправлениями. При утечке немедленно отзовите ключ в кабинете Ozon.

Required configuration

  • OZON_SELLER_CLIENT_ID — Client ID продавца: Client ID из раздела Seller API кабинета продавца Ozon.
  • OZON_SELLER_API_KEY — API-ключ: Секретный API-ключ с минимально необходимой ролью в кабинете Ozon.

retailCRM

Groups: CRM, продажи и поддержка

Интеграция с retailCRM для работы с заказами, клиентами, товарами, остатками, магазинами, доставками и историей изменений через API v5.

Как подключить

  1. В retailCRM откройте Администрирование → Интеграция → Ключи доступа к API.
  2. Создайте отдельный ключ и включите только необходимые методы.
  3. Укажите полный HTTPS-адрес аккаунта, например https://company.retailcrm.ru, и API-ключ.
  4. Если аккаунт содержит несколько магазинов, также укажите символьный код нужного магазина.

Не используйте ключ с полным доступом, если интеграции нужны только чтение и аналитика.

Required configuration

  • RETAILCRM_BASE_URL — Адрес retailCRM: Полный HTTPS-адрес аккаунта retailCRM, например https://company.retailcrm.ru.
  • RETAILCRM_API_KEY — API-ключ: Отдельный API-ключ retailCRM с минимально необходимым набором разрешённых методов.
  • RETAILCRM_SITE_CODE — Код магазина: Необязательный символьный код магазина для методов, где параметр site обязателен.

Roistat

Groups: Маркетинг и аналитика

Интеграция с Roistat для получения аналитики, сделок, событий, коллтрекинга, проектов и других данных сквозной аналитики.

Как подключить

  1. Откройте настройки профиля Roistat и скопируйте персональный API-ключ.
  2. Найдите числовой номер нужного проекта.
  3. Укажите API-ключ и номер проекта ниже.

API-ключ связан с пользователем и может открывать доступ сразу к нескольким проектам. Используйте отдельного пользователя с минимальными правами и не передавайте ключ в URL вручную.

Required configuration

  • ROISTAT_API_KEY — API-ключ: Персональный API-ключ из настроек профиля Roistat.
  • ROISTAT_PROJECT_ID — Номер проекта: Числовой номер проекта Roistat, с данными которого должна работать интеграция.

Salesforce

Groups: CRM, продажи и поддержка

Интеграция с Salesforce CRM через REST API для работы с объектами, запросами SOQL, метаданными и бизнес-процессами.

Как подключить

  1. Создайте External Client App или Connected App в Salesforce и включите OAuth Client Credentials Flow.
  2. Назначьте отдельного integration user в поле Run As и выдайте ему минимальные permission sets.
  3. Скопируйте Consumer Key (Client ID) и Consumer Secret.
  4. Укажите OAuth base URL вашей организации: My Domain URL, https://login.salesforce.com для production либо https://test.salesforce.com для sandbox.

Не используйте OAuth username-password flow: Salesforce рекомендует переходить на client credentials или другой современный flow.

Required configuration

  • SALESFORCE_LOGIN_URL — Базовый URL OAuth: HTTPS-адрес My Domain организации либо https://login.salesforce.com/https://test.salesforce.com.
  • SALESFORCE_CLIENT_ID — Идентификатор клиента: Consumer Key приложения Salesforce с включённым Client Credentials Flow.
  • SALESFORCE_CLIENT_SECRET — Секрет клиента: Consumer Secret приложения Salesforce.

СберБизнес API

Groups: Учёт, данные и документооборот

Интеграция со Sber API и СберБизнес ID для доступа к счетам, выпискам, платежам и другим банковским сервисам с согласия пользователя.

Как подключить

  1. Подключите Sber API в СберБизнес, подпишите необходимые документы и выберите сервисы.
  2. В личном кабинете Sber API зарегистрируйте приложение, redirect URI и получите Client ID/Client Secret.
  3. Выпустите промышленный TLS-клиентский сертификат и сохраните сертификат вместе с закрытым ключом.
  4. Укажите базовый URL именно вашего стенда, redirect URI и все выданные реквизиты.
  5. Пользователь СберБизнес должен отдельно пройти OAuth и дать согласие на нужные операции.

Это банковская интеграция: не используйте тестовые ключи на production и не вставляйте сертификаты в клиентский код.

Required configuration

  • SBER_API_BASE_URL — Базовый URL Sber API: HTTPS-адрес промышленного или тестового стенда, выданный в личном кабинете Sber API.
  • SBER_API_CLIENT_ID — Идентификатор клиента: Идентификатор зарегистрированного приложения Sber API.
  • SBER_API_CLIENT_SECRET — Секрет клиента: Секрет зарегистрированного приложения Sber API.
  • SBER_API_REDIRECT_URI — URI перенаправления: Точный HTTPS redirect URI, зарегистрированный для OAuth-приложения.
  • SBER_API_TLS_CERT_PEM — TLS-сертификат: Клиентский TLS-сертификат, выданный для доступа к выбранному стенду Sber API, в PEM.
  • SBER_API_TLS_KEY_PEM — Закрытый ключ TLS: Закрытый ключ клиентского TLS-сертификата в PEM. Храните его в защищённом секрет-хранилище.

Shopify

Groups: Интернет-магазины и маркетплейсы

Интеграция магазина Shopify через GraphQL Admin API: товары, коллекции, заказы, клиенты, остатки, fulfillment и webhooks.

Как подключить

  1. Создайте приложение для магазина через Shopify Dev Dashboard/CLI и установите его в магазин. Для старого admin-created custom app можно использовать уже выданный Admin API access token.
  2. Выдайте приложению только необходимые Admin API scopes.
  3. Укажите домен магазина вида store.myshopify.com, Admin API access token и client secret приложения для проверки webhook-подписей.
  4. После изменения scopes переустановите/переавторизуйте приложение согласно документации Shopify.

Не указывайте публичный домен витрины вместо постоянного домена myshopify.com.

Required configuration

  • SHOPIFY_STORE_DOMAIN — Домен магазина: Постоянный домен магазина вида store.myshopify.com без протокола и пути.
  • SHOPIFY_ADMIN_ACCESS_TOKEN — Токен доступа Admin API: Токен установленного приложения с минимально необходимыми Admin API scopes.
  • SHOPIFY_API_SECRET — Секрет API: Client secret приложения Shopify для проверки HMAC входящих webhook-запросов.

Stripe

Groups: Платежи

Интеграция со Stripe для платежей, клиентов, Checkout, подписок, счетов, возвратов и событий webhook.

Как подключить

  1. В Stripe Workbench/Dashboard создайте restricted API key с минимальными правами. Если это невозможно, используйте secret key только на backend.
  2. Создайте webhook endpoint, выберите необходимые типы событий и зафиксируйте его API version.
  3. Скопируйте API key и signing secret этого endpoint с префиксом whsec_.
  4. Сначала проверьте интеграцию в test mode, затем отдельно укажите live credentials для production.

Секрет Stripe CLI и secret dashboard webhook — разные значения; не смешивайте их.

Required configuration

  • STRIPE_SECRET_KEY — Секретный или ограниченный API-ключ: Server-side ключ Stripe (rk_... предпочтительно или sk_...) для нужного test/live режима.
  • STRIPE_WEBHOOK_SECRET — Секрет подписи вебхука: Signing secret конкретного webhook endpoint с префиксом whsec_.

Twilio

Groups: Телефония и контакт-центры

Интеграция с Twilio для SMS, WhatsApp, голосовых звонков, номеров и других коммуникационных API.

Как подключить

  1. В Twilio Console скопируйте Account SID.
  2. Для production создайте Standard или Restricted API Key и сохраните его Secret.
  3. Скопируйте Auth Token аккаунта отдельно — он нужен для проверки подписи webhook.
  4. Укажите все четыре значения.

Для исходящих API-запросов используйте API Key/Secret; Account SID/Auth Token оставьте для локального тестирования и валидации webhook.

Required configuration

  • TWILIO_ACCOUNT_SID — SID аккаунта: Account SID вида AC... из Twilio Console.
  • TWILIO_API_KEY — SID API-ключа: Production API Key SID с минимально необходимыми правами.
  • TWILIO_API_SECRET — Секрет API-ключа: Секрет API Key, показываемый при создании ключа.
  • TWILIO_AUTH_TOKEN — Токен авторизации: Auth Token аккаунта для проверки подписи входящих webhook-запросов.

VK API

Groups: Мессенджеры, соцсети и почта

Интеграция с VK API для сообществ, сообщений, публикаций, комментариев, пользователей и событий Callback API.

Как подключить

  1. В настройках сообщества VK откройте Работа с API → Ключи доступа и создайте токен сообщества с нужными правами.
  2. Скопируйте числовой ID сообщества без знака минус.
  3. В разделе Callback API создайте сервер, задайте секретный ключ и скопируйте строку подтверждения.
  4. Укажите четыре значения ниже и подпишитесь только на нужные типы событий.

Токен пользователя и токен сообщества имеют разные права; для сообщений сообщества используйте токен сообщества.

Required configuration

  • VK_ACCESS_TOKEN — Токен сообщества: Токен сообщества VK с минимально необходимыми разрешениями.
  • VK_GROUP_ID — ID сообщества: Числовой ID сообщества VK без ведущего минуса.
  • VK_CALLBACK_SECRET — Секрет Callback API: Секретный ключ сервера Callback API из настроек сообщества.
  • VK_CALLBACK_CONFIRMATION_CODE — Строка подтверждения: Строка, которую VK требует вернуть при подтверждении Callback API сервера.

Vonage

Groups: Телефония и контакт-центры

Интеграция с Vonage для SMS, Messages, WhatsApp, Verify и Voice API, включая статусы и входящие webhooks.

Как подключить

  1. В Vonage Dashboard скопируйте API Key и API Secret.
  2. Для Messages/Voice создайте Application, сохраните Application ID и приватный RSA-ключ.
  3. Включите signed webhooks и скопируйте Signature Secret.
  4. Укажите доступные значения ниже; конкретный API использует Basic auth либо JWT согласно документации.

Приватный ключ и Signature Secret — разные секреты и используются для разных направлений проверки.

Required configuration

  • VONAGE_API_KEY — API-ключ: API Key аккаунта Vonage.
  • VONAGE_API_SECRET — Секрет API: API Secret аккаунта Vonage для Basic authentication.
  • VONAGE_APPLICATION_ID — Идентификатор приложения: UUID приложения Vonage для Messages/Voice и JWT-аутентификации.
  • VONAGE_PRIVATE_KEY_PEM — Приватный ключ: Приватный RSA-ключ приложения Vonage в PEM.
  • VONAGE_SIGNATURE_SECRET — Секрет подписи вебхука: Signature Secret из настроек signed webhooks.

WhatsApp Business Platform

Groups: Мессенджеры, соцсети и почта

Интеграция с WhatsApp Business Platform Cloud API для сообщений, шаблонов, медиа, статусов доставки и webhook-событий.

Как подключить

  1. В Meta Business создайте приложение с продуктом WhatsApp и подключите WhatsApp Business Account.
  2. Скопируйте WABA ID и Phone Number ID.
  3. Для production создайте System User access token с минимальными правами; временный тестовый токен не подходит.
  4. Скопируйте App Secret и придумайте webhook verify token.
  5. Настройте HTTPS webhook и подпишитесь на поле messages.

До отправки сообщений вне 24-часового окна создайте и одобрите шаблоны и получите согласие получателей.

Required configuration

  • WHATSAPP_BUSINESS_ACCOUNT_ID — Идентификатор аккаунта WhatsApp Business: ID WhatsApp Business Account в Meta Business.
  • WHATSAPP_PHONE_NUMBER_ID — Идентификатор номера телефона: ID подключённого телефонного номера Cloud API.
  • WHATSAPP_ACCESS_TOKEN — Токен доступа системного пользователя: Долгосрочный токен System User с нужными разрешениями WhatsApp.
  • WHATSAPP_APP_SECRET — Секрет приложения: App Secret приложения Meta для проверки webhook-подписи.
  • WHATSAPP_WEBHOOK_VERIFY_TOKEN — Токен проверки вебхука: Случайная строка для первоначальной проверки webhook endpoint.

Wildberries API

Groups: Интернет-магазины и маркетплейсы

Интеграция кабинета продавца Wildberries: товары, цены, остатки, поставки, заказы, продажи, отчёты и реклама.

Как подключить

  1. В кабинете продавца Wildberries создайте API-токен.
  2. Выберите только необходимые категории доступа; для аналитики используйте read-only права.
  3. Скопируйте токен и укажите его ниже.

Разные группы методов работают на разных доменах и имеют независимые лимиты. Не передавайте токен в query-параметрах.

Required configuration

  • WILDBERRIES_API_TOKEN — API-токен продавца: Токен из кабинета продавца Wildberries с минимально необходимыми категориями доступа.

Яндекс Почта

Groups: Мессенджеры, соцсети и почта

Чтение и обработка писем через IMAP и отправка сообщений через SMTP в Яндекс Почте.

Как подключить

  1. В настройках Яндекс Почты разрешите доступ почтовых программ по IMAP.
  2. В Яндекс ID создайте отдельный пароль приложения типа «Почта».
  3. Укажите полный адрес ящика и этот пароль. Обычный пароль аккаунта не используйте.

Подключение выполняется по TLS: IMAP imap.yandex.ru:993, SMTP smtp.yandex.ru:465.

Required configuration

  • YANDEX_MAIL_EMAIL — Адрес почты: Полный адрес ящика Яндекс Почты.
  • YANDEX_MAIL_APP_PASSWORD — Пароль приложения: Отдельный пароль приложения типа «Почта» из Яндекс ID.

ЮKassa

Groups: Платежи

Интеграция с ЮKassa для платежей, возвратов, чеков, способов оплаты, выплат и входящих уведомлений.

Как подключить

  1. В личном кабинете ЮKassa откройте настройки интеграции.
  2. Скопируйте Shop ID.
  3. Выпустите Secret Key и сразу сохраните его.
  4. Настройте HTTPS URL уведомлений и выберите нужные события.
  5. Укажите Shop ID и Secret Key ниже.

Сначала используйте тестовый магазин. Боевые операции включайте только после проверки идемпотентности и обработки уведомлений.

Required configuration

  • YOOKASSA_SHOP_ID — Идентификатор магазина: Идентификатор магазина ЮKassa из личного кабинета.
  • YOOKASSA_SECRET_KEY — Секретный ключ: Секретный ключ магазина ЮKassa для server-side API.

Zendesk

Groups: CRM, продажи и поддержка

Интеграция с Zendesk Support для работы с тикетами, пользователями, организациями, комментариями, вложениями, аудитом и webhooks.

Как подключить

  1. Создайте OAuth client в Zendesk Admin Center и пройдите OAuth authorization code flow, либо получите заранее выданный OAuth access token для server-side интеграции.
  2. Укажите постоянный subdomain аккаунта (часть до .zendesk.com) и access token.
  3. Выдавайте только необходимые scopes и используйте отдельного интеграционного пользователя.

Не используйте пароль агента. API token с email/token допустим только для старых внутренних интеграций; OAuth предпочтительнее.

Required configuration

  • ZENDESK_SUBDOMAIN — Поддомен: Часть адреса Zendesk до .zendesk.com, например company.
  • ZENDESK_OAUTH_ACCESS_TOKEN — OAuth-токен доступа: OAuth access token отдельного интеграционного пользователя с минимальными scopes.