# Теги

## Получить список тегов бота

<mark style="color:blue;">`GET`</mark> `https://watbot.ru/api/v1/getBotTags`

Этот метод позволяет получить список всех тегов для определенного бота.

#### Path Parameters

| Name                                      | Type    | Description |
| ----------------------------------------- | ------- | ----------- |
| bot\_id<mark style="color:red;">\*</mark> | integer | ID бота.    |

{% tabs %}
{% tab title="200 Запрос успешно обработан." %}

```
"data": [
  "Одежда",
  "Акция",
  "Горячий"
}
```

{% endtab %}
{% endtabs %}

## Получить список тегов контакта

<mark style="color:blue;">`GET`</mark> `https://watbot.ru/api/v1/getContactTags`

Этот метод позволяет получить список тегов контакта.

#### Path Parameters

| Name                                          | Type    | Description  |
| --------------------------------------------- | ------- | ------------ |
| contact\_id<mark style="color:red;">\*</mark> | integer | ID контакта. |

{% tabs %}
{% tab title="200 Запрос успешно обработан." %}

```
{
  "data": [
    "Горячий", 
    "Реклама"
  ]
}
```

{% endtab %}
{% endtabs %}

## Привязать тег к контакту

<mark style="color:green;">`POST`</mark> `https://watbot.ru/api/v1/attachTagToContact`

Этот метод позволяет привязать тег к контакту по id или имени тега.

#### Request Body

| Name                                          | Type    | Description |
| --------------------------------------------- | ------- | ----------- |
| contact\_id<mark style="color:red;">\*</mark> | integer | ID контакта |
| name<mark style="color:red;">\*</mark>        | string  | Имя тега    |

{% tabs %}
{% tab title="204 Запрос успешно обработан." %}

{% endtab %}
{% endtabs %}

## Отвязать тег от контакта.

<mark style="color:green;">`POST`</mark> `https://watbot.ru/api/v1/detachTagFromContact`

Этот метод позволяет отвязать тег от контакта по id или имени тега.

#### Request Body

| Name                                          | Type    | Description  |
| --------------------------------------------- | ------- | ------------ |
| contact\_id<mark style="color:red;">\*</mark> | integer | ID контакта. |
| name<mark style="color:red;">\*</mark>        | string  | Имя тега.    |

{% tabs %}
{% tab title="204 Запрос успешно обработан." %}

{% endtab %}
{% endtabs %}
