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. Спазвайте ограниченията за честота: Въведете подходящи забавяния между съобщенията при необходимост