Аккаунты клиентов (Accounts)

Список аккаунтов

Вы можете получить список всех аккаунтов клиентов из вашей компании.

Для этого отправьте следующий GET запрос:

Request

GET https://api.leeloo.ai/api/v1/accounts?limit=3&offset=0&filter[tags]=tag3,tag2

limit - ограничение количества результатов;
offset - сколько результатов пропустить;
filter[tags] - фильтр по тэгам;
tag3,tag2 - список тэгов.

Пример ответа:

Response

{
    "data": [
        {
            "id": "59bbc641b1223300210cdf2f",
            "name": "Kurt Bowie",
            "tags": [
                "tag2"
            ],
            "from": "FACEBOOK",
            "botStatus": "BOT",
            "lastMessageTime": "2017-11-03T08:34:18.417Z",
            "createdAt": "2017-09-15T12:23:29.023Z"
        },
        {
            "id": "5899afd15c97121f006c8b48",
            "name": "Weend Vidente",
            "tags": [
                "68187",
                "tag3"
            ],
            "from": "TELEGRAM",
            "botStatus": "BOT",
            "lastMessageTime": "2017-09-07T14:30:58.798Z",
            "createdAt": "2017-02-07T11:30:25.324Z"
        }
    ],
    "meta": {
        "limit": 3,
        "offset": 0,
        "filteredCount": 2,
        "totalCount": 2
    },
    "status": 1
}

data - массив запрашиваемых аккаунтов;
id - id аккаунта;
name - имя аккаунта;
tags - массив тэгов аккаунта;
from - из какого мессенджера данный аккаунт;
botStatus - статус бот/админ для данного аккаунта;
lastMessageTime - время последнего сообщения;
createdAt - время добавления аккаунта в платформу.

meta:

limit - лимит, установленный в запросе (по усмолчанию 20);
offset - установленный в запросе отступ (по умолчанию 0);
filteredCount - количество результатов в ответе;
totalCount - общее количество результатов, соответсвующих фильтру.

Информация об аккаунте

Вы можете получить подробную информацию об аккаунте по его id.

Пример GET запроса:

Request

GET https://api.leeloo.ai/api/v1/accounts/59bbc641b1223300210cdf2f?include=contactedUsers,orders

59bbc641b1223300210cdf2f - id аккаунта;
include - позволяет включить дополнительные даные в ответ:
- contactedUsers - пользователи платформы, с которыми общался аккаунт;
- orders - список заказов аккаунта.

Пример ответа:

Response

{
    "data": {
        "id": "59bbc641b1223300210cdf2f",
        "name": "Kurt Bowie",
        "tags": [
            "tag3"
        ],
        "from": "FACEBOOK",
        "botStatus": "BOT",
        "gender": "FEMALE",
        "locale": "en_US",
        "subscribeHistory": [
            {
                "tunnelName": "TunnelName_1",
                "leadgentoolName": "LGT_1",
                "trafficSource": "Default traffic source"
            },
            {
                "tunnelName": "TunnelName_2",
                "leadgentoolName": "LGT_2",
                "trafficSource": "TrafficSource_1"
            }
        ],
        "links": {
            "contactedUsers": [
                {
                    "type": "users",
                    "id": "58be00d668aaeaded60aa186"
                }
            ],
            "orders": [
                {
                    "type": "orders",
                    "id": "59f2e2425bb695001a3f6388"
                },
                {
                    "type": "orders",
                    "id": "59edb72dbed51e00152c1c1f"
                },
                {
                    "type": "orders",
                    "id": "59edb6e5da15a0001be1261f"
                }
            ]
        },
        "createdAt": "2017-09-15T12:23:29.023Z",
        "updatedAt": "2017-11-03T11:29:21.528Z"
    },
    "included": {
        "users": [
            {
                "id": "58be00d668aaeaded60aa186",
                "name": "Robert",
                "createdAt": "2017-01-25T13:06:47.652Z",
                "updatedAt": "2017-08-16T09:11:23.002Z"
            }
        ],
        "orders": [
            {
                "price": 1,
                "currency": "UAH",
                "paymentMethod": "ASSET_PAYMENT",
                "status": "SUCCESS",
                "updatedAt": "2017-10-27T07:39:19.363Z"
            },
            {
                "price": 1,
                "currency": "UAH",
                "paymentMethod": "YANDEX_MONEY",
                "status": "SUCCESS",
                "updatedAt": "2017-10-23T09:33:05.403Z"
            },
            {
                "price": 1,
                "currency": "UAH",
                "paymentMethod": "YANDEX_MONEY",
                "status": "SUCCESS",
                "updatedAt": "2017-10-23T09:32:20.164Z"
            }
        ]
    },
    "status": 1
}

data - данные аккаунта;
gender - пол;
locale - локаль аккаунта;
subscribeHistory - история подписок акканута:
- tunnelName - имя туннеля;
- leadgentoolName - имя ЛГТ;
- trafficSource - имя источника траффика.
links - связи аккаунта:
- users - пользователи, общавшиеся с аккаунтом;
- orders - заказы ссформированные аккаунтом.
included - дополнительные данные:
- users - массив пользователей платформы, контактировавших с аккаунтом:
  - id - id пользователя;
  - name - имя пользователя платформы;
  - createdAt - время создания пользователя;
  - updatedAt - время последнего обновления данных пользователя.
- orders - массив заказов (ордеров) сформированных аккаунтом:
  - price - цена заказа;
  - currency - валюта заказа;
  - paymentMethod - название службы, через которую был сформирован заказ;
  - status - текущий статус заказа;
  - updatedAt - время последнего обновления статуса заказа.

История сообщений аккаунта

Вы можете получить сообщения из истории чата с аккаунтом.
Пример GET запроса:

GET https://api.leeloo.ai/api/v1/accounts/59bbc641b1223300210cdf2f/chat-messages?limit=3&offset=0

59bbc641b1223300210cdf2f - id аккаунта;
limit - ограничение количества результатов;
offset - пропуск результатов.

{
    "data": [
        {
            "id": "59fc4b178dd98a000a958b8b",
            "text": "Last message",
            "type": "BOT_MESSAGE",
            "read": true,
            "createdAt": "2017-11-03T10:55:19.024Z",
            "updatedAt": "2017-11-03T10:55:19.024Z"
        },
        {
            "id": "59fc28fa03193700519a72af",
            "text": "Pre last message",
            "type": "YOUR_MESSAGE",
            "read": true,
            "createdAt": "2017-11-03T09:29:46.936Z",
            "updatedAt": "2017-11-03T09:29:46.936Z",
            "links": {
                "createdBy": {
                    "type": "users",
                    "id": "58be00d668aaeaded60aa186"
                }
            }
        },
		{
            "id": "59fc2a14a2493e0047813e24",
            "text": "Good morning!",
            "type": "FRIEND_MESSAGE",
            "read": true,
            "createdAt": "2017-11-03T08:37:28.621Z",
            "updatedAt": "2017-11-03T08:37:28.621Z"
        }
        {
            "id": "59fc2a14a2493e0047813e24",
            "text": "Good morning, {name}! \n\nTest message content",
            "type": "BOT_MESSAGE",
            "read": true,
            "createdAt": "2017-11-03T08:34:24.443Z",
            "updatedAt": "2017-11-03T08:34:24.443Z"
        },
        {
            "id": "59fc2a14a2493e0047813e24",
            "text": "",
            "type": "SYSTEM_MESSAGE",
            "read": true,
            "createdAt": "2017-11-03T08:31:23.321Z",
            "updatedAt": "2017-11-03T08:31:23.321Z"
        }
    ],
    "meta": {
        "limit": 3,
        "offset": 0,
        "filteredCount": 3,
        "totalCount": 113
    },
    "status": 1
}

data - массив сообщений;
id - id сообщения;
text - содержимое сообщения;
type - тип сообщения:
- SYSTEM_MESSAGE - уведомление о действии аккаунта (подписка, формирование и изменение статуса заказа);
- BOT_MESSAGE - сообщения, отправленые без прямого участия пользователя (Рассылка, туннель, умные ответы, приветсвие и т.д.);
- YOUR_MESSAGE - сообщение, отправленное пользователем вручную, через страницу чатов;
- FRIEND_MESSAGE - сообщение, отправленное аккаунтом (клиентом).
read - прочитано ли сообщение (true/false);
createdAt, updatedAt - время появления сообщения в истории чатов.
links:
- createdBy - автор сообщения;
  - id - идентификатор пользователя, отправившего сообщение.