Разговори
Създаване на разговор
Създаване на нова сесия за разговор с AI асистент
POST
Този endpoint създава нова сесия за разговор с AI асистент. Използвайте го за инициране на текстова чат сесия чрез вашия уеб widget или приложение.
Request Body
string
required
UUID на асистента, с който да започне разговора. Трябва да бъде валиден UUID на асистент, който съществува в системата.
string
default:"widget"
Типът на разговора. Възможни стойности:
widget- Разговор чрез уеб widget (по подразбиране, таксуван)test- Тестов разговор (безплатен, за разработка)
object
Персонализирани променливи за предаване към асистента. Тези променливи могат да се използват в системния prompt на асистента и първоначалното съобщение със синтаксис
{{variable_name}}.Обичайни случаи на употреба:- Предварително попълване на клиентска информация от форми
- Предаване на контекст от вашето приложение
- Персонализиране на поведението на асистента за всяка сесия
Response Fields
boolean
Показва дали заявката е била успешна
string
Уникалният UUID идентификатор за създадения разговор. Използвайте този ID за последващи заявки за съобщения.
array
Първоначалната история на разговора. Ако асистентът има конфигурирано първоначално съобщение, то ще бъде включено тук.
Отговори при грешка
boolean
Ще бъде
false когато възникне грешкаstring
Съобщение за грешка, описващо какво се е объркало. Възможни стойности:
Assistant not found- Предоставеният assistant_id не съществуваInsufficient balance. Please top up your account.- Балансът в акаунта на собственика на асистента е твърде нисък
Ценообразуване
- Widget разговори: $0.01 на потребителско съобщение
- Тестови разговори: Безплатни (за разработка и тестване)

