Вебхуки
Вебхук (webhook) — это автоматический механизм передачи данных между сервисами: когда в Фасти происходит некое событие (например, создана встреча или отправлено напоминание), система сама отправляет уведомление об этом во внешний сервис. Для этого она формирует HTTP‑запрос на указанный вами URL‑адрес.
Простыми словами: вебхук — это «сигнал» от Фасти внешнему сервису о значимом событии. Такой подход эффективнее периодической проверки данных («опроса»), потому что информация передается мгновенно в момент наступления события.
Чаще всего вебхуки используют, чтобы автоматизировать передачу данных о встречах и не дублировать информацию вручную. Типичные сценарии:
Простыми словами: вебхук — это «сигнал» от Фасти внешнему сервису о значимом событии. Такой подход эффективнее периодической проверки данных («опроса»), потому что информация передается мгновенно в момент наступления события.
Чаще всего вебхуки используют, чтобы автоматизировать передачу данных о встречах и не дублировать информацию вручную. Типичные сценарии:
- Синхронизация с CRM (amoCRM, Битрикс24, Salesforce и другие) — данные о встрече сразу попадают в систему менеджера.
- Создание задач в таск‑трекерах (Trello, Asana, Jira, Яндекс Трекер и другие) — встреча автоматически встает в список задач для команды.
- Передача данных в маркетинговые и аналитические сервисы (Unisender, SendPulse, Яндекс Метрика и другие) — для учета лидов и анализа источников.
Инструкция по работе с вебхуками
Шаг 1. Переход к настройкам вебхуков
- Откройте раздел «Интеграции». В боковом меню профиля есть пункт «Интеграции» — это центральный узел для всех подключений к внешним сервисам.
- Перейдите во вкладку «Вебхуки». Внутри раздела «Интеграции» выберите вкладку «Вебхуки». Здесь отображается список уже созданных вебхуков и инструменты для управления ими.
Важное уточнение по тарифам: функционал вебхуков доступен начиная с тарифа «Эксперт». Если на вашем текущем тарифе функция недоступна, система покажет уведомление «Недоступно на вашем тарифе» и предложит перейти к тарифам для снятия ограничений.
Шаг 2. Создание нового вебхука
1. Нажмите кнопку «+ Создать». Она расположена над списком вебхуков (справа от поля «Запросить помощь»). Откроется окно «Создать вебхук».
2. Задайте имя вебхука. В поле «Имя» укажите понятное название (например, «Уведомление о новых встречах в Фасти» или «Синхронизация с Фасти»). Так вам будет легче ориентироваться, если позже добавятся и другие вебхуки.
3. Введите URL‑адрес. В поле «Адрес» укажите адрес эндпоинта внешнего сервиса, который будет принимать данные. Поле автоматически предлагает префикс https:// — убедитесь, что адрес начинается именно с него и не содержит опечаток. Это должен быть рабочий адрес, готовый принимать POST‑запросы (например, адрес в CRM, конструкторе ботов или облачной функции).
Важно: на практике один и тот же адрес эндпоинта (например, https://app.fasti.me/example) может использоваться для разных вебхуков — разграничение событий происходит за счет разных триггеров и (при необходимости) разных заголовков (Header).
4. Выберите событие‑триггер. В выпадающем списке «Триггер» укажите, при каком событии Фасти должен отправить уведомление. Доступны следующие варианты:
2. Задайте имя вебхука. В поле «Имя» укажите понятное название (например, «Уведомление о новых встречах в Фасти» или «Синхронизация с Фасти»). Так вам будет легче ориентироваться, если позже добавятся и другие вебхуки.
3. Введите URL‑адрес. В поле «Адрес» укажите адрес эндпоинта внешнего сервиса, который будет принимать данные. Поле автоматически предлагает префикс https:// — убедитесь, что адрес начинается именно с него и не содержит опечаток. Это должен быть рабочий адрес, готовый принимать POST‑запросы (например, адрес в CRM, конструкторе ботов или облачной функции).
Важно: на практике один и тот же адрес эндпоинта (например, https://app.fasti.me/example) может использоваться для разных вебхуков — разграничение событий происходит за счет разных триггеров и (при необходимости) разных заголовков (Header).
4. Выберите событие‑триггер. В выпадающем списке «Триггер» укажите, при каком событии Фасти должен отправить уведомление. Доступны следующие варианты:
- «Создание встречи» — срабатывает сразу после создания новой встречи;
- «Напоминание о встрече» — срабатывает в момент отправки системой напоминания о встрече.
- Для каждого типа события рекомендуется создавать отдельный вебхук — это упрощает отладку и позволяет по‑разному обрабатывать данные на стороне внешнего сервиса.
5. Проверьте структуру данных (JSON‑шаблон). В блоке JSON‑шаблона вы увидите пример структуры данных, которую Фасти отправит во внешний сервис. Обратите внимание на переменные в квадратных скобках — это динамические значения, которые подставляются в момент отправки:
6. Сохраните настройки. Нажмите зеленую кнопку «Сохранить» внизу окна. При успешной настройке вверху экрана появится уведомление «Вебхук создан».
- [Contact_Id] — уникальный идентификатор контакта;
- [Contact_LastName] — фамилия контакта;
- [Contact_Email] — электронная почта контакта.
6. Сохраните настройки. Нажмите зеленую кнопку «Сохранить» внизу окна. При успешной настройке вверху экрана появится уведомление «Вебхук создан».
Шаг 3. Управление вебхуками
После создания вебхук отображается в общем списке — здесь можно управлять его состоянием и настройками:
- Активируйте или деактивируйте вебхук. В строке каждого вебхука есть переключатель «Вкл/Выкл». Когда он выключен, уведомления по этому вебхуку не отправляются. Это удобно для временного отключения без удаления настроек.
- Отредактируйте параметры. Для изменения имени и URL нажмите иконку карандаша в строке вебхука — откроется то же окно, что при создании, здесь можно внести правки и сохранить их.
- Удалите вебхук. Если вебхук больше не нужен, нажмите иконку корзины в строке — система покажет всплывающее окно «Внимание! Удалить вебхук?» с кнопками «Отмена» и «Удалить». Подтвердите действие кнопкой «Удалить» (выделена красным цветом). После подтверждения вверху экрана появится уведомление «Вебхук удален» — это визуальный сигнал об успешном удалении.
- Используйте дополнительные действия. В выпадающем меню (кнопка в форме стрелочки справа в строке) будет доступна подробная информация по Вебхуку.
Шаг 4. Проверка и использование документации
- Изучите формат данных. Если нужно узнать, в каком формате Фасти отправляет данные (какие поля и типы данных будут в запросе), кликните по ссылке «Документация» в окне создания вебхука — откроется инструкция из справочного центра.
- Протестируйте сразу после создания. Создайте тестовую встречу или дождитесь напоминания (в зависимости от выбранного триггера) и проверьте, что внешний сервис получил запрос. Это поможет быстро выявить ошибки в адресе, заголовках или в настройках внешнего сервиса.
- Проверьте подстановку переменных. Убедитесь, что в полученном JSON‑ответе на стороне внешнего сервиса динамические переменные (например, [Contact_Id], [Contact_LastName], [Contact_Email]) корректно подставляются реальными значениями. Если переменные не подставляются, проверьте, что соответствующие данные заполнены в карточке контакта в Фасти.
Шаг 5. Если возникли сложности
- Если не удается настроить самостоятельно. На странице вебхуков есть кнопка «Запросить помощь». При ее нажатии откроется форма «Не удалось настроить самостоятельно?» с полем для описания задачи и кнопками «Отмена» и «Отправить». Опишите, что хотите настроить (например, «нужен вебхук на создание встречи с отправкой в Telegram‑бот» или «не подставляются переменные в JSON»), и команда поддержки предложит решение.
- Используйте справочные материалы. В меню профиля доступны «Справочный центр» и «Техподдержка» — там собраны инструкции и контакты для решения нестандартных сценариев.
Практические рекомендации для новых пользователей
- Создавайте отдельные вебхуки для разных событий. Например, один вебхук на «Создание встречи» для автоматической записи в CRM, а другой — на «Напоминание о встрече» для отправки уведомлений в мессенджер. Так проще управлять интеграциями и отлаживать их.
- Контролируйте доступность URL. Если внешний сервис временно недоступен или адрес указан неверно, уведомления не будут доставлены — статус доставки можно отслеживать в списке вебхуков или в логах интеграции.
- Используйте понятные имена. Если вы планируете настроить несколько вебхуков, понятные имена помогут не запутаться и быстро найти нужный в списке.
- Регулярно проверяйте статус. Убедитесь, что переключатель «Активировать» включен, особенно после изменений в настройках.
- Будьте внимательны при удалении. Удаление вебхука необратимо: после подтверждения кнопкой «Удалить» все настройки будут стерты, и для повторной настройки придется создавать вебхук заново. Всегда перепроверяйте, тот ли вебхук вы собираетесь удалить.
- Учитывайте структуру JSON‑шаблона. Если вы планируете передавать дополнительные данные, убедитесь, что внешний сервис готов их принять и корректно обработать.
- Используйте заголовки (Header) для передачи служебной информации. Например, для авторизации или идентификации источника данных.
- Проверяйте подстановку переменных. Если в JSON‑шаблоне используются динамические переменные (в квадратных скобках), убедитесь, что соответствующие данные заполнены в карточке контакта в Фасти — иначе в запросе будут переданы пустые значения или ошибки.
- Не стесняйтесь обращаться за помощью. Если сценарий интеграции нестандартный или вы не уверены в параметрах, используйте форму «Запросить помощь» — наши специалисты подскажут, какие параметры нужны и как их правильно настроить.
Если в процессе настройки или работы с вебхуками возникнут сложности, вы можете воспользоваться кнопкой «Запросить помощь» на странице вебхуков, обратиться в техподдержку в Телеграм, Макс или по почте info@fasti.me.
Предыдущая статья
← Настройка интеграции с Яндекс календарем
Следующая статья
Интеграция платежной системы Продамус →