Skip to main content
POST
/
user
/
ai
/
generate-reply
curl -X POST "https://call.aiployees.com/api/user/ai/generate-reply" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_id": 123,
    "customer_identifier": "+14155551234",
    "message": "Hi, I would like to schedule an appointment",
    "variables": {
      "customer_name": "John Smith",
      "source": "whatsapp"
    }
  }'

{
  "success": true,
  "conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "customer_identifier": "+14155551234",
  "reply": "Hi John! I'd be happy to help you schedule an appointment. What day and time work best for you?",
  "function_calls": [],
  "ai_disabled": false
}
Този endpoint генерира AI отговор за дадено съобщение използвайки вашия конфигуриран асистент. Той автоматично създава или използва повторно разговори въз основа на клиентския идентификатор, което го прави идеален за интегриране на AI отговори във външни платформи, CRM системи или персонализирани чат интерфейси.
Ограничена скорост — Този endpoint е ограничен до 5 заявки на минута за API токен за предотвратяване на злоупотреба.

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

​
assistant_id
integer
required
ID-то на асистента, който да се използва за генериране на отговора. Трябва да принадлежи на вашия акаунт.
​
customer_identifier
string
required
Уникален идентификатор за клиента. Използва се за поддържане на контекста на разговора при множество съобщения.Примери: телефонен номер, имейл адрес, ID на контакт от CRM, Facebook потребителски ID.Максимална дължина: 255 символа.
​
message
string
required
Съобщението на клиента, на което да се отговори.
​
variables
object
Опционални контекстови променливи за предаване на асистента. Те се обединяват с всички съществуващи променливи на разговора.Полезни за предаване на клиентски данни, контекст на сесията или други метаданни.

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

​
success
boolean
Показва дали заявката е била успешна
​
conversation_id
string
UUID на разговора. Използвайте го за проследяване или позовавене на разговора по-късно.
​
customer_identifier
string
Клиентският идентификатор предоставен в заявката
​
reply
string
AI-генерираният отговор на съобщението на клиента
​
function_calls
array
Масив от функционални извиквания направени от асистента по време на обработката на съобщението. Празен масив ако няма извикани функции.
​
ai_disabled
boolean
Показва дали AI отговорите са деактивирани за този разговор (например поради ръчно поемане)

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

​
success
boolean
Ще бъде false когато възникне грешка
​
error
string
Съобщение за грешка описващо какво се е объркало
​
error_code
string
Код за грешка четим от машини. Възможни стойности:
  • ASSISTANT_NOT_FOUND - ID-то на асистента е невалидно или не принадлежи на вашия акаунт
  • INSUFFICIENT_BALANCE - Баланса на вашия акаунт е твърде нисък за обработка на съобщението
curl -X POST "https://call.aiployees.com/api/user/ai/generate-reply" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_id": 123,
    "customer_identifier": "+14155551234",
    "message": "Hi, I would like to schedule an appointment",
    "variables": {
      "customer_name": "John Smith",
      "source": "whatsapp"
    }
  }'

{
  "success": true,
  "conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "customer_identifier": "+14155551234",
  "reply": "Hi John! I'd be happy to help you schedule an appointment. What day and time work best for you?",
  "function_calls": [],
  "ai_disabled": false
}

​
Случаи на Употреба

​
Многоканални AI Отговори

Използвайте този endpoint за добавяне на AI отговори към всяка платформа за съобщения:
  1. Получете съобщение от WhatsApp, Facebook, SMS или всеки друг канал
  2. Извикайте този endpoint със съобщението и клиентския идентификатор
  3. Изпратете AI отговора обратно през оригиналния канал

​
CRM Интеграция

Интегрирайте AI отговори в своята CRM или helpdesk система:
  1. Използвайте ID-то на контакта от CRM като customer_identifier
  2. Предайте клиентски данни като variables за персонализирани отговори
  3. Разговорът се запазва между сесиите използвайки същия идентификатор

​
Персонализирани Чат Интерфейси

Изградете свой собствен чат интерфейс захранван от вашия Aiplocalls асистент:
  1. Генерирайте уникален идентификатор за всяка потребителска сесия
  2. Изпращайте съобщения чрез този endpoint
  3. Показвайте AI отговорите във вашия интерфейс

​
Запазване на Разговора

Разговорите се запазват автоматично въз основа на комбинацията assistant_id и customer_identifier:
  • Същия идентификатор: Съобщенията се добавят към съществуващия разговор, запазвайки пълния контекст
  • Нов идентификатор: Създава се нов разговор за клиента
  • Обединяване на променливи: Когато се предоставят променливи, те се обединяват със съществуващите променливи на разговора

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

  1. Използвайте последователни идентификатори: Винаги използвайте същия формат за клиентски идентификатори (например винаги E.164 за телефонни номера)
  2. Предавайте релевантен контекст: Използвайте полето variables за предоставяне на клиентски данни, които помагат на AI да персонализира отговорите
  3. Обработвайте ограниченията на скоростта: Имплементирайте логика за повторни опити с експоненциално забавяне за ограничени по скорост заявки
  4. Запазвайте ID-тата на разговорите: Запазете върнатото conversation_id за по-късна справка или отстраняване на грешки
  5. Наблюдавайте разходите: Проследявайте използването за управление на разходите, особено за високообемни интеграции