> For the complete documentation index, see [llms.txt](https://wiki.qolio.ru/qolio-or-baza-znanii/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.qolio.ru/qolio-or-baza-znanii/integracii/zendesk.md).
# 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](https://support.zendesk.com/hc/en-us/articles/4408886939930-Adding-agents-and-admins)
3.2 Верифицировать созданного в системе пользователя. Инструкция: [Verifying an end user's email address](https://support.zendesk.com/hc/en-us/articles/4408886752410-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](https://support.zendesk.com/hc/en-us/articles/4408894156186-Restricting-access-to-Zendesk-Support-and-your-Help-Center-using-IP-restrictions)
Для этого необходимо зайти в новую версию Admin Center:
В новой вкладке откроется окно:
Если после всех шагов подключение не удалось установить, необходимо проверить согласно инструкции
[Enabling social and business single sign-on (SSO)](https://support.zendesk.com/hc/en-us/articles/4408885847962-Enabling-social-and-business-single-sign-on-SSO-) включено ли SSO на пользователе из-под которого создается новый пользователь для интеграции, и если нет, то включить и перегенерировать токен заново. Необходимо сформировать строку вида: \*client\_id/token:access\_token\_value (пример: /\*token:sukgi6QRn0gPlRMyLmibJYaxY8lINiTcDtesfPUi. Необходимо перейти на сайт
[Base64 Encode and Decode - Online](https://www.base64encode.org/) вставить полученную строку и нажать encode.
Полученный новый токен необходимо скопировать и использовать для дальнейшего подключения. Новый токен внешне должен быть длиннее предыдущего. Итоговый токен примера (aGFubmEuYmF1dHNpdWtAcW9saW8uaW8vdG9rZW46c3VrZ2k2UVJuMGdQbFJNeUxtaWJKWWF4WThsSU5pVGNEdGVzZlBVaQ==) его и необходимо вставить в поле access\_token.
