> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/learn/platezhi-integracii-i-uvedomleniya/integrations/online-chat/zendesk.md).

# Подключение Zendesk

Стандартный список типов онлайн-чата iEXExchanger не содержит Zendesk. Поле «App ID» предназначено для поддерживаемых виджетов и не принимает Zendesk snippet. Поэтому Zendesk подключается одним из двух способов: как система email-тикетов без виджета или через отдельное изменение клиентского сайта.

{% hint style="warning" %}
Не вставляйте Zendesk JavaScript в App ID, обработчик тегов или текст страницы. Это не создаёт поддерживаемую интеграцию и может нарушить клиентский сайт или политику безопасности.
{% endhint %}

## Вариант с email-тикетами

Этот вариант не требует изменения iEXExchanger. Клиент пишет на публичный адрес поддержки, почтовый сервер автоматически пересылает сообщение в Zendesk, а ответ оператора возвращается от подтверждённого домена.

1. Создайте Zendesk workspace и настройте роли операторов.
2. В **Admin Center — Channels — Talk and email — Email** откройте управление support addresses.
3. Добавьте внешний адрес, например `support@ваш_домен`, через **Connect external address**.
4. Создайте серверную автоматическую пересылку на выданный Zendesk support address.
5. Завершите проверку пересылки в Zendesk.
6. Добавьте требуемое поставщиком разрешение SPF без второй независимой SPF-записи.
7. Добавьте выданные Zendesk DKIM-записи и только затем включите подпись.
8. Настройте DMARC постепенно и контролируйте отчёты и suspended tickets.
9. Отправьте письмо с внешнего адреса и ответьте из Zendesk.

Zendesk требует серверную пересылку, а не ручное правило почтового клиента, и не поддерживает цепочку из нескольких пересылок. Полный порядок находится в [официальной инструкции](https://support.zendesk.com/hc/en-us/articles/4408886828698-Forwarding-incoming-email-from-your-existing-email-address-to-Zendesk-Support).

Для DKIM используйте точные CNAME-значения текущего аккаунта Zendesk. Не копируйте пример чужого домена. Настройка и порядок включения описаны в [официальной справке](https://support.zendesk.com/hc/en-us/articles/4408822303386-Digitally-signing-your-email-with-DKIM).

## Вариант с Web Widget

Установка Zendesk Web Widget требует изменения кода и нового развёртывания клиентского сайта:

1. В Zendesk откройте **Admin Center — Channels — Messaging and social — Messaging**.
2. Создайте и оформите Web Widget.
3. Добавьте точный рабочий домен в allowlist.
4. Скопируйте snippet из раздела **Installation** в защищённое задание разработчику.
5. Добавьте загрузку виджета в общий шаблон Angular-клиента по правилам проекта.
6. Согласуйте CSP, cookie consent, локали и страницы показа.
7. Соберите и проверьте клиент в тестовой среде.
8. Выполните обычное контролируемое развёртывание.
9. Проверьте диалог, офлайн-сценарий и отсутствие виджета на запрещённом домене.

Официально Zendesk требует вставить snippet перед закрывающим `</body>` или использовать поддерживаемый способ embedding; инструкция находится на странице [Installing the Web Widget for messaging](https://support.zendesk.com/hc/en-us/articles/4500748175258-Installing-the-Web-Widget-for-messaging).

Не храните snippet в произвольном поле панели и не правьте собранный файл прямо на сервере: следующее обновление клиента удалит изменение. Для штатного выбора Zendesk в поле «Тип онлайн чата» требуется отдельная функция продукта с настройкой, загрузчиком и тестами.

## Безопасность и данные

Определите срок хранения тикетов, права агентов, экспорт, удаление и состав передаваемых данных. Не просите клиента присылать секретные ключи, полные реквизиты или документ в обычный чат. Для чувствительных материалов используйте утверждённый защищённый канал.

Ограничьте домены Web Widget, настройте второй фактор операторов и удаляйте доступ уволенных сотрудников. Для email регулярно проверяйте Suspended tickets: ошибки SPF, DKIM, DMARC или пересылки могут отправлять законные обращения в карантин.

## Проверка

Для email отправьте новое письмо, ответ, вложение допустимого типа и повторный ответ в ту же цепочку. Проверьте отправителя, requester, DKIM и отсутствие почтовой петли.

Для виджета проверьте приватное окно, мобильный экран, локали, allowlist, CSP, cookies и сетевые запросы. Затем отключите тестового оператора и убедитесь, что права отозваны.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/learn/platezhi-integracii-i-uvedomleniya/integrations/online-chat/zendesk.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.