Mails App - Bitrix24

❌ Приложение не установлено

Для использования приложения необходимо установить его в ваш Bitrix24.

Возможности приложения Письма

📤

Загрузка писем через чат

📋

Скачивание шаблона писем через чат

Инструкция пользователя. Приложение «Письма» для Bitrix24

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

Что умеет приложение

Вести учёт писем по задачам и сделкам: номер, кому, от кого, тема, адрес, дата, файлы.
К каждому письму можно прикреплять приложения (дополнительные файлы).
Создавать письма с готовым документом — по шаблону Word подставляются ваши данные (ФИО, дата, задача, номер письма и т.д.).
Скачивать заполненный шаблон для печати или отправки.
Загружать файлы писем (DOCX, PDF) и автоматически вытаскивать из DOCX данные по оформлению документа.
Работать из карточки задачи, из карточки сделки и из чата с ботом.

Где найти приложение

В задаче
Откройте нужную задачу → внизу или сбоку найдите вкладку «Письма[endpoint]» или «Письма» → откроется виджет с письмами по этой задаче.
В сделке
Откройте сделку в CRM → найдите вкладку «Письма Виджет[endpoint]» или «Письма» → откроется список писем по всем задачам этой сделки.
В чате
Для элемента «Письмо» может быть создан отдельный чат с ботом «Письма[endpoint]». В этом чате доступны команды «Загрузить письмо» и «Скачать шаблон».

Работа в виджете «Письма» в задаче

Что нужно заранее

Задача может быть привязана к сделке (поле связи с CRM в задаче).
У сделки может быть указана компания (наша организация или контрагент).
В карточке компании может быть загружен шаблон письма (поле «Шаблон [endpoint]» или аналог). Если шаблон не настроен, создание письма с заполненным документом и кнопка «Скачать шаблон» могут быть недоступны.
Если шаблон по цепочке «задача → сделка → компания» не найден, приложение предложит выбрать шаблон вручную из списка «Мои компании» при создании письма или скачивании шаблона.

Создать новое письмо

Откройте задачу и перейдите на вкладку «Письма».
Заполните форму «Создать письмо»: Номер письма, Кому, От кого, Тема, Адрес, Дата, Текст письма (необязательно; подставляется в шаблон вместо ${Text}).
Нажмите кнопку «Создать». Если шаблон доступен, будет создано письмо с уже заполненным документом Word.

Загрузка готового .docx: Под таблицей писем нажмите «Загрузить новое письмо», выберите файл. Приложение разберёт документ по стилям абзацев (who, user, address/adress, dateletter, comment, number, text) и откроет форму с подставленными данными.

Скачать шаблон

В виджете задачи нажмите кнопку «Скачать шаблон». Будет сформирован документ Word с подставленными данными и начнётся скачивание. Если шаблон не найден — появится выбор шаблона из «Мои компании».

Просмотр, редактирование и удаление писем

В таблице отображаются все письма по задаче. Доступны ссылка на файл (и приложения, если они есть), кнопки Редактировать и Удалить.

Работа в виджете «Письма» в сделке

Открывается общий список писем по всем задачам сделки. Кнопка «Обновить список» обновляет список без перезагрузки.

Работа с ботом «Письма[endpoint]» в чате

У каждого письма может быть свой чат с ботом. При добавлении бота в чат элемента он может сразу прислать основной файл письма и приложения (дополнительные вложения), если они уже прикреплены. Доступны команды:

«Загрузить письмо» — загрузите файл; бот обновит основной документ письма и прикрепит его к элементу; для DOCX часть данных может подставиться автоматически.
«Скачать шаблон» — бот сформирует документ по шаблону компании и отправит кнопку для скачивания.

Администрирование шаблонов компаний

Если у пользователей не находится шаблон по цепочке «задача → сделка → компания», или в списке «Мои компании» нет шаблонов, администратор может загрузить шаблоны на отдельной странице администрирования.

Откройте страницу «Администрирование» (ссылка доступна только администраторам).
В списке компаний «Моя компания» найдите нужную компанию.
Нажмите «Загрузить шаблон» и выберите файл Word (.docx).
После загрузки рядом станет доступна кнопка «Скачать шаблон» для проверки.

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

Шаблон компании (DOCX) и плейсхолдеры

Для генерации письма по кнопкам «Создать» и «Скачать шаблон» используйте DOCX-шаблон компании с плейсхолдерами ${...}. Это собственный шаблонизатор приложения (PhpWord), не макросы Bitrix24.

Плейсхолдер в DOCX	Что подставляется
`${User}`	ФИО текущего пользователя Bitrix24
`${UserPhone}`	Телефон текущего пользователя (сначала WORK_PHONE, если пусто — PERSONAL_MOBILE)
`${UserEmail}`	Email текущего пользователя
`${dateCurrent}`	Дата письма из формы (поле «Дата» / стиль `dateletter`); если не передана — текущая дата
`${number}`	Номер письма
`${ToWhom}`	Кому
`${FromWho}`	От кого
`${Adress}`	Адрес
`${Theme}`	Тема
`${Text}`	Текст письма (из поля «Текст письма»)

Загрузка готового письма и стили абзацев (DOCX)

Стили абзацев нужны не для шаблона компании, а для разбора уже готового DOCX при загрузке через виджет задачи («Загрузить новое письмо») или через бота («Загрузить письмо»).

Стиль параграфа в Word	Что подставится в поле
`who`	Кому (получатель)
`user`	От кого (отправитель)
`address`	Адрес
`dateletter`	Дата письма
`comment`	Тема/комментарий
`number`	Номер письма
`text`	Текст письма

Для стиля dateletter рекомендуемые форматы даты: dd.mm.yyyy (например, 04.09.2026), yyyy-MM-dd (например, 2026-09-04) или текстовая дата на русском (например, 4 сентября 2026 г.). Также допускается суффикс года: г, г. или года (например, 04.01.2026г, 04.01.2026 г., 04.01.2026 года). После загрузки приложение приводит дату к формату Bitrix yyyy-MM-dd.

Для PDF автоматический разбор полей не выполняется.

Частые вопросы

Почему нет кнопки «Скачать шаблон»? Проверьте: задача привязана к сделке, у сделки указана компания, у компании загружен шаблон.
Письма в сделке не отображаются. Нажмите «Обновить список». Убедитесь, что у сделки есть задачи с письмами.
Бот не скачивает шаблон. У письма должна быть привязка: задача → сделка → компания с шаблоном.
Данные из DOCX не подставились. Если это шаблон компании — проверьте плейсхолдеры ${...}. Если это готовый документ — проверьте стили who, user, address/adress, dateletter, comment, number, text.
Где хранятся все письма? В смарт-процессе «Письма[endpoint]» в Bitrix24 (CRM → Смарт-процессы).

Краткая шпаргалка

Действие	Где делать
Создать письмо с готовым документом по шаблону	Задача → вкладка «Письма» → форма «Создать письмо»
Создать письмо из загруженного .docx	Задача → вкладка «Письма» → «Загрузить новое письмо»
Скачать заполненный шаблон	Задача → «Скачать шаблон» или чат с ботом
Посмотреть все письма по сделке	Сделка → вкладка «Письма»
Загрузить файл письма (DOCX/PDF)	Чат с ботом → «Загрузить письмо»
Редактировать или удалить письмо	Задача → вкладка «Письма» → кнопки в строке письма

Если что-то не работает, обратитесь к администратору портала Bitrix24 или к тому, кто настраивал приложение.

Приложение Письма для Bitrix24