Skip to main content
GET
/
user
/
conversations
curl -X GET "https://call.aiployees.com/api/user/conversations?type=widget&per_page=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "current_page": 1,
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "widget",
      "message_count": 12,
      "total_cost": 0.0045,
      "ai_enabled": true,
      "created_at": "2025-01-25 14:30:00",
      "updated_at": "2025-01-25 14:45:22"
    },
    {
      "id": "8d0f7780-8536-51ef-055c-f18fd2g01bf8",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "whatsapp",
      "message_count": 8,
      "total_cost": 0.0032,
      "ai_enabled": true,
      "created_at": "2025-01-25 10:15:00",
      "updated_at": "2025-01-25 10:28:45"
    }
  ],
  "first_page_url": "https://call.aiployees.com/api/user/conversations?page=1",
  "from": 1,
  "last_page": 5,
  "last_page_url": "https://call.aiployees.com/api/user/conversations?page=5",
  "links": [
    {
      "url": null,
      "label": "« Previous",
      "active": false
    },
    {
      "url": "https://call.aiployees.com/api/user/conversations?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://call.aiployees.com/api/user/conversations?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://call.aiployees.com/api/user/conversations?page=2",
  "path": "https://call.aiployees.com/api/user/conversations",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15,
  "total": 68
}

Documentation Index

Fetch the complete documentation index at: https://docs.aiployees.com/llms.txt

Use this file to discover all available pages before exploring further.

Този endpoint връща пагиниран списък на разговорите, принадлежащи на асистентите на автентифицирания потребител. Използвайте го за показване на история на разговорите, филтриране по тип или интеграция с вашия CRM.
Този endpoint изисква автентификация. Подайте вашия API ключ в Authorization заглавката като Bearer token.

​
Query параметри

​
type
string
Филтриране на разговори по тип. Възможни стойности: test, widget, whatsapp, api
​
assistant_id
integer
Филтриране на разговори по ID на асистент (трябва да принадлежи на автентифицирания потребител)
​
date_from
string
Филтриране на разговори от тази дата (YYYY-MM-DD формат)
​
date_to
string
Филтриране на разговори до тази дата (YYYY-MM-DD формат)
​
per_page
integer
Брой разговори на страница (1-100, по подразбиране: 15)
​
page
integer
Номер на страницата (по подразбиране: 1)

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

​
data
array
​
current_page
integer
Номерът на текущата страница
​
per_page
integer
Брой елементи на страница
​
total
integer
Общ брой разговори, отговарящи на критериите
​
last_page
integer
Номерът на последната страница
curl -X GET "https://call.aiployees.com/api/user/conversations?type=widget&per_page=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "current_page": 1,
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "widget",
      "message_count": 12,
      "total_cost": 0.0045,
      "ai_enabled": true,
      "created_at": "2025-01-25 14:30:00",
      "updated_at": "2025-01-25 14:45:22"
    },
    {
      "id": "8d0f7780-8536-51ef-055c-f18fd2g01bf8",
      "assistant_id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "assistant_name": "Support Assistant",
      "type": "whatsapp",
      "message_count": 8,
      "total_cost": 0.0032,
      "ai_enabled": true,
      "created_at": "2025-01-25 10:15:00",
      "updated_at": "2025-01-25 10:28:45"
    }
  ],
  "first_page_url": "https://call.aiployees.com/api/user/conversations?page=1",
  "from": 1,
  "last_page": 5,
  "last_page_url": "https://call.aiployees.com/api/user/conversations?page=5",
  "links": [
    {
      "url": null,
      "label": "« Previous",
      "active": false
    },
    {
      "url": "https://call.aiployees.com/api/user/conversations?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://call.aiployees.com/api/user/conversations?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://call.aiployees.com/api/user/conversations?page=2",
  "path": "https://call.aiployees.com/api/user/conversations",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15,
  "total": 68
}

​
Типове разговори

ТипОписание
testВътрешни тестови разговори от интерфейса за тестване на асистента
widgetРазговори от web chat widget-а
whatsappWhatsApp Business разговори
apiРазговори, създадени чрез API

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

  • Analytics табло: Показване на метрики и тенденции на разговорите
  • CRM интеграция: Синхронизация на данните за разговорите с вашата клиентска база данни
  • Мониторинг на качеството: Преглед на обемите разговори по тип и асистент
  • Преглед на фактурирането: Проследяване на разходите за разговори в цялата ви организация