Как собрать первое приложение для Битрикс24 в Вайбкоде

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

Порядок работы

1. Создайте ключ в кабинете Вайбкода и отметьте только те права, которые нужны задаче. Ключ показывается один раз, скопируйте его сразу.
2. Передайте ключ ИИ-агенту вместе со ссылкой на описание платформы. Агент по ней получит список возможностей и правила работы.
3. Опишите задачу обычными словами: что приложение должно показывать или делать, кому и откуда брать данные.
4. Дождитесь публикации. Если нужна серверная часть, агент сам поднимет сервер и выложит приложение.
5. Проверьте результат на реальных данных: права доступа, пустые значения, крайние случаи и поведение под другим сотрудником.

Какой ключ выбрать

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

Личный ключ подходит для скриптов, дашбордов и ботов, которые работают от имени одного человека. Встроить такое приложение во вкладку карточки сделки не получится. Ключ приложения с авторизацией нужен как раз тогда, когда решение должно открываться в интерфейсе портала: в меню, в карточке CRM, в виде виджета. Менеджмент-ключ к данным портала вообще не ходит, он для администрирования: управлять ключами, смотреть подключённые порталы, обращаться в поддержку.

У ключа есть режим доступа. По умолчанию он позволяет и читать, и писать, но для первых экспериментов разумнее поставить режим только для чтения: тогда ошибка агента в худшем случае покажет неверные цифры, а не изменит данные в CRM. Попытка записи в этом режиме вернёт понятную ошибку.

Где будет работать приложение

Если это страница на HTML и JavaScript без серверной логики, она размещается прямо в Битрикс24. Если нужны база данных, обработка событий портала, фоновые задачи или чат-бот, приложение запускается на сервере платформы. Агент решает это сам и при необходимости создаёт сервер, но полезно понимать разницу: серверные приложения расходуют вайбы за время работы машины.

Что проверить после того, как всё заработало

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

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

Из чего состоит платформа и сколько стоит, разобрали в материале Битрикс24 Вайбкод.