# 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.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://wiki.qolio.ru/qolio-or-baza-znanii/integracii/zendesk.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
