Skip to Content

Автоматизации через вебхуки

Просмотр заявок

График объединяет заявки в суточные интервалы, а в режиме одного дня — в часовые. Наведите указатель на точку линии или выберите её с клавиатуры, чтобы появился маркер, затем нажмите для просмотра заявок группы. У каждой заявки сохраняется точное время получения.

В Маркетинг → Автоматизация контактов → Обзор график Заявки с течением времени помогает сравнить результаты форм и вебхуков. Каждая линия показывает накопительное число полученных заявок за последние 1, 7, 30 или 90 дней. Нажмите на название триггера под графиком, чтобы скрыть или показать его линию.

Нажмите на точку, чтобы увидеть имя заявителя и время получения в вашем часовом поясе. Для просмотра имени нужен доступ к контактам; у заявки может не быть имени. Совпадающие точки показывают все заявки, полученные в этот момент. Тестовые заявки учитываются. Получение заявки не означает успешное выполнение задания, а время получения может отличаться от времени отправки формы.

График обновляется автоматически; кнопка Обновить заявки обновляет его сразу. Если за период получено больше 5 000 заявок, показаны первые 5 000, а линии заканчиваются на последней включённой заявке. Для просмотра более поздних заявок выберите короткий период.

В заданиях звонков и WhatsApp откройте Дополнительные настройки и выберите страну для распознавания местных номеров. Для вебхуков страна выбирается вручную; международные номера сохраняют свой код страны.

Вебхук запускает follow-up лидов из вашего сайта, формы или приложения. Например, заявка на консультацию может запустить сообщение в WhatsApp с резервным письмом и создать сделку в CRM. Подключение Meta Ads не требуется.

Навигация по маркетингу

Телефонные кампании и кампании WhatsApp находятся в Маркетинг → Кампании. Результаты Instant Forms и вебхуков, а также настройка CRM доступны в Маркетинг → Автоматизация контактов → Обзор. Для изменения сценария откройте Редактор автоматизации. Подключения остаются в Общие → Интеграции → Рекламные платформы. Кнопка Подключить Meta Ads открывает настройку подключения. В Маркетинг → Шаблоны WhatsApp выберите канал WhatsApp. Перед выходом с несохранёнными изменениями требуется подтверждение.

Перед началом

Нужны доступ к интеграциям и ключ API, который можно выбрать для вебхука. Управляйте ключами на странице ключей API  или создайте ключ при настройке вебхука. Чтобы запускать задачи follow-up, подготовьте агента и подключённый канал WhatsApp, почтовый ящик или номер для исходящих звонков. Для создания сделок подключите CRM.

Добавьте вебхук и автоматизацию

  1. Откройте Маркетинг → Автоматизация контактов → Редактор автоматизации.
  2. В палитре добавления узлов выберите Вебхук или перетащите его на полотно.
  3. Укажите название и выберите Ключ API. Кнопка Создать новый ключ API… позволяет создать и сразу выбрать ключ. Управлять ключами можно также на странице ключей API .
  4. В поле Данные тестового лида добавьте контактные данные и свои поля, например your_field_1. Они станут доступны для сопоставления в задачах и CRM.
  5. При необходимости выберите Настроить CRM и укажите воронку и этап для сделки. Общие настройки Instant Form не применяются к вебхукам.
  6. Нажмите Применить, соедините вебхук с задачей отправки WhatsApp, письма или звонка и настройте её. Подключите следующие задания через При успехе или При неудаче. Один вебхук может запустить несколько независимых веток.
  7. Нажмите Сохранить в редакторе до отправки запросов.

Вебхук можно соединить с задачей, уже подключённой к Instant Form. Изменения общей задачи действуют на оба триггера; сопоставления полей остаются отдельными. Без задач и действий CRM сохраняется только контакт. Чтобы видеть вебхуки, оставьте фильтры рекламного аккаунта и страницы в состоянии Все.

Задачи отправки письма и WhatsApp в автоматизации через вебхук могут напоминать о себе лидам, которые не ответили, так же как для Instant Form. См. Выберите follow-ups для задания.

Вызовите вебхук

Можно сопоставлять поля заданий или CRM с full_name, даже если вы отправляете только first_name и last_name: Versafy автоматически объединит их. Если вы передадите непустое значение full_name, будет использовано оно.

Название сделки может содержать значения полей лида, а также стандартные переменные контакта и кампании. Выберите переменную под полем названия, чтобы вставить её в позиции курсора. Для мгновенных форм доступны поля ответов, для вебхуков — поля тестовых данных лида. Отсутствующие значения остаются пустыми, а несколько ответов разделяются запятыми. Названия существующих сделок не меняются.

Откройте Маркетинг → Автоматизация контактов → Редактор автоматизации, затем настройки сохранённого узла Webhook. Скопируйте URL запроса; Пример запроса содержит ваш trigger_id. Если настройки уже открыты, можно сразу скопировать полный пример. Управлять выбранным ключом можно на странице ключей API . Отправляйте запрос с сервера приложения, не размещая ключ API в публичном коде сайта. В заголовке Authorization: Bearer используйте выбранный ключ. Замените значения-заполнители URL, ключа и ID триггера в примере:

curl -X POST 'YOUR_WEBHOOK_URL' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ --data '{ "trigger_id": "YOUR_TRIGGER_ID", "event_id": "quote-request-123", "first_name": "Alex", "last_name": "Smith", "company_name": "Example Company", "email": "alex@example.com", "phone_number": "+351916000000", "your_field_1": "Example value 1", "your_field_2": "Example value 2" }'

