curl -X POST "https://call.aiployees.com/api/conversations" \
-H "Content-Type: application/json" \
-d '{
"assistant_id": "550e8400-e29b-41d4-a716-446655440000",
"type": "widget",
"variables": {
"customer_name": "John Smith",
"company": "Acme Corp",
"source": "pricing_page"
}
}'
const response = await fetch('https://call.aiployees.com/api/conversations', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
assistant_id: '550e8400-e29b-41d4-a716-446655440000',
type: 'widget',
variables: {
customer_name: 'John Smith',
company: 'Acme Corp',
source: 'pricing_page'
}
})
});
const data = await response.json();
console.log(data.conversation_id);
import requests
response = requests.post(
'https://call.aiployees.com/api/conversations',
json={
'assistant_id': '550e8400-e29b-41d4-a716-446655440000',
'type': 'widget',
'variables': {
'customer_name': 'John Smith',
'company': 'Acme Corp',
'source': 'pricing_page'
}
}
)
data = response.json()
print(data['conversation_id'])
{
"status": true,
"conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"history": [
{
"role": "assistant",
"content": "Hello John Smith! Welcome to Acme Corp support. How can I help you today?"
}
]
}
{
"status": true,
"conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"history": []
}
{
"status": false,
"error": "Assistant not found"
}
{
"status": false,
"error": "Insufficient balance. Please top up your account."
}
Разговори
Създаване на разговор
Създаване на нова сесия за разговор с AI асистент
POST
/
conversations
curl -X POST "https://call.aiployees.com/api/conversations" \
-H "Content-Type: application/json" \
-d '{
"assistant_id": "550e8400-e29b-41d4-a716-446655440000",
"type": "widget",
"variables": {
"customer_name": "John Smith",
"company": "Acme Corp",
"source": "pricing_page"
}
}'
const response = await fetch('https://call.aiployees.com/api/conversations', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
assistant_id: '550e8400-e29b-41d4-a716-446655440000',
type: 'widget',
variables: {
customer_name: 'John Smith',
company: 'Acme Corp',
source: 'pricing_page'
}
})
});
const data = await response.json();
console.log(data.conversation_id);
import requests
response = requests.post(
'https://call.aiployees.com/api/conversations',
json={
'assistant_id': '550e8400-e29b-41d4-a716-446655440000',
'type': 'widget',
'variables': {
'customer_name': 'John Smith',
'company': 'Acme Corp',
'source': 'pricing_page'
}
}
)
data = response.json()
print(data['conversation_id'])
{
"status": true,
"conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"history": [
{
"role": "assistant",
"content": "Hello John Smith! Welcome to Acme Corp support. How can I help you today?"
}
]
}
{
"status": true,
"conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"history": []
}
{
"status": false,
"error": "Assistant not found"
}
{
"status": false,
"error": "Insufficient balance. Please top up your account."
}
Този 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.- Балансът в акаунта на собственика на асистента е твърде нисък
curl -X POST "https://call.aiployees.com/api/conversations" \
-H "Content-Type: application/json" \
-d '{
"assistant_id": "550e8400-e29b-41d4-a716-446655440000",
"type": "widget",
"variables": {
"customer_name": "John Smith",
"company": "Acme Corp",
"source": "pricing_page"
}
}'
const response = await fetch('https://call.aiployees.com/api/conversations', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
assistant_id: '550e8400-e29b-41d4-a716-446655440000',
type: 'widget',
variables: {
customer_name: 'John Smith',
company: 'Acme Corp',
source: 'pricing_page'
}
})
});
const data = await response.json();
console.log(data.conversation_id);
import requests
response = requests.post(
'https://call.aiployees.com/api/conversations',
json={
'assistant_id': '550e8400-e29b-41d4-a716-446655440000',
'type': 'widget',
'variables': {
'customer_name': 'John Smith',
'company': 'Acme Corp',
'source': 'pricing_page'
}
}
)
data = response.json()
print(data['conversation_id'])
{
"status": true,
"conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"history": [
{
"role": "assistant",
"content": "Hello John Smith! Welcome to Acme Corp support. How can I help you today?"
}
]
}
{
"status": true,
"conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"history": []
}
{
"status": false,
"error": "Assistant not found"
}
{
"status": false,
"error": "Insufficient balance. Please top up your account."
}
Ценообразуване
- Widget разговори: $0.01 на потребителско съобщение
- Тестови разговори: Безплатни (за разработка и тестване)