HugeProfitДокументація CRM Увійти
Інтеграції

SMS через TurboSMS і телефонія Binotel, Ringostat у HugeProfit

Через TurboSMS HugeProfit сам надсилає покупцям SMS або Viber-повідомлення, коли змінюється статус продажу: «замовлення прийнято», «посилку передано в доставку, ТТН …», «чекає у відділенні». Тексти й статуси ви налаштовуєте один раз, далі все працює автоматично. А підключивши IP-телефонію Binotel або Ringostat, ви бачите вхідні дзвінки просто в HugeProfit і дзвоните клієнту з його картки — див. нижче.

1. Що підготувати в TurboSMS

  • Акаунт і баланс на turbosms.ua — повідомлення оплачуються в TurboSMS.
  • Відправник (альфа-ім’я, наприклад назва магазину) — зареєструйте в розділі «Отправители» → «Отправители SMS»; для Viber — «Отправители VIBER». Без зареєстрованого відправника повідомлення не підуть.
  • Доступ для HugeProfit — «Шлюз (API)» → «Настройки интеграции»:
    • увімкніть «HTTP API» і скопіюйте «Текущий токен HTTP API авторизации» — рекомендований спосіб, обов’язковий для Viber;
    • або увімкніть «SOAP» і задайте «Отдельный логин авторизации на сервере» з паролем.
Налаштування API в TurboSMS
TurboSMS: Шлюз (API) → Настройки интеграции (дані приховано)

⚠️ TurboSMS може автоматично вимкнути підключення, яким не користувалися понад 6 місяців. Якщо SMS раптом перестали йти — перевірте тут, чи ввімкнено HTTP API.

2. Підключення в HugeProfit

«Налаштування» → «Інтеграції» → вкладка «SMS» → TurboSMS → «Підключити»:

Налаштування TurboSMS
Дані приховано
  • Логін і пароль шлюзу (якщо підключаєтесь через SOAP) або «HTTP Token».
  • «Відправити в SMS» — надсилати SMS; «Відправник» — ваше зареєстроване альфа-ім’я («Додати відправника» — якщо їх кілька).
  • «Відправити у Viber» — надсилати Viber-повідомлення; «Відправник Viber (Назва бота)». Потрібен HTTP Token.
  • «Канал продажів до відправника» — різні відправники для різних каналів (наприклад, два магазини); «Відправляти смс тільки по призначеним каналам» — продажі інших каналів не отримують SMS.

3. Тексти за статусами

На картці TurboSMS — «Налаштувати SMS»:

Налаштування СМС повідомлень за статусами
  1. Для потрібних статусів продажу («Продано», «На відправку», «Пакування», «Передано в службу доставки», «Доставляється», «Чекає в відділенні», «Забрали», «Відмова», «Відмова від отримання») увімкніть «Надсилати».
  2. Напишіть «Текст СМС». Шорт-коди підставлять дані продажу:
    КодЩо підставиться
    {order_number}номер продажу
    {remote_order_id}номер замовлення з маркетплейсу (або номер продажу)
    {client_name}, {client_first_name}, {client_last_name}ім’я клієнта
    {amount}сума продажу
    {tracking_number}номер ТТН
    {np_number}відділення Нової Пошти
    {receipt_url}посилання на фіскальний чек (якщо підключено ПРРО)
  3. «Зберегти налаштування СМС».

Повідомлення йде, коли продаж переходить у статус — вручну чи автоматично (наприклад, коли служба доставки повідомила, що посилка у відділенні). Номер береться з телефону клієнта в продажу.

💡 Пишіть коротко: одна SMS — до 70 символів кирилицею, довший текст ділиться на кілька платних частин. Viber-повідомлення може бути довшим.

Viber-повідомлення: що потрібно в TurboSMS

Транзакційні Viber-повідомлення (про статус замовлення) TurboSMS надсилає лише за попередньо погодженими шаблонами. Умови встановлює TurboSMS — актуальні уточнюйте в них; на момент написання порядок такий:

  1. Підпишіть з TurboSMS угоду на Viber-розсилки (документи — на turbosms.ua). Після цього TurboSMS додасть Viber-відправника у ваш кабінет (наприклад, загальний відправник INFOBOX або ваш власний).
  2. У розділі шаблонів кабінету TurboSMS зареєструйте шаблони з типом транзакційний. За основу візьміть тексти, які ви налаштували в HugeProfit для статусів (з шорт-кодами на місці змінних даних). Погодження займає кілька робочих днів.
  3. У тексті шаблонів не можна згадувати чи посилатися на відомі маркетплейси — такі шаблони не погоджують.
  4. На сторінці налаштувань API TurboSMS увімкніть «HTTP API», скопіюйте токен і вставте його в «HTTP Token» інтеграції; у «Відправник Viber (Назва бота)» вкажіть погодженого відправника.

