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"
}'
const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';
const response = await fetch(
`https://call.aiployees.com/api/conversations/${conversationId}/messages`,
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
message: 'I would like to schedule a demo for next week'
})
}
);
const data = await response.json();
console.log(data.message);
import requests
conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'
response = requests.post(
f'https://call.aiployees.com/api/conversations/{conversation_id}/messages',
json={
'message': 'I would like to schedule a demo for next week'
}
)
data = response.json()
print(data['message'])
{
"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": []
}
{
"status": true,
"message": "I've checked our calendar and found several available slots for next week. I can offer you Monday at 2 PM, Wednesday at 10 AM, or Friday at 3 PM. Which would you prefer?",
"function_calls": [
{
"name": "check_calendar_availability",
"arguments": {
"start_date": "2025-01-13",
"end_date": "2025-01-17"
},
"result": {
"available_slots": [
"2025-01-13 14:00",
"2025-01-15 10:00",
"2025-01-17 15:00"
]
}
}
]
}
{
"status": false,
"error": "Conversation not found"
}
{
"status": false,
"error": "Insufficient balance. Please top up your account."
}
{
"status": false,
"error": "Failed to process message: Connection timeout"
}
{
"message": "The message field is required.",
"errors": {
"message": ["The message field is required."]
}
}
Разговори
Изпращане на съобщение
Изпращане на съобщение в съществуваща беседа и получаване на отговор от асистента
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"
}'
const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';
const response = await fetch(
`https://call.aiployees.com/api/conversations/${conversationId}/messages`,
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
message: 'I would like to schedule a demo for next week'
})
}
);
const data = await response.json();
console.log(data.message);
import requests
conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'
response = requests.post(
f'https://call.aiployees.com/api/conversations/{conversation_id}/messages',
json={
'message': 'I would like to schedule a demo for next week'
}
)
data = response.json()
print(data['message'])
{
"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": []
}
{
"status": true,
"message": "I've checked our calendar and found several available slots for next week. I can offer you Monday at 2 PM, Wednesday at 10 AM, or Friday at 3 PM. Which would you prefer?",
"function_calls": [
{
"name": "check_calendar_availability",
"arguments": {
"start_date": "2025-01-13",
"end_date": "2025-01-17"
},
"result": {
"available_slots": [
"2025-01-13 14:00",
"2025-01-15 10:00",
"2025-01-17 15:00"
]
}
}
]
}
{
"status": false,
"error": "Conversation not found"
}
{
"status": false,
"error": "Insufficient balance. Please top up your account."
}
{
"status": false,
"error": "Failed to process message: Connection timeout"
}
{
"message": "The message field is required.",
"errors": {
"message": ["The message field is required."]
}
}
Този 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: [детайли]- Възникна грешка при обработката на съобщението
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"
}'
const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';
const response = await fetch(
`https://call.aiployees.com/api/conversations/${conversationId}/messages`,
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
message: 'I would like to schedule a demo for next week'
})
}
);
const data = await response.json();
console.log(data.message);
import requests
conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'
response = requests.post(
f'https://call.aiployees.com/api/conversations/{conversation_id}/messages',
json={
'message': 'I would like to schedule a demo for next week'
}
)
data = response.json()
print(data['message'])
{
"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": []
}
{
"status": true,
"message": "I've checked our calendar and found several available slots for next week. I can offer you Monday at 2 PM, Wednesday at 10 AM, or Friday at 3 PM. Which would you prefer?",
"function_calls": [
{
"name": "check_calendar_availability",
"arguments": {
"start_date": "2025-01-13",
"end_date": "2025-01-17"
},
"result": {
"available_slots": [
"2025-01-13 14:00",
"2025-01-15 10:00",
"2025-01-17 15:00"
]
}
}
]
}
{
"status": false,
"error": "Conversation not found"
}
{
"status": false,
"error": "Insufficient balance. Please top up your account."
}
{
"status": false,
"error": "Failed to process message: Connection timeout"
}
{
"message": "The message field is required.",
"errors": {
"message": ["The message field is required."]
}
}
Ценообразуване
Всяко потребителско съобщение в беседа чрез widget струва $0.01. Тестовите беседи са безплатни.Извиквания на функции
Асистентът може да изпълнява функции по време на обработката на съобщенията, като:- Операции с календар: Проверка на наличност, резервиране на срещи
- Заявки към база знания: Търсене в документация или ЧЗВ
- Персонализирани интеграции: Извикване на вашите конфигурирани webhook endpoints
Най-добри практики
- Обработвайте грешките елегантно: Показвайте удобни за потребителя съобщения при възникване на грешки
- Показвайте състояния на зареждане: Асистентът може да отнеме няколко секунди за отговор, особено при изпълняване на функции
- Запазете ID на беседата: Съхранете UUID на беседата, за да позволите на потребителите да възобновят беседи
- Спазвайте ограниченията за честота: Въведете подходящи забавяния между съобщенията при необходимост

