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 та вкажіть воронку й етап для угоди. Спільні налаштування миттєвих форм не застосовуються до вебхуків.
  6. Натисніть Застосувати, з’єднайте вебхук із завданням надсилання WhatsApp, листа або дзвінка та налаштуйте його. Підключіть наступні завдання через У разі успіху або У разі невдачі. Один вебхук може запустити кілька незалежних гілок.
  7. Натисніть Зберегти в редакторі перед надсиланням запитів.

Вебхук можна з’єднати із завданням, уже підключеним до миттєвої форми. Зміни спільного завдання діють на обидва тригери; зіставлення полів залишаються окремими. Без завдань і дій CRM зберігається лише контакт. Щоб бачити вебхуки, залиште фільтри рекламного облікового запису та сторінки в стані Усі.

Завдання надсилання листа й WhatsApp в автоматизації через вебхук можуть нагадувати про себе лідам, які не відповіли, так само як для миттєвих форм. Див. Виберіть 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 для форм.

Оновлено