Интеграции с вашими системами
Как связать платформу с вашими системами: вебхуки и коннекторы для данных, плагины для обработки внутри контура — и как выбрать между ними.
Звонок живёт своей жизнью: бот собрал ответ, проверил договор, записал результат. Чтобы эти события попадали в вашу CRM, биллинг или таблицу — и чтобы бот мог спросить вашу систему прямо во время разговора — у платформы есть два механизма. Они решают разные задачи и не заменяют друг друга.
Коротко: две половины одной темы
- Вебхук (коннектор) — данные клиента уходят к вам: платформа обращается на ваш URL — создать сделку в CRM, проверить баланс, уведомить вашу систему о статусе звонка.
- Плагин — код клиента исполняется у нас: ваш модуль работает внутри платформы в изолированной песочнице — распарсить ответ, сверить со справочником, замаскировать персональные данные, обогатить реплику. Персональные данные абонента при этом не покидают наш контур. Первая точка доступна: преобразование ответа webhook-узла — статье о плагинах.
Сравнение
| Вебхук / коннектор | Плагин | |
|---|---|---|
| Что делает ваша команда | ничего не программирует: адрес, ключи, маппинг полей | пишет модуль (компилируется в вебассемблер — WASM) |
| Где исполняется логика | на вашей площадке, у ваших API | у нас, в песочнице с жёсткими лимитами памяти и времени |
| Куда идут данные абонента | наружу, в вашу систему | не покидают защищённый контур платформы |
| Скорость ответа | сеть: сотни миллисекунд — секунды | вызов в памяти: единицы миллисекунд |
| Что закрывает | интеграцию: создать/прочитать запись в CRM, 1С, таблице | обработку: распарсить, проверить, замаскировать, обогатить |
| Что при сбое | таймаут, повторы, фраза-заполнитель в разговоре | предохранитель: серия отказов отключает модуль, звонок не страдает |
Как выбрать. Нужна запись в вашу CRM по итогам звонка или вопрос к вашей системе во время разговора — это вебхук. Данные имеют неудобный формат, отдавать их наружу нельзя или обработка должна быть быстрой — это плагин. Типичная связка: плагин приводит ответ абонента в порядок прямо в звонке, вебхук фиксирует итог в CRM после него.
Вебхуки и коннекторы — доступно сейчас
Галерея коннекторов
В редакторе сценария — «Добавить узел» → «Коннекторы» — готовые пресеты: Битрикс24, amoCRM, Google Sheets, 1С, произвольный REST. Коннектор — преднастроенный вебхук-узел: выберите пресет, заполните поля (адрес, имя секрета), и узел появится в сценарии; останется подключить его к соседним репликам.
Секреты
Ключи API хранятся в разделе «Секреты» (экран «Настройки»), в
сценарии используются по имени ({{ secret.имя }}). Значения
шифруются, в логи и сообщения об ошибках попадают только маски —
ключ нельзя вычислить даже из цитаты техподдержки.
Разрешённые хосты
Вызов наружу возможен только на хосты из вашего списка «Разрешённые
хосты» (экран «Интеграции»): адрес без схемы и порта, например
crm.company.ru. Изменение применяется в течение минуты. Это защита
от ошибок в сценарии: даже если в узел попадёт чужой или опечатанный
адрес, платформа не обратится на него.
Подпись запросов
Для API, которые требуют авторизацию, узел умеет из коробки: подпись HMAC-SHA256 (запрос подписывается вашим ключом) и OAuth 2.0 (токен получается и обновляется автоматически, с кэшем).
Здоровье интеграций
Экран «Интеграции» показывает по каждому узлу: число вызовов, долю ошибок, скорость ответа (медиана и p95) и последние неуспехи — включая случаи «хост не разрешён» и «без ответа». Если у клиента «интеграция лежит», это видно отсюда раньше, чем из писем.
Плагины — первая точка доступна
Плагин — небольшой модуль на Rust или TinyGo, который компилируется в WASM и исполняется в песочнице: лимиты памяти и времени заданы жёстко, сеть из песочницы закрыта — модуль физически не может никуда обратиться. Персональные данные абонента не покидают защищённый контур обработки — в этом главное отличие от внешнего сервиса.
Доступна точка «Преобразование ответа webhook-узла»: модуль получает HTTP-ответ вашей системы (SOAP/XML, склейка полей, значения в глубине структуры) и возвращает новые переменные сценария — прямо в звонке, без отправки тела наружу. Отказ модуля никогда не роняет звонок: узел идёт обычным маппингом (fail-open), серия отказов отключает модуль на 5 минут.
Как написать, собрать и загрузить модуль — в статье о плагинах; если своей разработкой заниматься не хочется, там же описана галерея готовых модулей платформы — адреса, время перезвона, SOAP-разборщик и другие, установка в один клик. Точка пакетного извлечения полей из транскриптов тоже доступна — галерея закрывает её типовыми извлекателями. Индивидуальные права на модули и их учёт в тарифе настраиваются при подключении.
Смежные вопросы — в FAQ («Можно подключить свою CRM?»); строительные блоки сценария — в справочнике узлов.