Інтеграція WorkPan з сайтом: як автоматизувати створення заявок

Коли клієнт залишає заявку на ремонт на вашому сайті, він хоче отримати відповідь максимально швидко. Якщо приймальник змушений вручну переносити дані з електронної пошти або Telegram у CRM, час реакції збільшується, а ризик припуститися помилки — зростає.

WorkPan має API, який дозволяє автоматизувати цей процес: заявка, відправлена клієнтом через форму на сайті, може потрапляти в систему автоматично.

Як працює інтеграція

Принцип простий: ваш сайт виступає в ролі клієнта, який відправляє запит у WorkPan через захищене з’єднання.

1. Отримання доступу. У розділі «Модулі» панелі управління WorkPan ви вмикаєте API і генеруєте персональний token. Це «ключ», який дозволяє вашому сайту «спілкуватися» з CRM.
2. Запит до системи. При відправці форми на сайті ваш сервер формує JSON-запит до API WorkPan, передаючи дані клієнта та опис несправності.
3. Створення заявки. У системі з’являється нова заявка. Приймальнику залишається тільки зв’язатися з клієнтом для підтвердження деталей.

Що можна зробити через API

Інтеграція через API не обмежується тільки створенням заявок. Розробники можуть реалізувати повноцінний особистий кабінет для клієнта на вашому сайті:

• Перевірка статусу ремонту. Клієнт вводить номер заявки на вашому сайті, сайт робить запит до методу /api/order-status/, і клієнт бачить, на якому етапі знаходиться його апарат («Діагностика», «Ремонт», «Готово до видачі»).
• Історія звернень. Використовуючи методи /api/get-contact-by-id/ або /api/get-order-by-id/, можна виводити клієнту історію його ремонтів.
• Автоматичні повідомлення. Сайт може забирати інформацію про статус замовлення і відправляти клієнту SMS або email-повідомлення без участі адміністратора.

Технічна сторона

WorkPan API працює за протоколом HTTP (методи GET/POST), а дані повертаються у форматі JSON. Це стандарт, який підтримує будь-яка сучасна мова програмування — чи то PHP, Python, чи Node.js.

Усі технічні деталі, приклади запитів (наприклад, як зробити запит до /api/order-status/) та опис полів ви можете знайти в розділі API для розробників.

Важливі правила роботи з API:

• Безпека. Ніколи не зберігайте token у відкритому доступі на стороні фронтенду сайту. Робіть усі запити через свій сервер (бекенд).
• Обмеження. Встановлено ліміт у 8 запитів на секунду. Цього цілком достатньо для роботи форм на сайті, але не варто використовувати API для масового перебору даних.
• Тільки документовані методи. Не намагайтеся «вгадати» ендпоінти, яких немає в документації. Використовуйте тільки ті методи, які там описані.

З чого почати

Якщо у вас є штатний розробник або ви працюєте з аутсорс-командою:

1. Дайте їм посилання на документацію API.
2. Згенеруйте token у панелі управління WorkPan.
3. Поставте завдання: «Зробити так, щоб при заповненні форми “Записатися на ремонт” заявка автоматично з’являлася у WorkPan».

Інтеграція сайту з CRM — це крок до того, щоб перетворити ваш сайт з «візитки» на повноцінний робочий інструмент, який не просто інформує клієнтів, а й сам приймає замовлення, звільняючи час приймальникам.