Комунікації

На сторінці Комунікації ви підключаєте Requiply до провайдера повідомлень (SMS, Viber або власного бота Telegram) і до провайдера телефонії Binotel. Провайдер повідомлень дає вашій організації прямий мобільний канал до клієнтів, яким автоматизації користуються, щоб автоматично писати клієнтам, коли з бронюванням щось відбувається. Провайдер телефонії переносить ваші телефонні дзвінки та їхні записи в Requiply.

Саме тут підключають Telegram, Viber, SMS і Binotel. Налаштування бота Telegram, введення даних доступу TurboSMS, Kyivstar чи Twilio та підключення телефонії Binotel відбуваються тут, кожне зі своєї картки провайдера. Поки увімкнено вхідні розмови, сторінка також має картки OLX та Instagram, які підключають ці облікові записи як канали вхідних.

Ця сторінка розташована в Налаштування → Інтеграції → Комунікації за адресою https://app.requiply.com/settings/integrations/communications.

Чому комунікації важливі

Requiply вже надсилає листи та push-сповіщення в застосунку. Провайдер комунікацій додає SMS, Viber і Telegram, щоб ви могли звʼязуватися з клієнтами на їхніх телефонах. Це особливо корисно для нагадувань і підтверджень бронювань, бо листи часто пропускають.

Коли провайдера повідомлень підключено:

• Автоматизації можуть писати клієнту, коли бронювання створено, воно досягає статусу чи статусу оплати або наближається час його початку чи завершення, через дію Надіслати повідомлення клієнту (SMS / Viber / Telegram).
• Текст береться з шаблону повідомлення, який використовує ту саму систему {{variables}}, що й шаблони листів і push-сповіщень: імʼя клієнта, деталі бронювання, посилання на оплату тощо.
• Telegram додатково підтримує форматування, PDF-вкладення (рахунок або згенерований шаблон експорту) і кнопки-посилання.

Коли підключено Binotel:

• У вебверсії та мобільному застосунку в розділі Клієнти зʼявляється сторінка Дзвінки: кожен дзвінок зіставлено з клієнтом за номером телефону, є записи та значок пропущених дзвінків.
• Сторінки клієнтів можуть показувати поле Дзвінки Binotel з історією дзвінків цього клієнта, див. Деталі клієнта.
• Учасники з лінією Binotel можуть телефонувати клієнтам із Requiply: Binotel спершу дзвонить на їхній телефон, а потім набирає клієнта.

Кожна організація зберігає власні дані доступу провайдерів. Підключення провайдера для однієї організації не впливає на іншу.

Що ви побачите

Сторінка показує кожного підтримуваного провайдера карткою, згрупованою в Глобальні провайдери та Українські провайдери (українських провайдерів позначено іконкою прапора). Кожна картка провайдера містить:

• Назву провайдера та логотип.
• Мітки каналів, які описують, що провайдер може доставляти (наприклад, SMS, Viber, Calls (дзвінки), Recordings (записи)).
• Стан налаштування: чи має ця організація вже активну інтеграцію з цим провайдером.
• Інструкція: відкриває в новій вкладці браузера покрокову інструкцію Requiply з налаштування цього провайдера мовою вашого інтерфейсу.
• Налаштувати (ще не підключено) або Керувати (уже підключено).

Поточний каталог провайдерів:

Відкриття інструкції

Натисніть Інструкція на картці провайдера, коли потрібна допомога з пошуком даних доступу в обліковому записі провайдера. Requiply відкриє в новій вкладці власну покрокову інструкцію для цього провайдера: англійську чи українську версію відповідно до мови вашого інтерфейсу. У Requiply при цьому нічого не змінюється.

Для української версії додайте /uk перед /blog, наприклад https://requiply.com/uk/blog/binotel-integration.

Налаштування провайдера

Натисніть Налаштувати на картці провайдера, щоб відкрити діалог налаштування. Діалог показує логотип вибраного провайдера й окреме поле для кожного елемента даних доступу. Діалог також можна відкрити напряму за посиланням: додайте до адреси сторінки ?modal= і провайдера, наприклад /settings/integrations/communications?modal=binotel або ?modal=telegram.

