Skip to main content
POST
/
conversations
/
{uuid}
/
messages
curl -X POST "https://call.aiployees.com/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/messages" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "I would like to schedule a demo for next week"
  }'

{
  "status": true,
  "message": "I'd be happy to help you schedule a demo! I have availability on Monday at 2 PM, Wednesday at 10 AM, or Friday at 3 PM. Which time works best for you?",
  "function_calls": []
}
Този endpoint изпраща потребителско съобщение към съществуваща беседа и връща отговора на асистента. Асистентът обработва съобщението използвайки конфигурирания AI модел и всички налични инструменти.

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

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

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

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

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

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

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

​
status
boolean
Ще бъде false когато възникне грешка
​
error
string
Съобщение за грешка. Възможни стойности:
  • Conversation not found - Предоставеният UUID не съответства на никоя беседа
  • Insufficient balance. Please top up your account. - Балансът на акаунта на собственика на асистента е твърде нисък
  • Failed to process message: [детайли] - Възникна грешка при обработката на съобщението
curl -X POST "https://call.aiployees.com/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/messages" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "I would like to schedule a demo for next week"
  }'

{
  "status": true,
  "message": "I'd be happy to help you schedule a demo! I have availability on Monday at 2 PM, Wednesday at 10 AM, or Friday at 3 PM. Which time works best for you?",
  "function_calls": []
}

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

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

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

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

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

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