Публичный API: для чего он нужен

API позволяет вашим системам работать с DeskAI напрямую: заводить обращения, читать переписку, обновлять контакты — без участия человека.

Это не обязательная часть: большинство работает через интерфейс. API нужен, когда у вас есть собственные системы, которые должны обмениваться данными с поддержкой.

Что можно делать

Обращения — создавать, читать список и карточку, отвечать, менять свойства.

Контакты — создавать, читать, обновлять.

Материалы ассистента — читать список, добавлять и запускать поиск по базе.

Каждая область открывается отдельно: ключ выдаётся с правами только на то, что нужно интеграции.

Типичные сценарии

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

Мониторинг. Ваша система заметила сбой у клиента и сама завела обращение, не дожидаясь жалобы.

Синхронизация с CRM. Контакт появился в CRM — появился и в DeskAI, с теми же данными.

Свои отчёты. Выгрузка обращений в вашу аналитику, если встроенной мало.

Поиск по базе знаний ассистента из вашего продукта — например, чтобы показывать подсказки в собственном интерфейсе.

Что API не заменяет

Виджет чата и почтовый канал: для обычного общения с клиентами каналы удобнее и уже всё умеют. API — про машины, а не про переписку.

С чего начать

1. Создайте ключ и выдайте ему только нужные права.
2. Проверьте связь тестовым запросом.
3. Начните с одного сценария — обычно это создание обращений.

Техническое описание методов — в документации API; ссылка на неё есть в разделе интеграций.

Доступность

Функция включается на уровне рабочей области. Если раздела интеграций нет, напишите нам.

Что дальше

Создание и хранение API-ключа. Создание обращений через API.