Интеграции

Блоки интеграций связывают бота с внешним миром: CRM, Google Таблицы и Календарь, платежи ЮKassa, произвольные HTTP-запросы и уведомления менеджеру.

Создать лида в CRM

Заводит новую сделку во встроенной CRM botvk — в выбранной воронке и на выбранном этапе.

Настройки:

• «Воронка» — выпадающий список воронок пространства.
• «Этап (необязательно)» — список этапов выбранной воронки; по умолчанию — первый этап.
• «Название сделки (необязательно)» — например: Заявка от {first_name}.
• «Сумма (необязательно)» — например {order_total}.

Webhook (HTTP-запрос)

Отправляет POST- или GET-запрос на внешний URL с переменными сценария.

Настройки:

• «URL» — HTTPS-адрес, на который бот пошлёт запрос; может содержать переменные сценария в фигурных скобках.
• «Метод» — POST (по умолчанию) или GET. POST отправляет тело JSON, GET — только URL с query-параметрами.
• «Тело запроса (JSON, для POST)» — значения могут быть переменными сценария, например {"name": "{first_name}", "phone": "{phone}"}. Если оставить пустым — отправится стандартный профиль подписчика.

API-запрос

HTTP-запрос к внешнему сервису: ответ сохраняется в переменную, сценарий ветвится по результату.

Настройки:

• «Метод» — GET (по умолчанию) / POST / PUT / DELETE. GET — без тела, POST и PUT отправляют JSON.
• «URL» — полный адрес запроса; можно подставлять переменные в фигурных скобках.
• «Заголовки» — формат «Имя: значение», по одному в строке, например Authorization: Bearer {token}; можно подставлять переменные.
• «Тело запроса (JSON)» — только для не-GET; подставляются переменные.
• «Сохранить ответ в переменную» — тело ответа (JSON) попадёт в переменную (по умолчанию response); к полям обращайтесь как {response.field} в следующих блоках.

Выходы: «Успех» и «Ошибка». Ответ со статусом 2xx уходит в ветку «Успех», любой другой — в «Ошибка».

Уведомить менеджера в VK

Шлёт сообщение администратору сообщества в личные сообщения VK — например, о новой заявке.

Настройки:

• «Текст уведомления» — например: Новая заявка от {first_name}. Телефон: {phone}.
• «VK ID менеджера (необязательно)» — по умолчанию уведомление получает тот, кто подключил сообщество.

VK доставит сообщение, только если у менеджера открыт диалог с сообществом.

amoCRM: создать сделку

Создаёт сделку в amoCRM. Ключи интеграции задаются один раз в Настройки → Интеграции и используются всеми ботами пространства.

Настройки:

• «Название сделки/лида» — заголовок, под которым сделка появится в CRM; можно вставлять переменные, например Заявка от {first_name}.
• «Комментарий (необязательно)» — уйдёт в примечание к сделке; поддерживает переменные.
• «Переменная с телефоном (необязательно)» — имя переменной с собранным номером (например, phone после блока «Запросить значение» с типом «Телефон»).

Bitrix24: создать лид

Создаёт лид в Bitrix24 через входящий вебхук, который настраивается в Настройки → Интеграции.

Настройки: те же три поля, что и у amoCRM — «Название сделки/лида», «Комментарий (необязательно)», «Переменная с телефоном (необязательно)».

Google Sheets: строка

Добавляет строку в таблицу Google. Подключение таблицы — в Настройки → Интеграции, через ваш Google-аккаунт.

Настройки:

• «Лист / диапазон» — имя листа (например, «Лист1») или диапазон в нотации Google Sheets (например, Лист1!A:E).
• «Колонки строки» — список пар «колонка → значение» (кнопка «+ Колонка»), например A · Имя → {first_name}. Значения запишутся в строку слева направо (A, B, C…).

Запись в Google Календарь

Показывает подписчику свободные дни и время из Google Календаря, записывает его кнопками и создаёт событие в календаре. Внутри — гибкое расписание: длительность услуги и шаг слотов, рабочие часы по дням недели с перерывами, выходные и праздники, буферы до/после записи, горизонт записи, количество мест на слот, подтверждение и напоминания, настраиваемые тексты и переменные {booking_date}, {booking_time}, {event_id}.

Выходы: «Записан», «Отменил», «Нет мест», «Ошибка».

Отмена записи

Отменяет запись клиента — удаляет событие в Google Календаре по сохранённому id.

Настройки:

• «Переменная с id записи» — та же переменная, что в блоке «Запись в Google Календарь» в поле «id события»; по умолчанию event_id.
• «Текст при отмене» — например: «Ваша запись отменена.».
• «Текст при ошибке / нет записи» — например: «Не нашли активную запись для отмены.».

Выходы: «Отменено» и «Ошибка».

Поставьте блок после триггера с ключевой фразой «отменить запись», чтобы клиент мог отменить запись сам.

YooKassa: оплата

Создаёт платёж в ЮKassa, шлёт подписчику ссылку на оплату и ждёт результата; сценарий ветвится по исходу. Ключи ЮKassa (shopId и секретный ключ) задаются в Настройки → Интеграции.

Настройки:

• «Сумма, ₽» (обязательное) — число или переменная в фигурных скобках, например 1990 или {total}; подставится сумма из сценария на момент платежа.
• «Описание платежа» — видно подписчику в форме оплаты и в чеке; можно использовать переменные.
• «Сохранить id платежа в переменную (необязательно)» — идентификатор платежа YooKassa (например, payment_id); пригодится для возврата или проверки статуса в следующих блоках.

Выходы: «Оплачено» и «Не оплачено».