Bring your own key (BYOK) означает, что VivaDialog отправляет ваши ответы ИИ через API-ключ из вашего собственного аккаунта у OpenRouter, OpenAI, DeepSeek, Groq или Google Gemini. Вы платите этому провайдеру напрямую, сами выбираете модель, и такие ответы не расходуют месячную квоту ответов ИИ и лимит использования ИИ в тарифе. Ответы ИИ и так входят в каждый тариф, поэтому BYOK необязателен. Он полезен, когда вам нужна конкретная модель, когда вы уже платите провайдеру или когда квоты тарифа не хватает. В этой статье перечислено, где ключ используется, где нет и что всё равно может остановить ответ.
Что меняется, когда ключ включён
| Встроенный ИИ | Ваш собственный ключ | |
|---|---|---|
| Кто платит за ИИ | Входит в ваш тариф | Вы, провайдеру |
| Расходует квоту ответов ИИ в тарифе | Да | Нет |
| Расходует лимит использования ИИ в тарифе | Да | Нет |
| Модель | Выбирает VivaDialog | Идентификатор модели, который вы вводите |
Квоты тарифов на момент написания, со страницы цен: 200 ответов ИИ в месяц на Starter, 1 000 на Growth, 3 000 на Pro, 8 000 на Premium и 100 во время 14-дневного бесплатного пробного периода. Ваш собственный ключ в эти числа не входит. Диалоги при этом всё равно считаются: ответ ИИ является автоматическим ответом, поэтому первый ответ в переписке расходует один из месячных диалогов вашего тарифа, каким бы ключом он ни был написан. Правило объяснено в статье Что считается диалогом.
Где используется ваш ключ
Эти случаи названы на справочных страницах самого продукта. Правило, которое это определяет, мы проверили в коде API 3 ноября 2026 года.
| Работа ИИ | Используется ли ваш ключ? |
|---|---|
| Автоматизация, которая отвечает с помощью ИИ в Facebook, Instagram, Threads, Telegram или по email | Да |
| Проверки намерения, определяющие, подходит ли автоматизация | Да, в каждом канале, кроме чата на сайте |
| AI Agent отвечает на личное сообщение по записям вашей «Базы знаний» | Да, в каждом канале, кроме чата на сайте |
| Черновики Написать с ИИ во «Входящих» | Да |
| Краткие сводки переписок от ИИ | Да |
| Автоматические ответы ИИ и проверки намерения в чате на сайте | Нет. Они всегда работают на ИИ VivaDialog и квоте тарифа |
Код проводит одну границу. Ответ, который уходит сам посетителю чата на сайте, использует ИИ VivaDialog. Всё, что человек читает в панели управления, прежде чем действовать, например черновик или сводка, использует ваш ключ в любом канале. Сторона чата на сайте описана в статье Добавьте чат на свой сайт.
Работает ли это по email?
Да. В коде из BYOK исключён только чат на сайте. Ответ ИИ на письмо, написанный автоматизацией, идёт через ваш ключ так же, как ответ ИИ на личное сообщение в Instagram.
Два других ограничения для email с ключом не связаны. Email входит в тариф начиная со Starter, и один адрес получает не больше 3 автоматических ответов в день из одного и того же почтового ящика. На некоторые письма автоматический ответ не отправляется вообще: автоматические сообщения, рассылки, уведомления о недоставке и адреса «no-reply». Подробности в статье Подключение почтового ящика.
Если вы искали «BYOK email», имея в виду собственный почтовый ящик, это другое. Свой ящик Gmail, Zoho Mail или другой ящик с IMAP и SMTP вы подключаете в разделе Настройки, Каналы с паролем приложения, и ответы уходят с вашего адреса. Ключ ИИ задаётся в другом месте: Настройки, ИИ.
Добавьте свой ключ
Добавлять и менять ключ могут только владельцы и администраторы рабочего пространства.
- Создайте API-ключ в панели управления вашего провайдера. Убедитесь, что в аккаунте есть средства или настроена оплата, потому что провайдер берёт плату за каждый запрос.
- В VivaDialog откройте Настройки, перейдите в ИИ и найдите карточку Ответы ИИ. В разделе Свой ключ ИИ выберите Провайдер.
- Введите идентификатор Модель точно так, как провайдер пишет его на странице моделей. В форме есть ссылка на список моделей провайдера.
- Вставьте ключ в поле API-ключ без пробелов и нажмите Сохранить ключ.
- Нажмите Проверить ключ. VivaDialog отправит один очень короткий запрос. Если провайдер его отклонит, вы увидите собственное сообщение провайдера, где обычно сказано, в чём проблема: в ключе, в идентификаторе модели или в балансе аккаунта.
После сохранения ключ больше не показывается, даже частично. Он хранится в зашифрованном виде и используется только для отправки запросов ИИ выбранному вами провайдеру. Статус выглядит так: Ваш ключ включён. Ответы ИИ теперь идут через него. Скриншоты каждого шага есть в статье Свой ключ ИИ (BYOK).
Чтобы перестать им пользоваться, не теряя ключ, нажмите Выключить. Ответы ИИ вернутся к квоте тарифа. Заменить ключ меняет ключ, провайдера или модель, а Удалить стирает его.
Что всё же может остановить ответ
- Провайдер отказывает. Если баланс закончился или ключ удалён, этот ответ ИИ не отправляется, а VivaDialog не переключается на свой встроенный ИИ. В Истории автоматизации в результате видно, что провайдер ИИ вернул ошибку. Если у автоматизации после ответа ИИ есть ответ фиксированным текстом, этот текст всё равно уходит.
- Проверка результата. Автоматические ответы проходят фильтр перед отправкой. По коду, ссылка, адрес электронной почты или номер телефона, которых вы не вписали в автоматизацию или в запись «Базы знаний», останавливают ответ, каким бы ключом он ни был написан.
- Ограничение длины. По коду, у провайдера запрашивается не больше 300 токенов на ответ, поэтому длинный ответ может быть обрезан.
- Рабочее пространство только для чтения. Если пробный период или тариф закончился, ответ ИИ не отправляется, с вашим ключом или без него.
- Квота диалогов. Когда она исчерпана, автоматизации и ИИ перестают отвечать в новых диалогах до её обновления.
Ответы, использующие ваш ключ, показаны в Истории автоматизации как Отправлено (ваш ключ ИИ). Там можно проверить, что ключ действительно работает.
Кто управляет ключом
Ключ принадлежит рабочему пространству, и важно, кто его сохранил. Код использует его, только пока этот человек остаётся владельцем или администратором, а если человека убрать из рабочего пространства, его ключ удаляется вместе с ним. Если состав команды меняется, проверьте ключ ещё раз и замените его под своим логином. Что ещё уходит вместе с участником, перечислено в статье Участники команды и роли.
При использовании вашего ключа текст сообщения клиента и инструкции автоматизации уходят выбранному вами провайдеру на условиях этого провайдера. Проверьте в своём аккаунте у провайдера настройки хранения данных и обучения.
Частые вопросы
Нужен ли мне собственный ключ, чтобы пользоваться ответами ИИ?
Нет. В каждый тариф входят ответы ИИ с месячной квотой. Что будет, когда она закончится, объяснено в статье Ответы ИИ и ваша квота. Собственный ключ служит альтернативой, а не обязательным условием.
Можно ли использовать ChatGPT или ключ OpenAI?
OpenAI входит в число пяти провайдеров. VivaDialog принимает API-ключ из панели управления вашего провайдера и не входит в чат-продукт. Выберите OpenAI в качестве провайдера и введите идентификатор модели OpenAI.
Какие модели можно выбрать?
Идентификатор модели вы вводите сами так, как его пишет ваш провайдер. VivaDialog не ведёт список моделей, поэтому сверьте идентификатор со страницей моделей вашего провайдера. Если модель не принята, Проверить ключ покажет собственное сообщение провайдера.
Можно ли указать другого провайдера или свой сервер?
Нет. Пять перечисленных выше провайдеров заданы в продукте жёстко.
Продолжит ли мой ключ работать, если владелец сменится?
Только пока человек, который его сохранил, остаётся владельцем или администратором. Если его удалить, ключ удалится вместе с ним, поэтому сохраните его заново из аккаунта действующего владельца или администратора.
Сделает ли это автоответы дешевле?
Это зависит от цен вашего провайдера, которые меняются и не входят в цены VivaDialog. Сравните цену провайдера за запрос с квотой тарифа, которую вы иначе расходовали бы. О том, как сравниваются тарифы, читайте в статье Фиксированная ежемесячная цена или оплата за контакт.
VivaDialog сейчас в раннем доступе, и участники получают тариф Growth бесплатно на 30 дней. Подробности на странице цен.