Docs

Подключения

Интеграции и окружение

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

Подключение внешнего сервиса

Откройте Integrations внутри проекта, чтобы увидеть каталог, включённый администратором Amazi. Подключение принадлежит всему проекту, а не одному чату или приложению. Для создания, замены и просмотра защищённых значений нужны Full access или права владельца. Просмотр каталога доступен без функции встроенных интеграций; для открытия сведений об управляемой интеграции и подключения нужна эта функция тарифа владельца проекта. Ограничение не запрещает агенту разрабатывать код приложения. Использование внешнего сервиса по-прежнему требует доступа к нему и рабочего подключения.

Выберите All или вкладку группы, чтобы отфильтровать каталог. Рядом с названием каждой группы показана иконка в заданном для неё цвете.

В шапке интеграции показаны логотип, название и статус подключения. Под названием перечислены группы через запятую; если группы нет, отображается Другие интеграции. Стрелка назад возвращает в каталог. У подключённого сервиса кнопка Отключить находится в шапке, а Обновить подключение — возле формы с данными. Отключение требует подтверждения и не меняет код приложения автоматически.

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

Подключение или пропуск интеграции появляется в сводке работы чата. Там же сохраняется результат защищённого запроса переменных окружения: сохранение или пропуск. История показывает названия и результат действия без секретных значений.

Чтобы указать сервис в запросе, введите @ в чате проекта и выберите его из списка интеграций. Подключённые сервисы идут первыми и отмечены меткой. Упоминание вставляет название в черновик; подключение выполняется отдельно. Подробнее — в разделе Агент и чат.

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

Раздел Environment

Environment объединяет:

  • пользовательские значения проекта;
  • переменные интеграций;
  • управляемые значения платформы.

Участники с правом просмотра видят названия и источники. Раскрывать и менять защищённые значения могут только роли с управлением окружением. Переменные интеграции редактируются в своём подключении и не дублируются как ручные. Фиксированные значения runtime можно раскрыть в Environment; участники с нужными правами также могут увидеть текущий DATABASE_URL приложения — владельца управляемой базы, когда значение доступно. Фиксированные значения нельзя редактировать.

Amazi может самостоятельно привязать переменную уже подключённой интеграции к приложениям, не раскрывая и не меняя её значение. Попросите обновить список приложений для переменной; копировать токен вручную или редактировать значения интеграции для этого не требуется.

Для каждой пользовательской переменной, переменной интеграции, Gateway и Voice явно выбираются приложения. Переменную получают только выбранные приложения — в development и в следующем production-релизе. Vite открывает браузерному коду только имена с VITE_; Amazi не переименовывает переменные. Управляемые runtime-секреты существуют отдельно: подходящие серверные приложения получают credentials хранилища, а DATABASE_URL получает только владелец управляемой базы.

Разработка и production

Изменение переменной согласуется с сохранённым runtime разработки. Активный production-релиз продолжает использовать снимок окружения своей сборки, поэтому для новых значений опубликуйте обновление всего проекта. При этом Amazi не переписывает принадлежащие проекту env-файлы. Amazi AI Gateway настраивается отдельно.

Доступные интеграции

Bitrix24

Группы: CRM, продажи и поддержка

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

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

Необходимые настройки

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

МойСклад

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

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

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

Необходимые настройки

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

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

Группы: Маркетинг и аналитика

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

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

Необходимые настройки

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

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

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

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

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

Необходимые настройки

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

Telegram Bot

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

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

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

Необходимые настройки

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

Google Drive & Sheets

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

Даёт агенту доступ к выбранным папкам и файлам 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.

Необходимые настройки

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

Notion

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

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

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

Необходимые настройки

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

GitHub

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

Подключает репозитории, код, 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, дождитесь одобрения администратора.

Необходимые настройки

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

Slack

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

Позволяет агенту читать доступные каналы и треды, отправлять и обновлять сообщения и выполнять разрешённые действия от имени 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 и пригласите бота в нужные каналы.

