Zendesk
Для создания интеграции в Qolio необходимо 3 значения (Endpoint, Access Token, Client ID):
Endpoint. Необходимо предоставить URL который имеет следующий формат(https://yoursubdomain.zendesk.com/api/v2) и по сути является ссылкой на рабочий кабинет Zendesk.
Access Token. Необходимо сгенерировать токен доступа к API для пользователя, который создается для рабочего кабинета Zendesk специально для API соединения. Так же этот токен можно сгенерировать из-под уже существующего пользователя у которого есть admin роль и он находится среди верифицированных пользователей рабочего кабинета Zendesk. В пункте 3 будет подробное описание как настроить эти доступы для нового пользователя. При создании access token из-под уже существуещего пункты 3.2 и 3.3 необходимо проверить перед созданием токена.
2.1 Войти в кабинет Zendesk (https://yoursubdomain.zendesk.com) под пользователем
2.2 Перейти во вкладку Admin(шестеренка) в панели управления слева. В меню Admin Home (слева) найти раздел Сhannels → API
2.3 В отобразившемся окне выбрать графу Token Access и установить значение Enabled
2.4 Нажать на кнопку Add API token для добавления нового токена
2.5 В появившемся окне ввести название токена (например Qolio token, рекомендуется для каждой интеграции иметь отдельный канал и отдельный токен). ОБЯЗАТЕЛЬНО!!!
Cначала скопировать сгенерированный токен (кнопка COPY) и только потом нажать Save. Токен окажется в буфере обмена устройства и необходимо его вставить в какой-нибудь файл для дальнейшего хранения и пересылке партнерам. Это важно так как после первого просмотра токен будет невозможно просмотреть, придется создавать новый.
3. Client ID. Это идентификатор пользователя - по сути email. Для того что бы создать нового пользователя необходимо :
3.1 Следуя инструкции добавить Team Member с ролью Admin. Инструкция : Adding agents and admins
3.2 Верифицировать созданного в системе пользователя. Инструкция: Verifying an end user's email address
Если установлено ограничение по IP необходимо перед запуском интеграции добавить ip адрес 84.201.174.102 в список разрешенных. Инструкция как проверить: Restricting access to Zendesk Support and your Help Center using IP restrictions
Для этого необходимо зайти в новую версию Admin Center:
В новой вкладке откроется окно:
Если после всех шагов подключение не удалось установить, необходимо проверить согласно инструкции
Enabling social and business single sign-on (SSO) включено ли SSO на пользователе из-под которого создается новый пользователь для интеграции, и если нет, то включить и перегенерировать токен заново. Необходимо сформировать строку вида: *client_id/token:access_token_value (пример: hanna.bautsiuk@qolio.io/*token:sukgi6QRn0gPlRMyLmibJYaxY8lINiTcDtesfPUi. Необходимо перейти на сайт
Base64 Encode and Decode - Online вставить полученную строку и нажать encode.
Полученный новый токен необходимо скопировать и использовать для дальнейшего подключения. Новый токен внешне должен быть длиннее предыдущего. Итоговый токен примера (aGFubmEuYmF1dHNpdWtAcW9saW8uaW8vdG9rZW46c3VrZ2k2UVJuMGdQbFJNeUxtaWJKWWF4WThsSU5pVGNEdGVzZlBVaQ==) его и необходимо вставить в поле access_token.
Last updated
