Входящие API-вебхуки: запуск воронки из внешней системы
Своя API-ссылка, по которой внешняя система (CRM, сайт, платёжка) запускает воронку контакту по событию. Контакт находится по любому идентификатору.
Коротко
API-вебхук - это ваша ссылка, по которой внешняя система (CRM, сайт, платёжная форма) запускает воронку конкретному контакту по событию. Например: оплатили заказ в вашей CRM - и контакту в Telegram уходит цепочка выдачи доступа.
Создать ссылку
- Откройте Настройки, раздел API-вебхуки.
- Нажмите Добавить, дайте название (например CRM или Тильда).
- При желании включите 'создавать контакт, если не найден' и секрет-подпись.
- Скопируйте полученную ссылку вида strelo.ru/api/hooks/...
Настроить триггер в воронке
- В конструкторе добавьте триггер Внешнее событие (API).
- Задайте ключ события, например order_paid.
- Готовую ссылку и пример запроса видно прямо в панели триггера.
Как вызывать
Внешняя система шлёт POST на ссылку с телом JSON: поле event (тот же ключ события, что в триггере) плюс любой идентификатор контакта - email, phone, username, telegram_id, external_id или любое другое поле. Все поля запроса попадают в переменные воронки.
Как находится контакт
Strelo ищет контакт по любому совпадению переданных данных (email, Telegram, username, телефон, внешний ID, кастомные поля). Первое совпадение - победитель. Если контакт не найден - запрос пропускается или создаётся новый контакт (по настройке вебхука).
Не нашли ответ?
Спросите ИИ-ассистента или напишите живой поддержке - поможем разобраться.