Обязательны trigger_id, event_id, first_name и хотя бы одно из полей email или phone_number. Фамилия и компания необязательны. Свои поля добавляйте на том же уровне JSON, без вложенных объектов. Полные ограничения и ответы описаны в справочнике API вебхуков . Ссылка Документация API в настройках вебхука открывает тот же справочник.

Для новой заявки используйте новый event_id. При повторной отправке той же заявки сохраняйте ID и данные без изменений: сервер вернёт исходную квитанцию. Изменённые данные с тем же ID дают 409 Conflict.

Проверьте результат

Для тестовых лидов нужны действительные адреса email и номера телефонов, в том числе в дополнительных полях получателя основных и резервных заданий. Перед отправкой исправьте отмеченные поля; текстовые заглушки не принимаются. Для номера без кода страны используется страна из настроек задания. Проверка формата не подтверждает возможность получения сообщений.

Чтобы проверить письмо без запуска автоматизации, откройте задачу Отправить письмо, выберите подключённого отправителя, укажите тему и инструкции и нажмите Отправить тестовое письмо. Заполните поля примерами и отправьте тест на адрес своего аккаунта. Тест использует несохранённые настройки задачи и оформления; он не сохраняет задачу, не создаёт контакт и не запускает другие действия.

Чтобы просмотреть переписки вебхука, откройте Маркетинг → Автоматизация контактов → Обзор и нажмите ненулевое число заданий WhatsApp, email или звонка. Чаты откроются с фильтром по этому вебхуку и типу задания. Удалите метку фильтра или нажмите Сбросить все, чтобы расширить список. Этот фильтр доступен только по таким ссылкам, а не в списке фильтров чатов. У ожидающих заданий и ошибок до начала общения может не быть переписки; несколько заданий могут относиться к одной переписке.

На карточке статистики вебхука нажмите Настроить CRM или Настройки CRM, чтобы изменить создание сделок. Нажмите Сохранить, чтобы применить настройки CRM без открытия редактора автоматизации.

В разделе Интеграции → Рекламные платформы для каждого сохранённого вебхука показано количество лидов и созданных заданий WhatsApp, email и звонков. Тестовые запросы тоже учитываются. Созданные задания могут ещё ожидать выполнения или завершиться ошибкой; эти показатели не подтверждают доставку. До получения лидов новый вебхук показывает нули.

Тест запускает реальные задачи: возможны сообщения, звонки и записи в CRM. Используйте свои контактные данные.

После сохранения снова откройте редактор, выберите Тестовый лид на узле вебхука, отредактируйте данные и нажмите Отправить тестового лида. Оставьте окно открытым, чтобы видеть квитанцию и состояние обработки.

После успешной отправки окно подготавливает новый ID события. Оставьте или измените данные и нажмите Отправить ещё одного тестового лида, чтобы повторить тест. Подпись Последняя отправка относится к предыдущей квитанции. Если запрос прервался из-за ошибки соединения, повторите его без изменения данных, чтобы избежать дубликатов.

  • Ответ 202 Accepted подтверждает приём для фоновой обработки, а не доставку сообщения. Сохраните receipt_id для обращения в поддержку.
  • В Общее → Контакты найдите контакт по email или телефону. Совпадающий существующий контакт может быть обновлён вместо создания нового.
  • В Общее → Задания откройте задачи лида и проверьте статус и результат. Источник вебхука отображается как API. Учтите задержку запуска и рабочие часы.
  • В CRM проверьте выбранные воронку и этап: там должна появиться настроенная сделка с данными лида и заметками о follow-up.

Если нужный канал недоступен, задача может завершиться неудачей. Резервная задача запускается только при наличии соответствующего соединения и подходящих контактных данных.

Если что-то не работает

Если email-агент работает в режиме Dry Run или проверки черновиков, автоматизация не отправляет письмо и запускает настроенное резервное действие. Без резервного действия эта ветка завершается ошибкой. Чтобы разрешить автоматические письма, переключите агента в режим отправки.

При отклонении запроса проверьте сохранение редактора, URL, ID триггера, выбранный ключ и обязательные поля. Если запрос принят, но сообщения нет, проверьте соединения задач и их статусы. Состояние suppressed означает, что follow-up пропущен защитой от дублирования; сначала проверьте существующие задачи. Если нет сделки, проверьте настройки CRM именно этого вебхука.

Обновление сделок CRM

Разверните Применить эти настройки CRM к другим вебхукам, чтобы найти другие вебхуки и отметить нужные. Раздел изначально свёрнут; сворачивание сохраняет выбор для последующего сохранения.

При сохранении выбранная группа запоминается. Если снова открыть любой вебхук группы, остальные будут отмечены автоматически. Снимите отметку с вебхука перед сохранением, чтобы отделить его от группы. Для настроек, скопированных до этого изменения, один раз сохраните их с отмеченными нужными вебхуками.

Новые контакты из заявок вебхука получают источник Вебхук. Автоматизация WhatsApp сохраняет контакт до отправки, а синхронизация CRM использует связанный контакт повторно. Применить эти настройки CRM к другим вебхукам копирует настройки CRM; несовместимый выбор не сохраняется. Обновление сделок следует правилам CRM для форм.

Обновлено