Після натискання Зберегти Requiply перевіряє дані доступу в провайдера, перш ніж щось зберегти (наприклад, TurboSMS перевіряється через запит балансу рахунку, а Binotel через список працівників вашої компанії). Якщо перевірка успішна, секретне значення шифрується, несекретні поля зберігаються поруч із ним, інтеграція стає активною для вашої організації, а картка переходить у стан Керувати. Якщо перевірка не вдалася, Requiply показує повідомлення про помилку від провайдера і нічого не зберігає.

Натисніть Скасувати, щоб закрити діалог налаштування без збереження змін.

Поля провайдерів

В усьому каталозі секретні дані доступу (API-токен / Auth-токен / Client Secret / API-секрет) зберігаються зашифрованими і після збереження маскуються. Імена відправників, ідентифікатори сервісів і API-ключ Binotel зберігаються як звичайні несекретні налаштування.

TurboSMS

Kyivstar

Binotel

Binotel є українською хмарною АТС і сервісом колтрекінгу. Його підключення переносить дзвінки вашої компанії в Requiply: сторінку Дзвінки, поле Дзвінки Binotel для кожного клієнта, записи та дзвінки клієнтам із Requiply. Повний покроковий опис є в інструкції: Інтеграція Binotel у Requiply.

Перед підключенням:

• Ваша організація Requiply на активному пробному періоді або на платному тарифі Core чи вищому.
• Ваша компанія має обліковий запис Binotel на тарифі з API. API підтримують лише тарифи Binotel PRO і вищі. Binotel підключає нові компанії телефоном, тож найшвидше зателефонувати в Центр обслуговування клієнтів, указаний на сторінці контактів Binotel. На початку розмови попросіть інтеграцію через API. Реєстрація триває близько 30 хвилин.
• Binotel надсилає лист з вашими API-ключ та API-секрет.
• Обліковий запис Requiply кожного учасника команди використовує той самий email, що і його профіль працівника в Binotel. Requiply знаходить лінію Binotel учасника за цим email. Без збігу учасник бачить дзвінки, але не може телефонувати з Requiply.

Діалог містить таку примітку щодо налаштування:

Запросіть доступ до REST API для вашої компанії в підтримки Binotel (support@binotel.ua) та вставте ключ і секрет сюди. Після підключення сторінка клієнта отримає рядок Binotel з історією дзвінків і записами, які можна прослухати, зіставленими за номером телефону клієнта. Його бачать лише учасники, чия група дозволів дає доступ до історії дзвінків клієнта.

Коли ключ і секрет правильні, картка показує зелену галочку з Налаштовано, а кнопка змінюється на Керувати.

Після підключення:

1. Для учасників із Доступ до клієнтів у меню в розділі Клієнти зʼявляється пункт Дзвінки, а на екрані Більше в мобільному застосунку стає доступним Дзвінки. Див. Дзвінки.
2. Requiply показує діалог Binotel підключено: Для найкращого досвіду додайте поле «Дзвінки Binotel» на сторінку клієнта. Його кнопка Налаштувати сторінку клієнта відкриває вкладку клієнта в розділі «Поля сторінок деталей». Поле Дзвінки Binotel не додається на сторінки клієнтів автоматично. Його додає адміністратор у розділі Поля сторінок деталей (вкладка клієнта) за адресою /settings/fields/page-level-configurations?tab=client.
3. Це поле та рядок Дзвінки Binotel у мобільному застосунку бачать лише учасники, чия група дозволів має Доступ до історії дзвінків клієнта. Група «Адміністратори» має цей дозвіл за замовчуванням.

Коли Binotel відхиляє обліковий запис. Якщо Binotel повідомляє, що саму вашу компанію вимкнено, Requiply вимикає інтеграцію і перестає запитувати дзвінки в Binotel. Тоді сторінка Дзвінки показує Інтеграцію телефонії вимкнено, а діалог Binotel тут показує попередження над полями: Інтеграцію вимкнено, бо Binotel відхилив акаунт: {reason}. Коли акаунт у Binotel знову запрацює, збережіть, щоб підключити її знову. Щойно Binotel повторно активує ваш обліковий запис, відкрийте Керувати на картці Binotel і натисніть Зберегти. Requiply знову перевірить дані доступу та увімкне інтеграцію.

