Слова «API» и «вебхук» звучат на любой встрече про автоматизацию. Разработчики произносят их как нечто само собой разумеющееся, а владельцу бизнеса остаётся доверять. Проблема в том, что от понимания этих двух механизмов зависит, сможете ли вы оценить сроки, бюджет и надёжность интеграции.
Хорошая новость: чтобы разбираться в теме на уровне «ставлю задачу и проверяю результат», программировать не нужно. Достаточно пары аналогий и понимания нескольких принципов. Ниже — объяснение без единой строчки кода.
API: окно выдачи в ресторане
Представьте ресторан. Вы не заходите на кухню и не берёте продукты сами. Вы говорите официанту, что хотите, он передаёт заказ на кухню и приносит готовое блюдо. Кухня — это программа с данными, официант — API.
API (программный интерфейс) — набор правил, по которым одна программа может попросить другую что-то сделать или что-то сообщить. Например:
- «Создай в CRM новый контакт с таким именем и телефоном».
- «Найди все сделки клиента с этим телефоном».
- «Покажи свободные окна в расписании мастера на завтра».
- «Переведи сделку на этап “Оплачено”».
Как и в ресторане, заказывать можно только то, что есть в меню. Если в API вашей CRM нет функции «изменить причину отказа», подключённая программа не сможет этого сделать, как бы ни старалась. Поэтому первое, что выясняет интегратор, — что умеет API конкретной системы.
Вебхук: звонок от курьера
У API есть особенность: он отвечает только на вопросы. Если вы хотите узнать, не пришла ли оплата, придётся спрашивать снова и снова: «Оплата пришла? А сейчас? А сейчас?». Это неудобно и создаёт лишнюю нагрузку.
Вебхук работает наоборот: вы один раз говорите системе «когда что-то случится — сообщи мне по этому адресу». Как курьер, который звонит, когда подъехал, а не вы каждые пять минут смотрите в окно.
Примеры вебхуков в работе с клиентами:
- Клиент оплатил заказ — платёжная система сообщает CRM.
- Сделка перешла на этап «Отгружено» — CRM сообщает ИИ-ассистенту, и тот пишет клиенту.
- Клиент заполнил форму на сайте — сайт сообщает CRM.
- Клиент отменил запись в сервисе онлайн-записи — сервис сообщает CRM, освобождается слот.
Разница в одной таблице
| API | Вебхук | |
|---|---|---|
| Кто начинает | Тот, кому нужны данные | Тот, у кого произошло событие |
| Аналогия | Вы звоните и спрашиваете | Вам звонят и сообщают |
| Когда использовать | Нужно получить или изменить данные по запросу | Нужно мгновенно узнать о событии |
| Пример | ИИ проверяет статус заказа, когда клиент спросил | CRM сообщает ИИ, что заказ отгружен |
В реальных интеграциях эти механизмы почти всегда работают в паре. Вебхук сообщает: «что-то случилось», а затем по API запрашиваются подробности или вносятся изменения.
Как это выглядит в связке с ИИ-сотрудником
Пройдём путь одного клиента, чтобы увидеть механику целиком.
- Клиент пишет в Telegram: «Хочу записаться на стрижку в субботу». Мессенджер передаёт сообщение ИИ-ассистенту — это тоже вебхук.
- Ассистент по API запрашивает у сервиса записи свободные окна на субботу.
- Клиент выбирает 12:00. Ассистент по API создаёт запись.
- Ассистент по API ищет клиента в CRM по телефону, находит, создаёт сделку и прикрепляет резюме диалога.
- В пятницу CRM по правилу отправляет вебхук ассистенту: «напомни о визите».
- Ассистент пишет клиенту, тот подтверждает.
- После визита сервис записи отправляет вебхук в CRM: «визит состоялся». Сделка закрывается как успешная.
Ни одного действия человека, а клиент получил быстрый сервис. При этом администратор видит всё происходящее в CRM и может вмешаться в любой момент. Именно так устроена интеграция ИИ-сотрудника с CRM.
Готовые коннекторы или своя интеграция
Связать системы можно тремя путями, и от выбора зависят цена, сроки и гибкость.
| Способ | Как работает | Когда подходит |
|---|---|---|
| Встроенная интеграция | Включается в настройках CRM или сервиса, без программирования | Стандартная задача, например подключить мессенджер к CRM |
| Конструктор интеграций | Визуальные цепочки «если событие — то действие» в отдельном сервисе | Простые связки двух-трёх систем, небольшой поток данных |
| Своя интеграция через API | Разработчик пишет логику под вашу задачу | Нестандартная логика, большой объём, работа с ИИ-ассистентом |
Начинать стоит с самого простого варианта, который решает задачу. Но если связка становится ключевой для продаж — например, через неё проходят все заявки, — лучше иметь надёжную собственную интеграцию с мониторингом, чем цепочку из конструктора, о сбое которой никто не узнает.
Что может пойти не так
Понимание механики помогает предвидеть типичные сбои и спросить о них заранее.
Система недоступна
CRM обновляется или перегружена, вебхук не дошёл. Хорошая интеграция повторяет отправку несколько раз и складывает неотправленное в очередь. Плохая — молча теряет данные.
Изменилась структура
Кто-то переименовал поле в CRM или удалил этап воронки. Интеграция по-прежнему пытается писать туда, куда уже нельзя. Нужен мониторинг ошибок и человек, который о них узнаёт.
Ограничения по количеству запросов
У большинства API есть лимит: не больше определённого числа обращений в секунду. При всплеске заявок, например после рассылки, интеграция может упереться в лимит. Решается очередью и грамотной архитектурой.
Права доступа
Интеграция работает под учётной записью конкретного сотрудника. Сотрудник уволился, учётку отключили — всё встало. Поэтому для интеграций создают отдельного технического пользователя.
Совет. Попросите подрядчика показать, как вы узнаете о сбое интеграции. Если ответ «мы следим», уточните: как именно, кто получает уведомление и за какое время реагируют. Тишина не всегда значит, что всё работает.
Безопасность: что важно владельцу
Через API и вебхуки передаются данные клиентов, поэтому вопросы безопасности — не формальность.
- Ключи доступа к API хранятся у подрядчика защищённо, а не в открытом письме или общем чате.
- У технического пользователя ровно те права, что нужны для задачи, без доступа ко всему порталу.
- Вебхуки проверяют подлинность отправителя, чтобы посторонний не мог прислать поддельное событие.
- Данные передаются только по защищённому соединению.
- Есть журнал операций: что, когда и куда передавалось.
- При расторжении договора ключи можно отозвать за минуту.
Подробно о том, как мы защищаем данные клиентов, рассказано на странице безопасности данных.
Вопросы для подрядчика
Возьмите этот список на встречу с интегратором. Ответы покажут, насколько продуман проект.
- Какие данные и в каком направлении будут передаваться?
- Где используется API, а где вебхуки, и почему?
- Что произойдёт с данными, если CRM будет недоступна час?
- Как я узнаю о сбое и кто его исправит?
- Под какой учётной записью работает интеграция и какие у неё права?
- Что будет, если я добавлю новое поле или этап в CRM?
- Как интеграция поведёт себя при резком росте заявок?
Словарик для встречи с интегратором
- Эндпоинт — конкретный «пункт меню» API, например «создать контакт».
- Токен или ключ — пароль, по которому система узнаёт, что запрос пришёл от разрешённой программы.
- Лимит запросов — сколько обращений к API можно сделать за единицу времени.
- Очередь — механизм, который складывает задания и выполняет их по порядку, не теряя при сбоях.
- Логи — журнал того, что интеграция делала и где возникли ошибки.
- Тестовая среда — копия системы или отдельная воронка, где интеграцию проверяют, не трогая реальных клиентов.
Коротко о главном
API — это способ попросить программу что-то сделать или сообщить, как заказ через официанта. Вебхук — способ получить сообщение о событии в тот момент, когда оно произошло, как звонок курьера. Вместе они связывают сайт, мессенджеры, CRM и ИИ-ассистента в единую систему, где данные движутся сами.
Владельцу бизнеса не нужно писать код, но полезно понимать механику: так проще ставить задачу, оценивать риски и задавать подрядчику правильные вопросы.
По теме: узнайте больше на странице «Интеграция с CRM» или свяжитесь с нами — подберём решение под вашу задачу.