Приём обращений по API — тикеты из вашей системы

Обращения из личного кабинета, приложения или бота часто живут в своей таблице, и операторы прыгают между ней и хелпдеском. Приём по API кладёт их в ту же ленту, что почту и мессенджеры: с ответственным, статусом и историей в карточке клиента.

Если в контакте есть почта или телефон, Дескус™ найдёт карточку этого клиента — и переписка из вашей системы окажется рядом с его письмами и звонками.

Тело — JSON: обязательный externalChatId до 190 знаков, text, contact с полями name, email, phone и username, необязательные externalMessageId, occurredAt и attachments — файлы с полями url, filename, mime и kind. Подпись — HMAC-SHA256 от сырого тела на секрете подписи, в заголовке X-Deskus-Signature в виде sha256=<hex>.

Ответ оператора приходит на ваш адрес POST-запросом с полями externalChatId, text и attachments и подписан тем же способом. Проверку подписи достаточно написать один раз — для обоих направлений.

• Повтор с тем же externalMessageId не создаст дубль тикета
• occurredAt — не старше 10 минут: более старые события Дескус™ отбрасывает как повторную отправку
• До 600 запросов в минуту на одно подключение
• Файлы из attachments Дескус™ скачает по публичной ссылке и сохранит в тикете — до 10 в сообщении, до 12 МБ каждый

Если ваш адрес вернул ошибку или не ответил за 15 секунд, у ответа появится «Не доставлено» с кодом и текстом ошибки, а в тикете — запись с причиной. Когда адрес заработает, ответ можно отправить повторно из журнала подключения: дважды он не уйдёт.

ИИ-ассистент Нейтрон Про умеет отвечать клиентам и в этом канале, если вы это разрешите, — его ответ уйдёт на тот же адрес.

Для формы на сайте подключите карточку «HTML-форма» в «Настройки → Каналы → Формы и API» и поставьте адрес приёма в атрибут action формы. Поля name, email и phone попадут в карточку клиента, остальные — в текст заявки.

После отправки посетитель увидит страницу «Спасибо» Дескуса™ или вернётся на ваш адрес из поля «Куда вернуть посетителя». Файлы форма не передаёт — в заявке останется имя файла. Ответить в форму нельзя: ответ из тикета уйдёт письмом, если посетитель оставил почту.