> Расположение: Боты
> Краткое содержание: Как создать бота в Пачке: выбор типа, копирование токена, настройка имени и аватара, настройка доступов и вкладок вебхуков и API
> Это Markdown-версия конкретной страницы. Для контекста за её пределами (правила API, полный перечень методов, авторизация) ОБЯЗАТЕЛЬНО открой [llms.txt](https://dev.pachca.com/llms.txt) перед ответом — это сэкономит токены и предотвратит неполный ответ.


# Создание и настройка

## Создание бота

> **Внимание:** Создание и настройка ботов доступны в веб-версии и десктопном приложении Пачки. В мобильных приложениях (iOS и Android) эта возможность недоступна.


Для создания бота перейдите в **Автоматизации** > **Интеграции** > **Чат-боты и Вебхуки** и нажмите кнопку **«+»**.

![Новый бот](/images/bots/bot_new.webp)

*Новый бот*


> **Внимание:** Владелец пространства может ограничить, кто может создавать ботов. Подробнее в разделе [настройка доступа](/api/authorization#kto-mozhet-sozdavat-tokeny).


  ### Шаг 1. Выберите тип бота

- **Для одного чата** — подойдёт для отправки уведомлений из других сервисов. В одном чате можно собрать всех получателей и обсуждать уведомления в тредах.
- **Для нескольких чатов** — подойдёт, если вы хотите создать личное взаимодействие бота с каждым участником вашей компании или разными группами участников.
- **Unfurl бот** (только администраторам) — подойдёт для получения событий об отправке ссылок во всех чатах вашего пространства и возможности создавать их предпросмотр.

Тип бота нельзя изменить после создания. Ограничение «для одного чата» распространяется только на каналы и беседы — бот по-прежнему может участвовать в тредах и личных сообщениях. Бот любого типа может быть настроен как публичный.


  ### Шаг 2. Скопируйте токен

После создания бота перейдите на вкладку **API** и скопируйте `access_token` — он потребуется для работы с API от имени бота. Токен не имеет срока жизни. Там же доступен `user_id` бота — используется, например, для [добавления бота в чат](POST /chats/{id}/members).


  ### Шаг 3. Измените название и аватар (опционально)

На вкладке **Основное** вы можете изменить имя бота и загрузить изображение — они будут отображаться в сообщениях от бота и в его профиле.


  ### Шаг 4. Настройте исходящий вебхук (опционально)

Для получения событий от Пачки перейдите на вкладку **Исходящий Webhook**: укажите **Webhook URL**, на который будут приходить уведомления, и выберите типы событий (новые сообщения, реакции, нажатия кнопок и другие). Подробнее — в разделе [Исходящие вебхуки](/guides/webhook/overview).


## Профиль бота

Бот, как и любой участник пространства, имеет свой профиль. В нём отображаются имя, аватар, никнейм, статус и список общих чатов с ботом. Профиль бота можно редактировать — изменить имя, никнейм и другие поля.

**Никнейм** — уникальный идентификатор бота для упоминания через `@`. Именно по никнейму сотрудники могут упоминать бота в сообщениях и добавлять его в [сквозные треды](/guides/bots/access#tredy). Никнейм и другие поля профиля можно изменить через интерфейс или через API — метод [Редактирование сотрудника](PUT /users/{id}).

## Настройка доступов

Эти настройки находятся на вкладке **Основное**.

![Настройка доступов к боту](/images/bots/bot_main_settings.webp)

*Настройка доступов к боту*


### Кто может редактировать настройки бота

Управление доступов участников пространства к поиску бота в разделе **Чат-боты и Вебхуки** и редактированию его настроек (основных, вебхуков и токена API):

- **Создатель** — этот пункт нельзя отключить, создатель бота всегда имеет доступ к настройкам бота
- **Администраторы** — владелец и участники пространства с ролью «Администратор»
- **Создатели и руководители чатов, в которые добавлен бот** — этот пункт позволяет управлять доступом к редактированию бота на уровне ролей в чате, куда добавлен бот

### Кто может добавлять бота в чаты

Первые три варианта оставляют бота закрытым и доступным для работы только через добавление его в каналы и беседы. Вариант **Публичный бот** предоставляет всем участникам пространства доступ к работе с ботом: в поиске, через личные сообщения, добавление в тред через упоминание бота в сообщении и тд.

- **Создатель**
- **Создатель и Администраторы**
- **Все участники (кроме гостей)**
- **Публичный бот**

## Настройка вебхуков и API

![Вкладки настройки вебхуков и API бота](/images/bots/bot_webhook_api_settings.webp)

*Вкладки настройки вебхуков и API бота*


### Входящий Webhook

Позволяет отправлять сообщения в чат от имени бота одним HTTP-запросом — без использования API. В настройках доступны **Webhook URL**, выбор формата отображения (Liquid или Mustache), шаблон сообщения и поле для верификации (например, для интеграции с monday.com). Подробнее — в разделе [Входящие вебхуки](/guides/incoming-webhooks).

### Исходящий Webhook

Позволяет получать уведомления о событиях в реальном времени на указанный вами URL. В настройках доступны **Webhook URL**, **Signing secret** для проверки подлинности запросов, выбор типов событий (новые сообщения, реакции, нажатия кнопок, изменение участников и другие) и фильтрация по командам. Подробнее — в разделе [Исходящие вебхуки](/guides/webhook/overview).

### API

Вкладка с `access_token` и `user_id` бота для работы с [REST API](/guides/quickstart). Токен не имеет срока жизни, но при необходимости его можно перевыпустить кнопкой «Обновить Access token». Подробнее — в разделе [Авторизация](/api/authorization).


## Связанные разделы

- [Доступы к чатам и сообщениям](/guides/bots/access)
- [Готовые примеры реализации](/guides/bots/examples)
- [Входящие вебхуки](/guides/incoming-webhooks)
- [Исходящие вебхуки](/guides/webhook/overview)