Как происходит активация интеграции через маркетплейс:
1. Пользователь нажимает «Подключить» на странице вашего приложения в маркетплейсе Altegio.
2. Altegio запросит у пользователя разрешение на предоставление доступа к его ЛК по API. После этого интеграция может быть активирована API запросом с вашей стороны.
3. Из Altegio пользователь будет перенаправлен на url формы регистрации в вашем сервисе, который вы указали в настройках приложения в поле «Registration redirect url».
К url адресу вашей формы регистрации будет добавлен GET параметр salon_id. Значение этого параметра — идентификатор филиала в Altegio и CRM-токен из раздела Телефония-Интеграция в сети клиента. По этим salon_id и нужно будет активировать приложение. Дополнительно будет пробрасываться salon_group_id - это номер сети, к которой принадлежат филиалы. Параметр поможет в дополнительной идентификации клиента.
4. После прохождения регистрации/авторизации на стороне вашего сервиса, вам необходимо будет отправить API запрос для активации интеграции.
Пример: http://yoursite.com/registraciya?salon_group_id=123&crm_token=asdasd-asda-asdd-asdd&salon_ids[]=4564&salon_ids[]=4232
ВАЖНО: Вы должны отправить запрос в течение 1 часа после того, как пользователь дал согласие на предоставление доступа к его ЛК в Altegio (перешел к вам на страницу регистрации). Если запрос будет отправлен позже, то вы получите ошибку, а пользователю нужно будет заново активировать интеграцию через маркетплейс.
После отправки АПИ запроса для активации, интеграция с вашим сервисом будет подключена в ЛК филиала Altegio: на переданные вами адреса вебхуков начнут отправляться события об изменениях в филиале.
5. Вместе с передачей активации интеграции приложения в маркетплейсе необходимо будет передать API запрос на включение телефонии клиенту по старому протоколу.
6. Реализуйте остальные методы для работы телефонии: сохранение информации о звонке и Уведомление о звонке и отключение телефонии.
Best practices
Рекомендуется отправлять запрос на активацию интеграции сразу после завершения регистрации пользователя на стороне вашего сервиса. После этого вы получите доступ к API филиала. Тогда вы сможете по API подтянуть нужные данные о филиале, пользователю и упростить для него дальнейшую настройку интеграции на вашей стороне.
Также не забудьте предусмотреть то, что из маркетплейса Altegio к вам может прийти уже зарегистрированный/авторизованный в вашем сервисе пользователь. Отправляйте запрос на активацию интеграции в маркетплейсе не только при регистрации, но и при логине пользователя в ваш сервис или переходе пользователя из маркетплейса Altegio сразу в личный кабинет вашего сервиса.
Обратите внимание
Автоматическая регистрация пользователя в вашей системе
Для упрощения процесса подключения вашей интеграции, вы можете активировать передачу данных пользователя при подключении. В таком случае при подключении интеграции, вы будете получать данные пользователя (имя, телефон, email) и автоматически регистрировать его в своей системе, не заставляя заполнять форму. По нашим данным, использование этой настройки повышает конверсию в подключение на 30-40%. Подробнее.
Подключение и настройка интеграции в iframe
Вы можете активировать настройку «Открывать форму регистрации в iframe». Тогда при нажатии на кнопку «Подключить» страница регистрации вашего сервиса будет открываться в табе «Настройки» в карточке вашего приложения в маркетплейсе. Это существенно повышает доверия пользователей к вашему сервису, т.к. взаимодействие с вашим сервисом происходит в привычном интерфейсе Altegio. Подробнее.
Комментарии