Skip to main content
POST
Този endpoint изпраща потребителско съобщение към съществуваща беседа и връща отговора на асистента. Асистентът обработва съобщението използвайки конфигурирания AI модел и всички налични инструменти.

Параметри на пътя

string
required
Уникалният UUID идентификатор на беседата

Тяло на заявката

string
required
Съобщението на потребителя за изпращане към асистента. Максимална дължина: 2000 символа.

Полета на отговора

boolean
Показва дали заявката е била успешна
string
Отговорът на асистента към съобщението на потребителя
array
Масив от извиквания на функции, направени от асистента по време на обработката на съобщението. Празен масив, ако не са извиквани функции.

Отговори при грешки

boolean
Ще бъде false когато възникне грешка
string
Съобщение за грешка. Възможни стойности:
  • Conversation not found - Предоставеният UUID не съответства на никоя беседа
  • Insufficient balance. Please top up your account. - Балансът на акаунта на собственика на асистента е твърде нисък
  • Failed to process message: [детайли] - Възникна грешка при обработката на съобщението

Ценообразуване

Всяко потребителско съобщение в беседа чрез widget струва $0.01. Тестовите беседи са безплатни.

Извиквания на функции

Асистентът може да изпълнява функции по време на обработката на съобщенията, като:
  • Операции с календар: Проверка на наличност, резервиране на срещи
  • Заявки към база знания: Търсене в документация или ЧЗВ
  • Персонализирани интеграции: Извикване на вашите конфигурирани webhook endpoints
Резултатите от извикването на функции са включени в отговора, така че можете да покажете релевантна информация на потребителя или да проследите предприетите действия.

Най-добри практики

  1. Обработвайте грешките елегантно: Показвайте удобни за потребителя съобщения при възникване на грешки
  2. Показвайте състояния на зареждане: Асистентът може да отнеме няколко секунди за отговор, особено при изпълняване на функции
  3. Запазете ID на беседата: Съхранете UUID на беседата, за да позволите на потребителите да възобновят беседи
  4. Спазвайте ограниченията за честота: Въведете подходящи забавяния между съобщенията при необходимост