Повідомлення, текст яких не збігається з погодженим шаблоном, Viber не доставить. Вартість повідомлень — за тарифами TurboSMS.

Факт відправки SMS можна передавати у свою систему через вебхук «Клієнту надіслано SMS» (API і вебхуки).

Якщо щось не працює

ПроблемаЩо зробити
SMS не надходятьПеревірте баланс TurboSMS, що відправника зареєстровано й він збігається з указаним у HugeProfit, що для статусу ввімкнено «Надсилати», і що в клієнта правильний номер.
Не йдуть Viber-повідомленняПотрібен HTTP Token і зареєстрований Viber-відправник; перевірте в TurboSMS налаштування «Отправка транзакционных Viber-сообщений».
SMS отримують не всі каналиПеревірте «Відправляти смс тільки по призначеним каналам» і прив’язку каналів до відправників.

Телефонія: Binotel і Ringostat

Інтеграція з віртуальною АТС додає в HugeProfit:

  • вікно вхідного дзвінка з номером клієнта — звідти можна відкрити картку клієнта, дописати дані або одразу почати продаж; якщо номер новий — створити клієнта;
  • дзвінок з картки клієнта: у «Клієнти» відкрийте клієнта → іконка Binotel/Ringostat → оберіть оператора;
  • власник акаунта бачить, хто з операторів відповів на дзвінок.

Самі дзвінки йдуть через АТС і програмний телефон (SIP-клієнт) оператора — HugeProfit показує дзвінок і дає швидкий доступ до клієнта. Підключення — «Налаштування» → «Інтеграції» → вкладка «Телефонія».

⚠️ Вікна дзвінків показуються у браузері на комп’ютері, коли HugeProfit відкритий. У мобільному застосунку їх немає.

Binotel

  1. Попросіть у підтримки Binotel (support@binotel.ua) ключі для інтеграції з HugeProfit — їх чотири: REST API Key, REST API Secret, WebSoket Key, WebSoket Secret.
  2. «Телефонія» → Binotel → «Підключити». Заповніть чотири ключі, «Номер на який надходять дзвінки» (ваш номер у Binotel), «Назва» і «Телефонна лінія для Адміністратора» — внутрішній номер (лінію) власника акаунта в Binotel. «Зберегти».
  3. Кожному співробітнику-оператору вкажіть його лінію: «Налаштування» → «Співробітники» → редагувати → поле «Телефонна лінія Binotel» (з’являється, коли Binotel підключено). Номери ліній видно в кабінеті Binotel; нові лінії замовляються в Binotel.
  4. Оператор має бути в мережі в програмному телефоні (MicroSIP, Zoiper та ін. — інструкції в Binotel).

Вхідний дзвінок бачать усі співробітники, яким вказано лінію, і власник; коли хтось відповів — в інших вікно зникає. Вихідний: з картки клієнта оберіть оператора (у списку лише ті, хто в мережі) — спершу задзвонить програмний телефон оператора, після відповіді АТС набере клієнта.

Ringostat

  1. У кабінеті Ringostat: ваш проєкт → «Інтеграції» → «Ringostat API» — скопіюйте Project id та Auth-key.
  2. «Телефонія» → Ringostat → «Підключити» → поля «Project id» і «Auth-key» → «Зберегти».
  3. Після підключення у вікні інтеграції з’являться оператори Ringostat. Для кожного («Оператор: …») оберіть співробітника HugeProfit, який працює під цим оператором, і збережіть. Додали операторів у Ringostat пізніше — «Оновити операторів».
  4. Щоб оператори приймали вхідні, у Ringostat має бути налаштована переадресація на них (налаштовує Ringostat); оператор має бути в мережі в програмному телефоні (Ringostat Smart Phone, Zoiper та ін.).

Дзвінки бачать співробітники, прив’язані до операторів, і власник акаунта. Вихідний — так само з картки клієнта; іконка дзвінка Ringostat є лише в тих, кого прив’язано до оператора (власника теж треба прив’язати, якщо він дзвонить сам).

Якщо телефонія не працює

ПроблемаЩо зробити
Не з’являються вікна дзвінківHugeProfit має бути відкритий у браузері на комп’ютері (не в застосунку). Співробітнику має бути вказана лінія Binotel / він має бути прив’язаний до оператора Ringostat. Оновіть сторінку.
У списку операторів при дзвінку з картки нікого немаєОператори не в мережі в програмному телефоні. Закрийте й відкрийте вікно знову після входу оператора.
Ringostat: нового оператора немає в налаштуваннях«Оновити операторів» у вікні інтеграції.
Binotel: помилка при збереженніЗаповнені не всі чотири ключі або в них зайві пробіли — перевірте ключі, які надіслав Binotel.

Тарифи, номери, лінії й записи розмов — на боці Binotel/Ringostat; HugeProfit за дзвінки окремо не бере.

Більше про повідомлення клієнтам у Viber з HugeProfit.

Введіть слово або запитання