Общая информация.
В данной статье описаны способы управления атрибутами клиента с помощью API TWIN.
Атрибут клиента - это специально созданное поле в панели оператора, которое хранит в себе информацию о клиенте. Содержание атрибутов клиента отображается в панели оператора разделе "О клиенте". Атрибуты клиента можно использовать для различных целей, однако основная цель - сообщить оператору необходимую информацию о клиенте. Такой подход поможет улучшить качество взаимодействия между клиентом и оператором.
Создание атрибута через API:
Каждый атрибут создаётся с помощью отдельного запроса.
Метод: POST
Authorization: Bearer Token
URL: https://chat-api.twin24.ai/api/v1/clients/attributes
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":"Имя клиента"}'
{
"name":"Имя клиента"
}
Описание тела запроса:
| Поле | Описание |
|---|---|
name | Устанавливает название для атрибута. |
Пример ответа:
{
"id": "bf1fee...70dc544"
}
Описание тела ответа:
| Поле | Описание |
|---|---|
id | Идентификатор созданного атрибута. |
Результат:
В панели оператора в разделе "О клиенте" появится доступное для редактирования поле "Имя клиента".
Методы для работы с созданными атрибутами:
Метод: GET
Authorization: Bearer Token