Интеграция BotMan и 1С через Albato

Что можно сделать¶

Если вы ведёте клиентов и продажи не в CRM, а в 1С, BotMan можно связать с ней через Albato. Обмен работает в обе стороны.

Из BotMan в 1С (триггер BotMan → действие 1С):

• новый подписчик или заявка из бота → новая запись в справочнике, например контрагент;

• оплата в боте → новый документ, например заказ или поступление оплаты;

• изменение данных подписчика → обновление записи в справочнике.

Из 1С в BotMan (триггер 1С → действие BotMan):

• новый документ в 1С (заказ, реализация) → сообщение подписчику, тег или запуск сценария в боте.

Коннектор 1С в Albato сейчас в статусе BETA: возможности могут зависеть от вашей конфигурации 1С.

Эта статья — только про 1С. Как зарегистрироваться в Albato, подключить BotMan, а также полный список триггеров и действий BotMan — в статье Что такое интеграция с Albato.

Что понадобится¶

Платный тариф BotMan, аккаунт Albato и подключённый BotMan — как в общей статье. Для 1С дополнительно нужны:

Какой коннектор 1С выбрать

В Albato есть два коннектора 1С с разными возможностями.

Если у вас 1С:Бухгалтерия и нужны стандартные операции (контрагент, счёт покупателю, поступление оплаты), выбирайте коннектор 1С:Бухгалтерия — в нём готовые действия под эти задачи. Для других конфигураций (УНФ, УТ и т.д.) и нестандартных объектов подойдёт 1C (BETA). Примеры 1–3 ниже — для 1C (BETA), пример 4 — для 1С:Бухгалтерии.

Как подключить 1С и BotMan к Albato¶

Шаг 1. Подключите BotMan

Если BotMan ещё не подключён к Albato, сделайте это по разделу «Как подключить BotMan к Albato» в статье Что такое интеграция с Albato.

Шаг 2. Подготовьте базу 1С

Albato работает с 1С через стандартный интерфейс OData, поэтому база должна быть доступна из интернета. Эту часть обычно делает специалист по 1С или облачный провайдер. Подробная инструкция — в статье Albato Подключение 1С:Бухгалтерия к Albato.

1. Опубликуйте базу на веб-сервере. В облачной 1С это обычно делается в личном кабинете провайдера. Для своего сервера нужен веб-сервер Apache или IIS: в Конфигураторе откройте «Администрирование» → «Публикация на веб-сервере», укажите имя (латиницей, без пробелов), веб-сервер и каталог, нажмите «Опубликовать».

2. Включите интерфейс OData. В том же окне публикации отметьте «Публиковать стандартный интерфейс OData». В облаке он, как правило, уже включён.

3. Настройте авторизацию. Раз база доступна из интернета, у всех пользователей должны быть пароли. Для Albato лучше завести отдельного пользователя с правами только на нужные объекты. В облачной 1С иногда нужна сквозная авторизация — уточните у провайдера.

4. Настройте состав OData. В режиме 1С:Предприятие откройте «Сервис и настройки» → «Все функции» и в настройках интерфейса OData отметьте справочники и документы, с которыми будет работать связка. Если пункта «Все функции» нет, включите его в «Сервис и настройки» → «Настройка» → «Параметры».

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

Шаг 3. Подключите 1С в Albato

1. В Albato откройте Подключения и нажмите Добавить подключение (или добавьте подключение прямо на шаге связки).

2. Выберите 1C (BETA) или 1С:Бухгалтерия — в зависимости от выбранного коннектора.

3. Заполните поля подключения. Они немного отличаются:

4. Нажмите Далее. Если проверка прошла успешно, подключение можно использовать в связках.

Пример 1. Новый подписчик → контрагент в 1С¶

Задача: каждый новый подписчик бота с телефоном попадает в справочник контрагентов 1С.

Схема: BotMan: Новый подписчик → фильтр «телефон заполнен» → 1C (BETA): поиск записи в Каталоге → 1C (BETA): создать запись в Каталоге.

1. Триггер. Добавить триггер → BotMan → Новый подписчик, выберите подключение BotMan, нажмите «Продолжить» и протестируйте триггер, чтобы получить пример данных.

2. Фильтр. Добавьте шаг-фильтр: продолжать, только если поле «Телефон» не пустое. Иначе в 1С попадут подписчики без контактов.

3. Проверка дубликатов. Добавить действие → 1C (BETA) → Поиск записи в Каталоге: справочник — Контрагенты, поиск по телефону из триггера.

4. Создание контрагента. Добавить действие → 1C (BETA) → Создать запись в Каталоге: справочник — Контрагенты. Добавьте условие, чтобы шаг выполнялся, только если поиск ничего не нашёл.

5. Сопоставьте поля (подставьте значения из триггера):

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) → Создать запись в Документе: выберите нужный вид документа и сопоставьте поля:

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 плательщика, или их нужно получать отдельно.

• Есть ли у действия «Новый контрагент» поиск дубликатов.

Частые проблемы¶

Ошибки BotMan (тариф, ID подписчика, отправка сообщений) — в разделе «Частые проблемы» статьи Что такое интеграция с Albato. Вопросы по работе коннектора 1С — в поддержку Albato.