Інтеграція з Planfix

Інтегруйте SMSBAT з CRM Planfix (Планфікс), щоб надсилати повідомлення Viber та SMS безпосередньо із завдань та чатів Планфіксу. Цей посібник охоплює налаштування, роботу з шаблонами та автоматизацію чатів.

Огляд

Інтеграція SMSBAT з Planfix дозволяє вам:

• Надсилати Viber та SMS клієнтам прямо зі звичайних завдань Planfix.
• Автоматично створювати нові завдання (таски) з вхідних повідомлень-чатів.
• Повторно відкривати чати та повертати їх в роботу щоразу, коли клієнти пишуть відповідь.
• Відстежувати статус доставки кожного окремого повідомлення прямо всередині Planfix.

Передумови

• Активний обліковий запис SMSBAT із даними доступу до вашого API.
• Акаунт Planfix із адміністративними правами.
• Зареєстрований та схвалений шаблон Viber Business повідомлення (для ініціації діалогу транзакційним повідомленням).

Крок 1: Підключення Інтеграції

1.1 Увімкнення Chat API у Planfix

Перейдіть до Управління акаунтом > Інтеграції > Чати > Planfix Chat API (Account Management > Integrations > Chats > Planfix Chat API) у вашому кабінеті Planfix.

Виберіть інтеграцію SMSBAT зі списку та увімкніть її.

1.2 Налаштування Параметрів

Заповніть налаштування інтеграції даними, отриманими від SMSBAT:

Параметр	Опис
Request URL (URL для запитів)	Веб-адреса, надана компанією SMSBAT спеціально для прийому запитів
Authorization Key (Ключ Авторизації)	Ваш персональний API-ключ авторизації SMSBAT
Provider (Провайдер)	Заповніть значенням smsbat
Notification URL (URL для сповіщень)	Вебхук, куди Planfix зможе надсилати звіти про доставку. До прикладу: https://api.smsbat.com.ua/planfix/auth/uuid=...
ProviderId	Заповніть значенням smsbat
Planfix Authorization Key	Ключ авторизації на стороні Планфіксу
Task Template (Шаблон завдання)	Оберіть шаблон Планфіксу, за яким буде створюватись завдання при появі нового чату
Contact Template (Шаблон контакту)	Оберіть шаблон, за яким створюватимуться нові клієнтські контакти

Отримання Облікових Даних

Зв'яжіться із нашою службою підтримки SMSBAT на help@smsbat.com, щоб отримати ваші спеціальні ключі авторизації: Request URL, Authorization Key, та Notification URL.

1.3 Налаштування Створення Завдань

Вкажіть, як Планфікс має реагувати на отримання вхідного чат-повідомлення:

• Create a new task if there are no active tasks with this contact (Створювати нове завдання, якщо немає жодного активного) - Увімкніть це, якщо ви використовуєте стратегію "короткої взаємодії з лідом". Тоді кожне нове звернення клієнта породжуватиме нову окрему задачу-тікет у системі.
• Але якщо ваші ділові цикли (наприклад B2B продажі або тривала техпідтримка) довгі — краще залишати цю галочку неактивною і повторно "перевідкривати" (Reopen) існуюче завдання при кожному повідомленні, аби зберегти всю цілісну історію чату з конкретним клієнтом в одному віконці.

Крок 2: Налаштування Шаблонів та Автоматизації

2.1 Налаштування Шаблону Вітального Повідомлення

Погодьте з клієнтом і своїм менеджером шаблон вітального повідомлення (Greeting Template). Заддля того, щоб розпочати діалог, намагайтеся використовувати шаблон транзакційного повідомлення замість рекламного (promo), адже воно значно дешевше.

2.2 Встановлення Шаблону Завдання

Додайте затверджений шаблон вітального повідомлення безпосередньо у поле опису (Description) вашого шаблону завдання Планфіксу. Як тільки буде створене нове завдання (з новим клієнтом), Планфікс автоматично прочитає текст з поля Опису та надішле його клієнту як найперше повідомлення (Icebreaker Message).

Приклад конфігурації:

Поле	Значення
Назва завдання (Task Name)	Запит з Viber Business
Телефон (Phone)	Телефон клієнта
Клієнт (Counterparty)	Контрагент-відправник (лід)
Опис (Description)	Текст вашого ухваленого вітального шаблону повідомлення

2.3 Сценарій "Швидких Взаємодій" (Швидка обробка лідів)

Якщо весь життєвий цикл вашого ліда дуже короткий:

1. Опрацюйте запит клієнта.
2. Дайте йому відповідь безпосередньо через інтерфейс чату Планфікс.
3. Переведіть статус завдання у Завершено (Completed).
4. Оскільки ви ввімкнули галочку із Кроку 1.3, наступного разу, коли клієнт знову вам напише, Планфікс створить під нього абсолютно нове, "чисте" завдання.

2.4 Сценарій "Тривалих Розмов" (Довгі продажі)

Якщо ви не хочете створювати сотню різних мікро-завдань щоразу, коли клієнт задає чергове запитання, налаштуйте автоматизацію повторного відкриття (Chat Reopening).

2.4.1 Відновлення Чату через Транзакційне повідомлення

Створіть сценарій (автоматизацію), який спрацьовуватиме, коли ваше завдання перебуває в статусі "Виконано/Завершено" і ви хочете почати діалог знову:

Сценарій: "Reopen Chat (Повторне відкриття чату)"

Налаштування	Значення
Подія (Event)	Змінено значення поля
Поле (Field)	Поле Start chat (Почати чат)
Умови (Conditions)	Значення Start chat = Yes ТА Статус належить до списку (Completed, Done)
Логіка фільтрації	1 AND 2

Дії Планфіксу (Actions):

1. Додати коментар у задачу з текстом вітального шаблону (повідомляючи при цьому клієнта-контакта як отримувача).
2. Поставити галочку Start chat.
3. Оновити "Заплановану дату виконання" (Planned completion date) на поточну + 1 годину.

2.4.2 Відновлення Чату на кожний Новий Коментар працівника чи ліда

Зробіть сценарії, що "воскрешають" таски кожного разу, коли хтось пише у закритій тасці (чи ви, чи клієнт):

Сценарій: "Reopen Chat (від Працівника)"

Налаштування	Значення
Подія	Додано коментар, що відповідає умовам
Умови	Статус в діапазоні (Completed, Done) ТА Автор коментаря = Працівник
Логіка	1 AND 2

Дії:

1. Змінити статус таски на В Роботі (In Progress)
2. Оновити дату виконання на: поточна дата + 1 година.
3. Оновити назву таски додавши туди поточний Timestamp клієнта.

Сценарій: "Reopen Chat (від Клієнта)"

Налаштування	Значення
Подія	Додано коментар, що відповідає умовам
Умови	Статус в діапазоні (Completed, Done) ТА Автор коментаря = Контакт (Клієнт)
Логіка	1 AND 2

Дії:

1. Змінити статус таски на Новий (New) (щоб працівник його знову побачив).
2. Оновити заплановану дату.
3. Оновити ім'я задачі поточним часом.

Крок 3: Відправка Повідомлень (Сповіщення лідів)

Вказання Отримувачів

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

3.1 Галочка Знята — Клієнт НЕ ОТРИМАЄ повідомлення

Якщо галочка (checkbox) на контакті ліда відключена, Планфікс залишить ваш коментар виключно в межах системи як "Внутрішній лог" (Internal Comment). Клієнт нічого не дізнається. Це корисно для службової переписки програмістів/менеджерів.

3.2 Галочка Стоїть — Клієнт ОТРИМАЄ повідомлення

Якщо галочка ввімкнена, Планфікс передасть цей коментар через Chat API прямо в SMSBAT. Компанія SMSBAT здиригує його і надішле на Viber (чи SMS) вашого клієнта.

3.3 Перевірка Статусу Доставки

Як перевірити доставку в Планфікс

1. Зверніть увагу на іконку сірої (чи зеленої) "Галочки-Чекмарку" поруч з вашим надісланим коментарем.
2. Натисніть на цю іконку і вона розгорне для вас повний звіт розсилки (Delivery Report).

Перевірка звіту

Звіт повинен показати номер телефону вашого клієнта-контакта та поточний статус: Надіслано (Sent) / Доставлено (Delivered). Звіт також показує точну дату та канал доставки (Chat API). Якщо ви бачите там помилку (Error) — статус не доставлено.

Кращі Практики

Робота з Шаблонами

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

Супровід Завдань

• Не забувайте використовувати різні Шаблони Завдань (Task Templates) для різних цілей (Спойлер: "Підтримка", "Продажі", "Жалоби").
• Ставте автоматичне створення тасок ТІЛЬКИ на швидких "одноразових" інцидентах клієнтської підтримки; в іншому разі залиште старі чати перевідкриватись (Reopening Chat).

Вирішення Проблем

Повідомлення не надсилаються взагалі

1. Перевірте, чи не ввели ви з помилками ваш Authorization Key / Notification URL.
2. Упевніться, що номер клієнта-ліда у Планфіксі правильний (перевірте формат — обов'язково E.164).
3. Перевірте, чи стояла "Галочка" сповіщення контакту (Крок 3.2).
4. Переконайтеся, що ви ініціювали діалог верифікованим (одобреним) шаблоном Viber Business.

Завдання (таски) перестали створюватись із нових повідомлень

1. Переконайтесь у налаштуваннях Інтеграції, що у вас ввімкнено опцію "Create a new task if there are no active tasks".
2. Перевірте правильність Шаблону.
3. Перевірте чи не "злетів" Notification URL.

Закриті чати не відновлюються (Немає Reopen)

1. Перевірте чи працює ваша сценарійна логіка автоматизації (чи дійсно коментар відповідає умовам сценарію).
2. Можливо, у вас встановлено статус "Заморожено" замість "Виконано".

Наступні Кроки

• Пізнайте деталі роботи API в документації SMSBAT.
• Дослідіть Типи Повідомлень.
• Зрозумійте, як обробляти статуси повідомлень (Доставлено/Прочитано/Недоставлено).