Telegram

Для Telegram не треба налаштовувати імʼя відправника: відправником є ваш бот. Коли ви зберігаєте токен, Requiply запитує в Telegram, що це за бот, зберігає його username і реєструє вебхук, через який клієнти підключаються до бота. Додатково нічого налаштовувати не потрібно.

Діалог містить таку примітку щодо налаштування:

Створіть власного бота через @BotFather у Telegram і вставте його токен сюди. Клієнти підключаються, відкривши вашого бота й натиснувши Start. Після цього робочі процеси зможуть надсилати їм повідомлення.

Коли увімкнено вхідні розмови, той самий бот може також переносити повідомлення клієнтів у вхідні: підключіть його як канал у розділі Налаштування омніканальних розмов. Сповіщення автоматизацій працюють у будь-якому разі.

Twilio

OLX

Картка OLX підключає ваш обліковий запис OLX до вхідних розмов, щоб повідомлення покупців про ваші оголошення надходили в Requiply. Вона показується, лише поки вхідні увімкнено.

Полів для заповнення немає. Натисніть Увійти через OLX, увійдіть на сторінці самого OLX і дозвольте доступ. Після цього картка показує Налаштовано. Керувати показує підключений обліковий запис, час останньої перевірки і посилання Налаштування каналів та AI-асистента. Кнопкою Підключити ще один акаунт можна підключити більше одного облікового запису OLX.

Усе про розмови OLX описано на сторінці OLX.

Instagram

Картка Instagram у розділі Глобальні провайдери з міткою Instagram Direct підключає ваш бізнес-акаунт чи акаунт автора Instagram до вхідних розмов, щоб повідомлення Direct надходили в Requiply. Вона показується, лише поки вхідні увімкнено.

Її логотип має мітку Бета. Instagram доступний як бета за запитом: наведіть курсор на мітку, щоб прочитати Бета за запитом. Напишіть нашій команді на info@requiply.com тег вашого Instagram-акаунта, а ми додамо вас до бета-тестувальників цієї функції.

Полів для заповнення немає. Діалог пояснює вимоги в примітці: Працює з бізнес-акаунтами та акаунтами автора. У застосунку Instagram увімкніть Налаштування › Повідомлення та відповіді на історії › Керування повідомленнями › Підключені інструменти › Дозволити доступ до повідомлень. Instagram приймає відповіді протягом 24 годин після останнього повідомлення клієнта. Натисніть Увійти через Instagram, виберіть обліковий запис на сторінці самого Instagram і дозвольте доступ. Після цього діалог показує обліковий запис з його @handle і станом, посилання Налаштування каналів та AI-асистента, а також Підключити ще один акаунт для інших облікових записів. Коли Instagram перестає приймати вхід, обліковий запис показує Увійти знову.

Усе про розмови Instagram описано на сторінці Instagram.

Підключення клієнтів до вашого бота Telegram

Боти Telegram не можуть писати на номер телефону. Клієнт має один раз відкрити вашого бота, після чого Requiply знає, у який чат надсилати. Привести клієнтів туди можна двома способами.

Персональне посилання-запрошення

Кожен клієнт має персональне посилання на вашого бота у форматі https://t.me/yourbot?start=….

• Скопіюйте його вручну: відкрийте сторінку Деталі клієнта і натисніть Скопіювати посилання-запрошення в картці Повідомлення, а потім надішліть його так, як ви вже спілкуєтеся з цим клієнтом.
• Додайте його в шаблон: вставте змінну {{telegramConnectLink}} у шаблон листа або шаблон повідомлення. Requiply створить посилання для цього клієнта під час надсилання повідомлення.

Відкриття посилання та натискання Start одразу підключає клієнта.

Бот підтверджує підключення в чаті самого клієнта. Відтепер автоматизації можуть йому писати.

Надсилання номера телефону

Клієнта, який просто відкрив бота без посилання, просять поділитися номером телефону кнопкою Поділитися номером телефону. Requiply зіставляє надісланий номер із записами ваших клієнтів і повʼязує їх, коли знаходить рівно один збіг. Якщо збігів немає або їх кілька, бот відповідає, що не знайшов профілю. Нічого не підключається.

Стани підключення

