Zendesk

Подключение Zendesk к Charo — API-токен, выбор между статьями базы знаний и тикетами.

Что индексируется

По выбору в поле «Тип содержимого»:

articles — статьи Help Center с метками;
tickets — тикеты с автором, приоритетом и статусом.

Чтобы индексировать и то и другое, создайте два коннектора.

Предварительные требования

Аккаунт Zendesk с включённым API-доступом и правами администратора для выпуска токена.

Получение учётных данных

В админ-центре Zendesk откройте Apps and integrations → APIs → Zendesk API и включите Token access, создайте API-токен.
В Charo заполните: «Поддомен Zendesk» (из адреса <поддомен>.zendesk.com), «Email Zendesk» (учётная запись, от имени которой работает токен) и токен.

Настройка в Charo

Поле	Что указать
Тип содержимого	`articles` (по умолчанию) или `tickets`
API-запросов в минуту	необязательно: ограничить скорость обращения к API (расширенная настройка)

Синхронизация прав

Не поддерживается: управляйте доступом видимостью коннектора и группами (см. «Права доступа»). Учтите это для тикетов — они могут содержать персональные данные клиентов.

Ограничения и частота обновления

Скорость ограничена лимитами API Zendesk; при появлении ошибок 429 задайте «API-запросов в минуту».
Обновления забираются инкрементально по расписанию коннектора.

Устранение неполадок

«401 Unauthorized»

Token access выключен, либо email не совпадает с владельцем токена. Формат аутентификации — email/token, проверьте оба поля.

«429 Too Many Requests»

Уменьшите «API-запросов в минуту» — лимиты зависят от тарифа Zendesk.

Статьи есть, а тикетов нет (или наоборот)

Один коннектор индексирует один тип содержимого — создайте второй коннектор с другим значением «Типа содержимого».