ДокументацияНастройка проекта

Интеграции

для администратора школыПройти по шагам в Академии

Раздел «Интеграции» есть только у администратора. В нём до четырёх вкладок:

  • Эквайринг — открывается первой: платёжки, товары и все оплаты проекта. Подробно — Эквайринг.
  • Телефония — АТС проекта — МТС Exolve, Mango Office, Новофон, UIS, Sipuni, Телфин, МегаФон или onlinePBX: звонки из TERVIO, журнал и записи разговоров. Вкладка есть, когда подключён модуль «Отдел продаж». Подробно — Телефония.
  • Озвучка — ключ ElevenLabs, голос и модель для голосовых из текста. Подробно — Голосовые из текста.
  • Отправка событий — адреса, куда TERVIO сам отправляет события воронок, оплат и сделок — в вашу аналитику, n8n или BI, пачкой или по одному, с подписью. Подробно — Отправка событий.

Вебхуки, GetCourse и SMSC с ноября 2026 — в «Сценарии» → «Подключения»: ими пользуются только воронки. Старые ссылки на них открывают новое место сами. Адреса и токены входящих вебхуков — там, в плитке «Вебхуки TERVIO». Токены секретные: не публикуйте их и не пересылайте в общие чаты.

Запуск воронки из внешнего сервиса

  • Единый вебхук сценариев — POST /api/webhooks/event, заголовок X-Event-Token, тело event_key + lead + необязательные vars. Ключ должен совпадать с event_key в стартовом блоке сценария. Обычный запуск останавливает активные воронки клиента, а старт с «Не состояние» выполняется поверх них.
  • Повтор события и ответ — необязательное поле event_id — номер события, например заказа. Старт с «Повторным запуском» «При каждом событии» узнаёт по нему повтор: тот же номер, доставленный дважды, второй прогон не заведёт, а без номера повтором считается такое же событие в течение 10 минут. В режиме «Только один раз» (так по умолчанию) воронка запускается на клиенте один раз. В ответе run_started говорит, запустилась ли воронка, а repeat: true — что не запустилась: уже была у клиента, это повтор или не пустил «Повторный запуск» старта. Подробно — Сценарии.
  • Когда адрес отказывает — события принимаются, только пока в проекте работают «Воронки TERVIO» — их состояние видно в «Настройках» → «Проект» → «Воронка». Выключены — внешний сервис получает отказ на каждый вызов, и воронки по событиям не запускаются. Включает их поддержка платформы.
  • Телефон из анкеты — передайте его в vars под именем phone, «телефон» или «номер_телефона» — номер ляжет в карточку клиента, если там пусто. Так же работает ответ клиента, сохранённый в переменную с таким именем в сценарии. По этому номеру TERVIO ищет клиента и привязывает звонки к сделке.

Анкета с сайта

  • Адрес — POST /api/webhooks/anketa, тот же заголовок X-Event-Token, тело lead + answers «вопрос → ответ». Форма присылает ответы — TERVIO кладёт их в переписку примечанием «Анкета», групповому чату ставит этап «Сдал анкету» и пишет номер в карточку. Воронку настраивать не нужно, анкета принимается и при выключенных «Воронках TERVIO».
  • Как TERVIO узнаёт человека — добавьте в ссылку на анкету его id — …/anketa?tg_id={tg_id}: воронка подставит его сама, а форма вернёт в lead.tg_id.
  • Ещё и воронка — передайте в поле event_key ключ события — TERVIO запустит воронку с этим ключом (если «Воронки TERVIO» работают), ответы будут в её переменных. Форма умеет только присылать событие — возьмите шаблон «Анкета с сайта» в «Сценариях» → «Шаблоны». Подробно — Анкеты.

Что в карточке адреса

  • Подключение — «Полный URL», «Заголовок» и «Токен», у каждого — «Копировать»; «Заголовки одним блоком» — готовый JSON для вставки во внешний сервис. У событий и анкеты токен общий.
  • Поля запроса и пример — раскрываются под адресом: какие поля обязательны, пример тела и что придёт в ответ.
  • Строка состояния сверху — «Токены вебхуков настроены» или «Токены вебхуков не настроены — запросы будут отклоняться». Второе значит, что внешний сервис будет получать отказ на каждый вызов, даже если у него всё правильно. Токены выдаёт платформа: напишите в поддержку, а настраивайте ту сторону уже потом.