Необходимые настройки

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

HubSpot

Группы: CRM, продажи и поддержка

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

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

Необходимые настройки

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

Eptera Booking API

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

Подключает 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 здесь.

Необходимые настройки

  • 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С-Битрикс: Управление сайтом

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

Подключает собственный сайт или интернет-магазин на 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. Выдавайте только нужные приложению права. При отзыве приложения или смене ключа обновите все связанные значения; не публикуйте токены в коде, браузере или логах.

Необходимые настройки

  • 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С:Предприятие

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

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

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

Необходимые настройки

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

amoCRM

Группы: CRM, продажи и поддержка

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

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

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

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

Необходимые настройки

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

Asterisk

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

Подключение к 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-подключение для событий.

Необходимые настройки

  • 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

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

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

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

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

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

Необходимые настройки

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

Confluence Cloud

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

Подключение к 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. После истечения срока выпустите новый токен и замените значение интеграции.

Необходимые настройки

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

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

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

Интеграция с 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 и полученные токены должны храниться только на сервере. Для подписания документов дополнительно потребуются сертификат, права и соблюдение регламентов конкретного документооборота — эта карточка не заменяет их настройку.

Необходимые настройки

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

Discord

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

Подключение 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-подпись каждого запроса.

Необходимые настройки

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

Genesys Cloud

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

Серверная интеграция с 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 клиента вслепую.

Необходимые настройки

  • 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

Группы: Маркетинг и аналитика

Подключение к 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 и замените ключ при компрометации.

Необходимые настройки

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

iikoCloud API

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

Подключение к 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 вручную не требуется.

Необходимые настройки

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

Instagram Messaging API

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

Подключение профессионального аккаунта 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; она не предназначена для произвольных массовых рассылок.

Необходимые настройки

  • 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

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

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

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

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

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

Необходимые настройки

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

Контур API

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

Подключение к 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-ключа для всех продуктов. Сверяйте параметры с документацией выбранного сервиса.

Необходимые настройки

  • 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

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

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

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

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

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

Необходимые настройки

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

MANGO OFFICE

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

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

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

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

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

Необходимые настройки

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

MAX Bot API

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

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

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

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

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

Необходимые настройки

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

Мегаплан

Группы: CRM, продажи и поддержка

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

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

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

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

Необходимые настройки

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

Meta Messenger Platform

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

Интеграция 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.

Необходимые настройки

  • 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

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

Интеграция с 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 согласно сценарию.

Необходимые настройки

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

Mindbox

Группы: Маркетинг и аналитика

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

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

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

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

Необходимые настройки

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

Ozon Seller API

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

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

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

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

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

Необходимые настройки

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

retailCRM

Группы: CRM, продажи и поддержка

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

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

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

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

Необходимые настройки

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

Roistat

Группы: Маркетинг и аналитика

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

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

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

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

Необходимые настройки

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

Salesforce

Группы: 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.

Необходимые настройки

  • 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

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

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

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

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

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

Необходимые настройки

  • 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

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

Интеграция магазина 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.

Необходимые настройки

  • 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

Группы: Платежи

Интеграция со 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 — разные значения; не смешивайте их.

Необходимые настройки

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

Twilio

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

Интеграция с 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.

Необходимые настройки

  • 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

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

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

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

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

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

Необходимые настройки

  • 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

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

Интеграция с 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 — разные секреты и используются для разных направлений проверки.

Необходимые настройки

  • 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

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

Интеграция с 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-часового окна создайте и одобрите шаблоны и получите согласие получателей.

Необходимые настройки

  • 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

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

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

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

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

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

Необходимые настройки

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

Яндекс Почта

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

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

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

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

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

Необходимые настройки

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

ЮKassa

Группы: Платежи

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

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

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

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

Необходимые настройки

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

Zendesk

Группы: 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 предпочтительнее.

Необходимые настройки

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