Як відбувається активація інтеграції через маркетплейс:
1. Користувач натискає "Підключити" на сторінці вашого додатка в маркетплейсі Altegio.
2. Altegio запитає користувача дозволу на надання доступу до його ЛК по API. Після цього інтеграція може бути активована запитом API з вашого боку.
3. Altegio користувач буде перенаправлений на url форми реєстрації у вашому сервісі, який ви вказали в налаштуваннях програми в полі «Registartion redirect url».
До URL адреси вашої форми реєстрації буде додано GET параметр salon_id. Значення цього параметра - ідентифікатор філії Altegio.
Приклад: https://yoursite.com/signup?salon_id=123
4. Після проходження реєстрації/авторизації на стороні вашого сервісу вам необхідно буде надіслати API запит для активації інтеграції.
Ви повинні надіслати запит протягом 1 години після того, як користувач дав згоду на надання доступу до його ЛК в Altegio (перейшов до вас на сторінку реєстрації). Якщо запит буде надіслано пізніше, ви отримаєте помилку, а користувачеві потрібно буде заново активувати інтеграцію через маркетплейс.
Після надсилання АПІ запиту для активації, інтеграція з вашим сервісом буде підключена до ЛК філії Altegio:
- До особистого кабінету клієнта буде додано ваш системний користувач. ID системного користувача ви вказуєте в налаштуваннях програми в полі «User Id». Ви зможете використовувати bearer токен цього користувача для здійснення запитів до API філії відповідно до запитаних прав доступу.
- На надіслані вами адреси вебхуків почнуть надсилатися події про зміни у філії.
- У випадку, якщо ваша інтеграція знаходиться в категорії «Сповіщення», в налаштування філії також буде додано ваш API_KEY для надсилання системних повідомлень.
Best practices
Рекомендується надсилати запит на активацію інтеграції одразу після завершення реєстрації користувача на стороні вашого сервісу. Після цього ви отримаєте доступ до API філії. Тоді ви зможете по API підтягнути потрібні дані про філію, користувачеві та спростити для неї подальше налаштування інтеграції на вашій стороні.
Також не забудьте передбачити те, що з маркетплейс Altegio до вас може прийти вже зареєстрований/авторизований у вашому сервісі користувач. Надсилайте запит на активацію інтеграції в маркетплейсі не тільки при реєстрації, але при логіні користувача у ваш сервіс або переході користувача з маркетплейсу Altegio відразу в особистий кабінет вашого сервісу.
Зверніть увагу
Автоматична реєстрація користувача у вашій системі
Для спрощення процесу підключення вашої інтеграції ви можете активувати передачу даних користувача при підключенні. У такому разі при підключенні інтеграції ви отримуватимете дані користувача (ім'я, телефон, email) і автоматично реєструватимете його у своїй системі, не змушуючи заповнювати форму. За нашими даними, використання цієї настройки підвищує конверсію на підключення на 30-40%. Детальніше.
Підключення інтеграції відразу до кількох філій
Якщо ваша інтеграція працює з кількома філіями Altegio, то активуйте налаштування «Дозволити додавати додаток до кількох філій». У такому разі, при підключенні, користувачеві буде запропоновано вибрати, до яких філій він хоче встановити інтеграцію. Детальніше.
Підключення та налаштування інтеграції в iframe
Ви можете активувати налаштування "Відкривати форму реєстрації в iframe". Тоді, при натисканні на кнопку «Підключити» сторінка реєстрації вашого сервісу відкриватиметься в тобі «Налаштування» у картці вашої програми у маркетплейсі. Це значно підвищує довіри користувачів до вашого сервісу, т.к. взаємодія з вашим сервісом відбувається у звичному інтерфейсі Altegio. Детальніше.
Коментарі