Картка Повідомлення на сторінці Деталі клієнта показує стан кожного клієнта:

Оновлення даних доступу

Для вже підключеного провайдера кнопка називається Керувати. У цьому діалозі:

• Налаштований секрет показано замаскованим (••••••••••••) з кнопкою Замінити: справжній токен ніколи не повертається в браузер. Натисніть Замінити, щоб ввести новий, або Скасувати, щоб залишити наявний токен.
• Несекретні поля (як-от імена відправників, ідентифікатори сервісів чи API-ключ Binotel) уже заповнені. Їх можна вільно редагувати.
• Якщо ви змінюєте лише імʼя відправника, а секрет не чіпаєте, збережений токен залишається. Вводити його повторно не треба.

Відключення провайдера

На сторінці «Комунікації» немає видимої дії відключення чи видалення. Щоб змінити активного провайдера, відкрийте Керувати і збережіть нові дані доступу для того самого провайдера.

Де використовуються інтеграції комунікацій

Типові сценарії

Перше підключення провайдера

1. Перейдіть у Налаштування → Інтеграції → Комунікації.
2. Виберіть провайдера, яким користується ваша організація.
3. Натисніть Інструкція, якщо потрібна допомога з пошуком необхідних даних доступу.
4. Натисніть Налаштувати.
5. Введіть дані доступу провайдера (для швидкого старту використайте тестове імʼя відправника для TurboSMS чи Kyivstar).
6. Натисніть Зберегти.
7. Переконайтеся, що картка провайдера перейшла в стан Керувати.
8. Створіть шаблон повідомлення з тим, що хочете сказати.
9. Створіть автоматизацію з дією Надіслати повідомлення клієнту (SMS / Viber / Telegram) і вкажіть у ній цей шаблон.

Підключення Binotel і перші дзвінки

1. Переконайтеся, що обліковий запис Requiply кожного учасника команди використовує той самий email, що і його профіль працівника в Binotel.
2. Отримайте API-ключ та API-секрет від Binotel (тариф Binotel PRO або вищий).
3. Відкрийте /settings/integrations/communications?modal=binotel, вставте обидва значення і натисніть Зберегти.
4. Переконайтеся, що картка Binotel показує зелену галочку з Налаштовано.
5. Відкрийте Клієнти → Дзвінки, щоб побачити журнал дзвінків. Під час першого відкриття завантажуються дзвінки за останні 30 днів.
6. Додайте поле Дзвінки Binotel на сторінки клієнтів у розділі Поля сторінок деталей (вкладка клієнта) і збережіть.
7. Надайте Доступ до історії дзвінків клієнта тим групам дозволів, які мають слухати записи на сторінках клієнтів.

Оновлення або ротація даних доступу

1. Перейдіть у Налаштування → Інтеграції → Комунікації.
2. Натисніть Керувати на провайдері, якого треба оновити.
3. Натисніть Замінити біля замаскованого токена і вставте новий (або змініть імʼя відправника, не чіпаючи токен).
4. Натисніть Зберегти.

Якщо налаштування не вдалося

У такому разі:

• Переконайтеся, що токен чи секрет скопійовано з правильного облікового запису провайдера.
• Перевірте, що обліковий запис провайдера активний і може надсилати повідомлення.
• Переконайтеся, що провайдер затвердив ваше імʼя відправника. Незатверджене імʼя може призводити до відхилення надсилань, навіть коли інтеграція виглядає підключеною.
• Для Viber через TurboSMS переконайтеся, що налаштовано як імʼя відправника Viber, так і імʼя відправника SMS.
• Для Telegram переконайтеся, що токен належить боту, якого ви створили через @BotFather. Також перевірте, що там його не відкликано. Відкликаний токен не проходить перевірку, а заміна токена на токен іншого бота скидає кожне підключення клієнтів.
• Для Binotel переконайтеся, що для вашої компанії увімкнено доступ до API (тариф Binotel PRO або вищий), а ключ і секрет узято з того самого листа Binotel. Binotel відхиляє перевірку, коли доступ до API не активний.
• Якщо інтеграцію Binotel вимкнено, спершу повторно активуйте обліковий запис у Binotel, а потім натисніть Зберегти в діалозі Binotel, щоб підключитися знову.