ВАЖНО

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

Выгрузить историю диалогов и аналитику по ним через интерфейс Платформы будет невозможно.

Для интеграции с ботом по API необходимо реализовать следующую схему

1. Получение токена для авторизации

Важно:

У токена есть время жизни
Рекомендуем устанавливать время жизни токена 24 часа и обновлять за 15 минут до окончания
Также токен нужно обновлять при получении 403 ошибки от любого метода Twin
Для обновления можно использовать тот же метод или метод обновления по рефреш токену (https://confluence.twin24.ai/x/vQHLBg)

2. Создание сессии бота

Важно:

Есть 2 варианта взаимодействия с API: синхронный и асинхронный
- Синхронный – ответ бота будет в ответе от метода
- Асинхронный – ответ бота будет отправлен на URL, который будет указан в методе в поле "callbackUrl"