Zendesk

Для создания интеграции в Qolio необходимо 3 значения (Endpoint, Access Token, Client ID):

1. Endpoint. Необходимо предоставить URL который имеет следующий формат(https://yoursubdomain.zendesk.com/api/v2) и по сути является ссылкой на рабочий кабинет Zendesk.

2. 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 (пример: [e-mail]/*token:sukgi6QRn0gPlRMyLmibJYaxY8lINiTcDtesfPUi. Необходимо перейти на сайт

Base64 Encode and Decode - Online вставить полученную строку и нажать encode.

Полученный новый токен необходимо скопировать и использовать для дальнейшего подключения. Новый токен внешне должен быть длиннее предыдущего. Итоговый токен примера (aGFubmEuYmF1dHNpdWtAcW9saW8uaW8vdG9rZW46c3VrZ2k2UVJuMGdQbFJNeUxtaWJKWWF4WThsSU5pVGNEdGVzZlBVaQ==) его и необходимо вставить в поле access_token.