# Интеграция BotMan и 1С через Albato Source: https://docs.botman.pro/a/87-integratsiya-botman-i-1s-cherez-albato ## Что можно сделать Если вы ведёте клиентов и продажи не в CRM, а в 1С, BotMan можно связать с ней через [Albato](https://albato.ru/integration-botman-1c). Обмен работает в обе стороны. **Из BotMan в 1С** (триггер BotMan → действие 1С): - новый подписчик или заявка из бота → новая запись в справочнике, например контрагент; - оплата в боте → новый документ, например заказ или поступление оплаты; - изменение данных подписчика → обновление записи в справочнике. **Из 1С в BotMan** (триггер 1С → действие BotMan): - новый документ в 1С (заказ, реализация) → сообщение подписчику, тег или запуск сценария в боте. Коннектор 1С в Albato сейчас в статусе **BETA**: возможности могут зависеть от вашей конфигурации 1С. Эта статья — только про 1С. Как зарегистрироваться в Albato, подключить BotMan, а также полный список триггеров и действий BotMan — в статье [Что такое интеграция с Albato](https://docs.botman.pro/a/64-chto-takoe-integratsiya-s-albato). --- ## Что понадобится Платный тариф BotMan, аккаунт Albato и подключённый BotMan — как в [общей статье](https://docs.botman.pro/a/64-chto-takoe-integratsiya-s-albato). Для 1С дополнительно нужны: | Что | Зачем | | --- | --- | | Доступ к базе 1С из интернета | Albato — облачный сервис, поэтому он должен «достучаться» до вашей 1С. Облачная 1С обычно уже доступна; коробочную на своём сервере нужно опубликовать на веб-сервере. Это настраивает ваш специалист по 1С | | Логин и пароль пользователя 1С | Для подключения 1С к Albato. Лучше завести отдельного пользователя с правами только на нужные справочники и документы | **Какой коннектор 1С выбрать** В Albato есть два коннектора 1С с разными возможностями. | | 1C (BETA) | 1С:Бухгалтерия | | --- | --- | --- | | Для каких баз | Универсальный: работает со справочниками и документами конфигурации | Только 1С:Бухгалтерия | | Триггеры | Новая запись в Документе | Счёт покупателю изменён; Поступления на счёт | | Действия | Создать, обновить, удалить, найти запись в Каталоге или Документе; кастомный API-запрос | Новый контрагент; Новый счёт покупателю; Новая номенклатура; Новый договор контрагента | | Страница в Albato | [BotMan + 1С (BETA)](https://albato.ru/integration-botman-1c) | [1С:Бухгалтерия + BotMan](https://albato.ru/integration-onecaccounting-botman) | Если у вас 1С:Бухгалтерия и нужны стандартные операции (контрагент, счёт покупателю, поступление оплаты), выбирайте коннектор **1С:Бухгалтерия** — в нём готовые действия под эти задачи. Для других конфигураций (УНФ, УТ и т.д.) и нестандартных объектов подойдёт **1C (BETA)**. Примеры 1–3 ниже — для 1C (BETA), пример 4 — для 1С:Бухгалтерии. --- ## Как подключить 1С и BotMan к Albato **Шаг 1. Подключите BotMan** Если BotMan ещё не подключён к Albato, сделайте это по разделу «Как подключить BotMan к Albato» в статье [Что такое интеграция с Albato](https://docs.botman.pro/a/64-chto-takoe-integratsiya-s-albato). **Шаг 2. Подготовьте базу 1С** Albato работает с 1С через стандартный интерфейс OData, поэтому база должна быть доступна из интернета. Эту часть обычно делает специалист по 1С или облачный провайдер. Подробная инструкция — в статье Albato [Подключение 1С:Бухгалтерия к Albato](https://help.albato.ru/ru/article/podklyuchenie-1sbuhgalteriya-k-albato-3nv1ob/). 1. **Опубликуйте базу на веб-сервере.** В облачной 1С это обычно делается в личном кабинете провайдера. Для своего сервера нужен веб-сервер Apache или IIS: в Конфигураторе откройте «Администрирование» → «Публикация на веб-сервере», укажите имя (латиницей, без пробелов), веб-сервер и каталог, нажмите «Опубликовать». 2. **Включите интерфейс OData.** В том же окне публикации отметьте «Публиковать стандартный интерфейс OData». В облаке он, как правило, уже включён. 3. **Настройте авторизацию.** Раз база доступна из интернета, у всех пользователей должны быть пароли. Для Albato лучше завести отдельного пользователя с правами только на нужные объекты. В облачной 1С иногда нужна сквозная авторизация — уточните у провайдера. 4. **Настройте состав OData.** В режиме 1С:Предприятие откройте «Сервис и настройки» → «Все функции» и в настройках интерфейса OData отметьте справочники и документы, с которыми будет работать связка. Если пункта «Все функции» нет, включите его в «Сервис и настройки» → «Настройка» → «Параметры». От специалиста вам понадобятся: адрес опубликованной базы, логин и пароль пользователя. **Шаг 3. Подключите 1С в Albato** 1. В Albato откройте Подключения и нажмите Добавить подключение (или добавьте подключение прямо на шаге связки). 2. Выберите **1C (BETA)** или **1С:Бухгалтерия** — в зависимости от выбранного коннектора. 3. Заполните поля подключения. Они немного отличаются: | Поле | 1C (BETA) | 1С:Бухгалтерия | | --- | --- | --- | | Название подключения | Любое, по умолчанию «Мой аккаунт 1C (BETA)» | Любое, по умолчанию «Мой аккаунт 1С:Бухгалтерия» | | Адрес базы | Поле **Домен**, без https:// — например, 1cfresh.com/a/ea/1112254 | Поле **URL**, полный адрес — например, https://1-c.forever.ru/id17632-ac31/ | | Логин и пароль | Пользователь 1С, оба поля обязательные | Пользователь 1С | 4. Нажмите **Далее**. Если проверка прошла успешно, подключение можно использовать в связках. --- ## Пример 1. Новый подписчик → контрагент в 1С **Задача:** каждый новый подписчик бота с телефоном попадает в справочник контрагентов 1С. **Схема:** BotMan: Новый подписчик → фильтр «телефон заполнен» → 1C (BETA): поиск записи в Каталоге → 1C (BETA): создать запись в Каталоге. 1. **Триггер.** Добавить триггер → BotMan → Новый подписчик, выберите подключение BotMan, нажмите «Продолжить» и протестируйте триггер, чтобы получить пример данных. 2. **Фильтр.** Добавьте шаг-фильтр: продолжать, только если поле «Телефон» не пустое. Иначе в 1С попадут подписчики без контактов. 3. **Проверка дубликатов.** Добавить действие → 1C (BETA) → **Поиск записи в Каталоге**: справочник — Контрагенты, поиск по телефону из триггера. 4. **Создание контрагента.** Добавить действие → 1C (BETA) → **Создать запись в Каталоге**: справочник — Контрагенты. Добавьте условие, чтобы шаг выполнялся, только если поиск ничего не нашёл. 5. **Сопоставьте поля** (подставьте значения из триггера): | Поле в 1С | Значение из BotMan | | --- | --- | | Наименование | Имя и фамилия подписчика | | Телефон | Телефон | | Email | Email | | Комментарий | «Из бота BotMan», канал, ID подписчика | 6. Запустите связку и проверьте: подпишитесь на бота с тестового аккаунта и оставьте телефон — в 1С должен появиться контрагент. Телефон из BotMan приходит в формате +79991234567. Если в 1С телефоны хранятся иначе, приведите формат инструментами Albato. ## Пример 2. Оплата в боте → документ в 1С **Задача:** когда подписчик оплачивает счёт в боте, в 1С создаётся документ (например, заказ покупателя или поступление оплаты). **Схема:** BotMan: Новая оплата → 1C (BETA): поиск записи в Каталоге (контрагент) → 1C (BETA): создать запись в Документе. 1. **Триггер.** Добавить триггер → BotMan → Новая оплата, выберите подключение BotMan и протестируйте триггер. Для теста нужна хотя бы одна оплата в боте. 2. **Найдите контрагента.** Добавить действие → 1C (BETA) → **Поиск записи в Каталоге**: справочник — Контрагенты, поиск по телефону или email плательщика. Если контрагента может не быть, добавьте перед документом его создание, как в примере 1. 3. **Создайте документ.** Добавить действие → 1C (BETA) → **Создать запись в Документе**: выберите нужный вид документа и сопоставьте поля: | Поле в 1С | Значение | | --- | --- | | Дата | Дата оплаты из триггера | | Контрагент | Ссылка на контрагента из шага 2 | | Сумма | Сумма оплаты | | Комментарий | Назначение платежа, ID подписчика | 4. Запустите связку и проверьте на тестовой оплате. Документ, созданный через API, может сохраниться без проведения. Уточните у специалиста по 1С, нужно ли проводить его автоматически. Открытые вопросы: - Какие поля передаёт триггер Новая оплата (сумма, валюта, назначение, данные плательщика) — посмотреть в тесте триггера. - Можно ли через 1C (BETA) заполнять табличную часть документа (товары, услуги) и проводить документ. ## Пример 3. Новый документ в 1С → сообщение подписчику **Задача:** когда в 1С создаётся документ (например, реализация или заказ), клиент получает сообщение в боте: «Ваш заказ оформлен». **Схема:** 1C (BETA): Новая запись в Документе → 1C (BETA): поиск записи в Каталоге (контрагент) → BotMan: поиск подписчика → BotMan: отправка сообщения. 1. **Триггер.** Добавить триггер → 1C (BETA) → **Новая запись в Документе**, выберите вид документа и протестируйте триггер. 2. **Получите контакты клиента.** В документе обычно хранится ссылка на контрагента, а не его телефон. Добавьте 1C (BETA) → **Поиск записи в Каталоге**: справочник — Контрагенты, поиск по ссылке из документа. Так вы получите телефон или email. 3. **Найдите подписчика.** Добавить действие → BotMan → **Поиск подписчика**: поле — телефон (в формате +79991234567) или email из шага 2. 4. **Отправьте сообщение.** Добавить действие → BotMan → **Отправка сообщения**: в «ID подписчика» подставьте результат шага 3, в текст — номер и сумму документа. Вместо сообщения можно поставить подписчику тег или запустить сценарий в боте — например, сценарий с отзывом через 3 дня после реализации. Чтобы связка не падала на клиентах, которых нет в боте, добавьте после шага 3 фильтр «подписчик найден». Триггеры 1С в Albato работают по API: Albato не получает событие мгновенно, а сам периодически опрашивает базу. Поэтому сообщение клиенту придёт не сразу после создания документа, а с задержкой в несколько минут. ## Пример 4. 1С:Бухгалтерия: оплата в боте → контрагент и счёт, поступление → сообщение Для 1С:Бухгалтерии удобнее собрать две связки на коннекторе **1С:Бухгалтерия**: одна передаёт продажи из бота в 1С, вторая сообщает клиенту, что деньги поступили. **Связка А. Оплата в боте → контрагент и счёт покупателю** **Схема:** BotMan: Новая оплата → 1С:Бухгалтерия: Новый контрагент → 1С:Бухгалтерия: Новый счёт покупателю. 1. **Триггер.** Добавить триггер → BotMan → **Новая оплата**, выберите подключение BotMan и протестируйте триггер. 2. **Контрагент.** Добавить действие → 1С:Бухгалтерия → **Новый контрагент**: наименование — имя и фамилия подписчика, телефон, email. 3. **Счёт.** Добавить действие → 1С:Бухгалтерия → **Новый счёт покупателю**: контрагент — из шага 2, сумма и назначение — из триггера оплаты. 4. Запустите связку и проверьте на тестовой оплате. Если клиент платит повторно, действие «Новый контрагент» может создать дубль. Проверьте, есть ли у действия настройка поиска дубликатов, или храните признак «контрагент создан» в пользовательском поле BotMan и добавьте фильтр по нему. **Связка Б. Поступление на счёт → сообщение подписчику** **Схема:** 1С:Бухгалтерия: Поступления на счёт → BotMan: поиск подписчика → BotMan: отправка сообщения. 1. **Триггер.** Добавить триггер → 1С:Бухгалтерия → **Поступления на счёт** и протестируйте триггер. 2. **Найдите подписчика.** Добавить действие → BotMan → **Поиск подписчика** по телефону (формат +79991234567) или email плательщика. 3. **Отправьте сообщение.** Добавить действие → BotMan → **Отправка сообщения**: «Оплата получена, спасибо!» — с суммой из триггера. Вместо сообщения можно поставить тег или запустить сценарий, например выдачу доступа. 4. Добавьте после поиска фильтр «подписчик найден», чтобы связка не падала на клиентах, которых нет в боте. Открытые вопросы: - Какие поля передают триггеры «Поступления на счёт» и «Счёт покупателю изменён» — есть ли в них телефон или email плательщика, или их нужно получать отдельно. - Есть ли у действия «Новый контрагент» поиск дубликатов. ## Частые проблемы | Проблема | Что делать | | --- | --- | | Albato не может подключиться к 1С | База недоступна из интернета или адрес указан неверно. Проверьте, что база опубликована и открывается по https, и сверьте адрес с вашим специалистом по 1С | | Ошибка авторизации в 1С | Неверный логин или пароль пользователя 1С, либо у пользователя нет прав на нужные объекты | | Нужного справочника или документа нет в списке | Объект не включён в состав интерфейса OData. Попросите специалиста по 1С добавить его | | В 1С появляются дубли контрагентов | Добавьте перед созданием шаг «Поиск записи в Каталоге» и создавайте запись, только если поиск ничего не нашёл (пример 1) | | Подписчик не находится по телефону из 1С | Номер в 1С записан не в формате BotMan. Приведите его к виду +79991234567 | Ошибки BotMan (тариф, ID подписчика, отправка сообщений) — в разделе «Частые проблемы» статьи [Что такое интеграция с Albato](https://docs.botman.pro/a/64-chto-takoe-integratsiya-s-albato). Вопросы по работе коннектора 1С — в [поддержку Albato](https://help.albato.ru).