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


# Боты

## Что такое бот

Бот в Пачке — это посредник между вашим сервисом и мессенджером, действующий от своего имени. Он может отправлять и получать сообщения, реагировать на команды пользователей, открывать интерактивные формы и использовать другие методы, предоставляемые [API](/guides/quickstart).

![Сообщение от бота в Пачке](/images/bots/bot_message.webp)

*Сообщение от бота в Пачке*


> **Внимание:** Бот имеет доступ не ко всем методам API. Например, добавление участников в пространство и экспорт сообщений доступны только с персональным токеном. Подробнее о токенах в разделе [Авторизация](/api/authorization).


> Бот позволяет работать с вебхуками, кнопками и формами в Пачке. Подробнее в разделах [Входящие вебхуки](/guides/incoming-webhooks), [Исходящие вебхуки](/guides/webhook/overview), [Кнопки в сообщениях](/guides/buttons), [Формы](/guides/forms/overview) и [Разворачивание ссылок](/guides/link-previews).


## Типы ботов

Тип выбирается при создании и не меняется. Подробнее о создании — в разделе [Создание и настройка](/guides/bots/setup).

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

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

## Доступность бота

Бот взаимодействует с пространством как участник с ролью **«Сотрудник»**: видит открытые каналы, а в закрытые каналы, треды и личные сообщения его нужно подключать отдельно. Дополнительно бота можно сделать **публичным** — тогда любой участник пространства сможет начать с ним диалог и упоминать через `@никнейм`.

> Бот получает [исходящие вебхуки](/guides/webhook/overview) только из тех чатов и тредов, в которых он состоит. Глобальные события (например, изменение участников пространства) приходят без добавления в чат.


Подробнее — в разделе [Доступы к чатам и сообщениям](/guides/bots/access).

## Подмена имени и аватара отправителя

![Сообщение от бота с подменой имени и аватара](/images/bots/bot_message_ext.webp)

*Сообщение от бота с подменой имени и аватара*


Метод [Новое сообщение](POST /messages) поддерживает поля `display_name` и `display_avatar_url`, позволяющие указать произвольное имя и аватар отправителя для конкретного сообщения. Бейдж **Бот** при этом сохраняется, а при открытии профиля отправителя пользователь увидит оригинальное имя и аватар бота.

Это полезно для миграции сообщений из другого сервиса: бот отправляет сообщения от своего имени, но каждое сообщение отображается с именем и аватаром реального автора из исходной системы.

> Поля `display_name` и `display_avatar_url` доступны только при использовании токена бота. Метод [Редактирование сообщения](PUT /messages/{id}) также поддерживает эти поля.



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

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