Навіщо це потрібно
Одна людина може бути з вами в кількох каналах. Спершу вона написала в Instagram, потім за кнопкою перейшла в Telegram, і для Sviteya це та сама Персона.
А от ваш сайт (WordPress, FunnelKit, CRM, будь-яка інша система) про це не знає. Якщо Telegram-воронка шле на сайт лише Telegram-номери, картка контакту на сайті заповнюється частково. Instagram-номери сайт отримав би, лише коли людина окремо пройде ще й Instagram-бота.
Тепер воронка в будь-якому каналі передає сайту номери людини з усіх каналів, де вона є: Telegram, Instagram, Messenger і WhatsApp. Одним запитом.
Спосіб 1. Нічого не налаштовувати
У дії «HTTP-запит (вебхук)» (кнопка «Налаштувати» відкриває вікно з усіма полями) залиште поле «Тіло запиту» порожнім. Сервіс сам складе тіло з даними контакта, і туди ж додасть номери людини в кожному каналі:
| Ключ у запиті | Що в ньому |
|---|---|
person_telegram_id |
Telegram ID людини |
person_telegram_contact_id |
ID контакта в Telegram-боті |
person_telegram_username |
юзернейм у Telegram |
person_instagram_id |
Instagram ID людини |
person_instagram_contact_id |
ID контакта в Instagram-боті |
person_instagram_username |
юзернейм в Instagram |
person_messenger_id |
Messenger ID людини |
person_messenger_contact_id |
ID контакта в Messenger-боті |
person_whatsapp_phone |
номер телефону людини у WhatsApp |
person_whatsapp_contact_id |
ID контакта у WhatsApp-боті |
Ці ключі приходять завжди. Якщо людини в якомусь каналі немає, значення порожнє. Тож на боці сайту поля можна налаштувати один раз, і вони не зламаються від того, в яких каналах людина.
Поруч, як і раніше, лежать person_id (ID Персони — один на всі канали), contact_id, channel, channel_id та інші дані контакта.
Спосіб 2. Передати лише те, що потрібно
Якщо ваша система чекає свої назви полів, напишіть тіло запиту самі й вставте потрібні змінні.
- Біля поля «Тіло запиту» натисніть кнопку «поле».
- Відкрийте «Системні» → група «Номери людини в каналах».
- Оберіть потрібне: «Instagram ID», «Instagram — ID контакта», «WhatsApp — Телефон» тощо.
Приклад тіла:
{
"name": "{{field:fld_first_name}}",
"sviteya_person": "{{field:fld_person_id}}",
"tg_id": "{{field:fld_person_telegram_id}}",
"ig_id": "{{field:fld_person_instagram_id}}",
"ig_username": "{{field:fld_person_instagram_username}}"
}Ці ж змінні працюють і в адресі запиту, і в заголовках, і в текстах повідомлень та розсилок.
Як перевірити
У дії «HTTP-запит» натисніть «Тест запиту», оберіть себе як контакт і натисніть «Виконати тест». Сервіс покаже, що саме пішло на сайт і що сайт відповів.
Щоб побачити номери з двох каналів, спершу станьте однією Персоною у двох каналах: пройдіть кнопку з опцією «Перехід в інший канал» (докладніше на сторінці «Одна людина в Instagram і Telegram»).
Що варто знати
Номери рахуються для людини, а не для бота. Не важливо, у якому каналі йде воронка: Telegram-воронка знає Instagram-номери людини, а Instagram-воронка — її Telegram-номери.
Якщо в каналі кілька ваших ботів. Наприклад, у вас два телеграм-боти, і людина є в обох.
- Для каналу самої воронки беруться номери з того бота, де йде воронка.
- Для інших каналів — з бота, де людина була активна останньою.
ID людини і ID контакта — різні речі. ID людини в каналі (Telegram ID, Instagram ID) видає сама платформа. ID контакта видає Sviteya, і він свій у кожному боті. Щоб потім звернутися до нас через API чи MCP, зберігайте на сайті ID контакта або ID Персони.
У WhatsApp замість ID — телефон. Людину там упізнають за номером, тому й передається номер телефону. Юзернеймів у WhatsApp і Messenger немає, тож для них такого поля немає.
Часті питання
У мене вже налаштований запит з порожнім тілом. Щось зламається?
Ні. Усі старі ключі лишилися на місці, лише додалися нові.
Людина є лише в Telegram. Що прийде в Instagram-полях?
Порожні значення. Щойно людина стане тією самою Персоною в Instagram, наступний запит принесе її Instagram-номери.
Чи можна дізнатися в самій воронці, чи є людина в іншому каналі?
Так, умова «Людина в каналі»: «є в каналі» / «немає в каналі» для Telegram, Instagram, Messenger і WhatsApp.