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
}
Този 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 интеграция: Синхронизация на данните за разговорите с вашата клиентска база данни
  • Мониторинг на качеството: Преглед на обемите разговори по тип и асистент
  • Преглед на фактурирането: Проследяване на разходите за разговори в цялата ви организация