Автоматически отправляйте лиды из Facebook в Xavi.uz
Как только форма заполнена, в Xavi.uz появляется заказ — с именем, телефоном, ID товара (оффера) и ключом потока, а дальше клиенту звонит оператор. Номер заказа, который возвращает Xavi, приходит в Telegram вместе с каждым лидом.
Как отправлять лиды в Xavi.uz
Подключите Facebook в разделе «Подключения»
«Подключить профиль» → Facebook. Браузер перейдёт на страницу Facebook, где вы выберете, к каким Страницам дать доступ, — ваш пароль Yuboraman не видит. После возврата аккаунт появится в списке «Источники лидов».
Добавьте ключ Xavi.uz в «API Ключи»
Ключ находится в кабинете Xavi.uz, в меню «API hujjatlari» («API-документация»). В Yuboraman нажмите «Новый API ключ», дайте ключу название, в списке «Сайт» выберите Xavi.uz и вставьте ключ. Ключ добавляется один раз — в интеграции он выбирается сам.
Нажмите «Новая интеграция» и выберите источник
В разделе интеграций нажмите «Новая интеграция». В вопросе «Откуда приходит лид?» отметьте Facebook / Instagram, затем выберите Страницу с рекламой и лид-Форму — если аккаунт Facebook один, он выбирается сам.
Настройте название формы и сообщение в Telegram
Дайте интеграции понятное название — например, название товара. Если выбран Telegram-чат, каждый лид и ответ Xavi.uz приходят в этот чат.
Выберите Xavi.uz целевым сайтом
В поиске списка «Куда отправлять лиды?» введите «xavi» и выберите Xavi.uz — ключ из «API Ключи» сам выберется в списке API Key.
Введите ID товара и ключ потока «Oddiy»
Имя и телефон клиента сами связываются с полями формы. На странице «API hujjatlari» в таблице «Faol oqimlaringiz» («Ваши активные потоки») найдите поток типа «Oddiy» («Обычный»): его ключ впишите в поле «Oqim ID», а ID товара, под который открыт поток, — в «Mahsulot (offer) ID»; в окне эти поля подписаны по-узбекски. Сохраните — следующий лид станет заказом.
Видеоурок
Интеграция Yuboraman.uz → Xavi.uz
Пошаговая настройка интеграции Xavi.uz: подключение страницы Facebook и выбор нужной лид-формы. Проверка тестовым лидом и то, как новый лид попадает в Xavi.uz.
Длительность:
Автор: Yuboraman
Видео на узбекском языке.
Возможности
Работает с потоком «Oddiy»
Тип потока в Xavi выбирается при его создании: «Oddiy» («Обычный») или «Murakkab» («Сложный»). Yuboraman отправляет поля обычного потока — имя, телефон, ID товара и ключ потока, — а дальше клиенту звонит оператор Xavi.
Номер заказа в Telegram
На каждый принятый заказ Xavi возвращает номер. Он приходит в Telegram-чат вместе с лидом и сохраняется вместе с ним.
Лид не теряется
Если Xavi.uz временно не отвечает, система трижды пробует отправить лид и, если не вышло, пишет причину в Telegram — затем ещё до 24 часов повторяет попытку каждый час.
Каждому товару — своя интеграция
Поток в Xavi открывается под один товар. Продаёте несколько товаров — откройте для каждого отдельную интеграцию: ключ один и выбирается сам, меняются только ID товара и ключ потока.
Частые вопросы
Где взять API-ключ и ключ потока?
Оба — в кабинете Xavi.uz на странице «API hujjatlari». В таблице «Faol oqimlaringiz» видны ключ и тип каждого потока — берите поток типа «Oddiy». API-ключ добавляется один раз в разделе «API Ключи» Yuboraman.
Возвращается ли статус заказа в Yuboraman?
Пока нет: Xavi.uz не присылает статус заказа. В Telegram видны номер заказа и ответ сайта.
Почему не работает поток «Murakkab»?
Поток «Murakkab» отправляет заказ сразу в доставку, поэтому требует ещё область, район, количество товара и дополнительный телефон. Yuboraman их не передаёт, и Xavi возвращает лид с ошибкой «region_id yuborilmadi! (murakkab turdagi oqim uchun majburiy)» — region_id не передан, для сложного потока он обязателен. Откройте для товара поток «Oddiy» и впишите его ключ в интеграцию.
В Telegram пришла ошибка — что проверить?
Xavi пишет ошибку коротко, и она подсказывает, что исправить: «api_key noto'g'ri!» — неверный ключ, «stream noto'g'ri!» — ключ потока записан с ошибкой, «offer_id noto'g'ri!» — неверный ID товара, «stream api_key ga mos emas!» — поток принадлежит другому аккаунту, «stream offer_id ga mos emas!» — поток открыт под другой товар. Возьмите верное значение на странице «API hujjatlari» и отредактируйте интеграцию.
Другие направления
Пусть лиды сразу попадают в Xavi.uz
Код писать не нужно: зарегистрируйтесь, подключите страницу Facebook и включите первую интеграцию.
