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

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

В данной статье описаны способы управления атрибутами клиента с помощью 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
theme	DJango
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/{ИДЕНТИФИКТОР_КЛИЕНТА}/attributes/{ИДЕНТИФИКАТОР_АТРИБУТА}' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'Authorization: Bearer TOKEN' \
--data '{"value":"ИМЯ"}'

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

Блок кода

language	bash
theme	DJango
title	Пример тела запроса
linenumbers	true

{
    "value":"Имя"
}

При успешном выполнении метода придет ответ с кодом 200 без тела

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`	Значение атрибута.

Tabs Page

title	Удаление атрибута

Примечание
Данный метод удалит атрибут из системы. После удаления, атрибут не будет отображаться в разделе "О клиенте".

Метод: DELETE

Authorization: Bearer Token

Блок кода

language	bash
theme	DJango
title	cURL
linenumbers	true

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

При успешном выполнении метода придет ответ с кодом 200 без тела.

Tabs Page

title	Удаления значения из атрибута

Метод: DELETE

Authorization: Bearer Token

Блок кода

language	bash
theme	DJango
title	cURL
linenumbers	true

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

При успешном выполнении метода придет ответ с кодом 200 без тела.

Tabs Page

title	Изменение наименование атрибута

Метод: PATCH

Authorization: Bearer Token

Блок кода

language	bash
theme	DJango
title	cURL
linenumbers	true

curl --request PATCH \
     --urllocation 'https://chat-api.twin24.ai/api/v1/clients/attributes/{ИДЕНТИФИКАТОР_АТРИБУТА}'\
     --header 'accept: application/json' \
     --header 'authorization: Bearer TOKEN' \
     --header 'content-type: application/json' \
     --data '{"name":"Ответ клиента"}'

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

Блок кода

language	bash
theme	DJango
title	Пример тела запроса
linenumbers	true

{
    "name":"Ответ клиента"
}

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

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

При успешном выполнении метода придет ответ с кодом 200 без тела.

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

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

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

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

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

Ключ

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

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

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