История страницы

Общая информация.

В данной статье описаны способы управления атрибутами клиента с помощью API TWIN.
Атрибут клиента - это специально созданное поле в панели оператора, которое хранит в себе информацию о клиенте. Содержание атрибутов клиента отображается в панели оператора разделе "О клиенте". Атрибуты клиента можно использовать для различных целей, однако основная цель - сообщить оператору необходимую информацию о клиенте. Такой подход поможет улучшить качество взаимодействия между клиентом и оператором.

Создание атрибута через API:

Информация
Каждый атрибут создаётся с помощью отдельного запроса.

Метод: POST

Authorization: Bearer Token

URL:https://chat-api.twin24.ai/api/v1/clients/attributes

Блок кода

language	bash
theme	DJango
title	cURL
linenumbers	true

 curl --location 'https://chat-api.twin24.ai/api/v1/clients/attributes' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'Authorization: Bearer TOKEN' \
--data '{"name":"Имя клиента"}'

Блок кода

language	bash
title	Пример тела запроса

{
      "name":"Имя клиента"
}

Описание тела запроса:

Поле	Описание
`name`	Устанавливает название для атрибута.

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

Блок кода

language	bash
theme	DJango
title	Пример ответа
linenumbers	true

 {
    "id": "bf1fee...70dc544"
 }

Описание тела ответа:

Поле	Описание
`id`	Идентификатор созданного атрибута.

Результат:

В панели оператора в разделе "О клиенте" появится доступное для редактирования поле "Имя клиента".

Методы для работы с созданными атрибутами:

Tabs Container

direction	horizontal

Tabs Page

title	Получение списка всех атрибутов

Метод: GET

Authorization: Bearer Token

Блок кода

language	bash
theme	DJango
title	cUrl
linenumbers	true

curl --location 'https://chat-api.twin24.ai/api/v1/clients/attributes' \
--header 'accept: application/json' \
--header 'Authorization: Bearer TOKEN'

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

Блок кода

language	bash
theme	DJango
title	Пример ответа
linenumbers	true

{
    "count": 3,
    "items": [
        {
            "id": "bf1fee...70dc544",
            "companyId": 123,
            "name": "Имя клиента"
        },
        {
            "id": "bf1fee...70dc544",
            "companyId": 123,
            "name": "Возраст"
        },
        {
            "id": "bf1fee...70dc544",
            "companyId": 123,
            "name": "Тема обращения"
        }
    ]
}

Описание полей ответа:

Поле	Описание
`count`	Общее кол-во атрибутов
`items`	Array[Object]
\| `id`	Идентификатор атрибута.
\| `companyId`	Идентификатор компании.
\| `name`	Название атрибута.

Tabs Page

title	Добавление информации в атрибут

Метод: POST

Authorization: Bearer Token

Блок кода

language	bash
theme	DJango
title	cURL
linenumbers	true

curl --location 'https://chat-api.twin24.ai/api/v1/clients/{clientIdИДЕНТИФИКТОР_КЛИЕНТА}/attributes/{attributeIdИДЕНТИФИКАТОР_АТРИБУТА}' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'Authorization: Bearer TOKEN' \
--data '{"value":"ИМЯ"}'

Пример тела запроса:

Блок кода
{ "value":"ДиитрийИмя" }

Ответ: 200 OK

Tabs Page

title	Получение атрибутов по клиенту

Метод: GET

Authorization: Bearer Token

Блок кода

language	bash
theme	DJango
title	cURL
linenumbers	true

curl --location 'https://chat-api.twin24.ai/api/v1/clients/{ИДЕНТИФИКТОР_КЛИЕНТА}/attributes' \
--header 'accept: application/json' \
--header 'Authorization: Bearer TOKEN'

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

Блок кода

language	bash
theme	DJango
title	Ответ
linenumbers	true

{
    "count": 1,
    "items": [
        {
            "id": "0c1f0-...-9dc052045452",
            "clientId": "35e45a67-...-9dc052045452",
            "companyId": 123,
            "name": "Имя клиента",
            "value": "Иван"
        }
    ]
}

Описание полей ответа:

Поле	Описание поля
`count`	Количество найденных атрибутов клиента
`items`	Array[Object]
\| `items`	Идентификатор атрибута
\| `clientId`	Идентификатор клиента
\| `companyId`	Идентификатор компании
\| `name`	Название атрибута
\| value	Значение атрибута

Быстрые ссылки

Дерево страниц

Сравнение версий

Старая версия 5

Новая версия 6

Ключ

Общая информация.

Создание атрибута через API:

Методы для работы с созданными атрибутами: