Получение сообщений из топика Telegram Создание или обновление контрагента в Аспро.Cloud

Интеграция

Получение сообщений из топика Telegram Создание или обновление контрагента в Аспро.Cloud

В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:

  1. Приём сообщений из топиков форум-группы Telegram: выберите подключение бота, чтобы в сценарий поступали текст, ID топика и данные отправителя.
  2. Создание или обновление контрагента в Аспро.Cloud: подключение, обработка дубликатов и поля карточки компании или физлица.

Отдельные инструкции: источник «Получение сообщений из топика Telegram» · действие «Создание или обновление контрагента в Аспро.Cloud»

Создание подключений

Если вы ещё не создавали нужные подключения - не пропускайте этот блок: без них настроить интеграцию не получится. Если подключения уже есть в WebJack, можно сразу перейти к настройке источника и действия ниже.

Подключение Telegram

Создание подключения

  1. В левом меню выберите «Подключения» и нажмите «+».
    Подключение Telegram: В левом меню выберите «Подключения» и нажмите «+»
  2. Выберите тип подключения «Телеграм».
    Подключение Telegram: Выберите тип подключения «Телеграм»
  3. Укажите название подключения, чтобы отличать чаты друг от друга.
  4. Скопируйте уникальное сообщение с токеном.
    Подключение Telegram: Скопируйте уникальное сообщение с токеном

Личный чат

  1. Найдите в Telegram бота WebJackBot.
  2. Отправьте ему скопированное сообщение /start с токеном.
    Подключение Telegram: Отправьте ему скопированное сообщение /start с токеном
    Подключение Telegram: Отправьте ему скопированное сообщение /start с токеном

Группа или канал

  1. Добавьте WebJackBot в нужную группу или канал.
  2. Отправьте в этот чат скопированное сообщение /start с токеном.
    Подключение Telegram: Отправьте в этот чат скопированное сообщение /start с токеном

Подключение Аспро.Cloud

Создание подключения

  1. В меню откройте «Подключения» и нажмите «+».
    Подключение Аспро.Cloud: В меню откройте «Подключения» и нажмите «+»
  2. Выберите тип «Аспро.Cloud» и нажмите «Выбрать».
  3. В поле «Портал» укажите адрес аккаунта Аспро.Cloud, например company.aspro.cloud.
  4. Нажмите «Подключить» и авторизуйтесь в Аспро.Cloud.

Создайте обработку

В левом меню откройте «Обработки» и нажмите «+».

integrations: В левом меню откройте «Обработки» и нажмите «+»

В списке типов источника выберите «Telegram: Сообщение в топике» и нажмите кнопку «Выбрать».

Источник «Telegram: Сообщение в топике»

В сценарий начнут поступать сообщения из топиков выбранной форум-группы Telegram. Выберите подключение с этой группой - источник подхватит текст, ID топика и данные отправителя.

Получение сообщений из топика Telegram

Подключение

  1. В поле «Подключение» выберите ранее созданное подключение типа «Телеграм» к форум-группе с топиками.
  2. Нажмите «Сохранить».
    Получение сообщений из топика Telegram: Нажмите «Сохранить»

Источник принимает только сообщения в топиках (не общий топик «General»). Сообщения от ботов и обычные сообщения вне топиков не запускают сценарий.

Какие данные поступят

После сохранения в сценарии будут доступны поля источника:

  • «ID сообщения»
  • «Текст» - текст или подпись к медиа
  • «ID чата Telegram»
  • «ID топика»
  • «Тип чата»
  • «ID отправителя», «Имя», «Фамилия», «Username»
  • «Дата и время»

Действие «Аспро.Cloud: Создать или обновить контрагента»

В Аспро.Cloud будет создан или обновлён контрагент. Выберите подключение, настройте обработку дубликатов и заполните поля карточки компании или физического лица.

Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
actions: Перейдите в обработке во вкладку Действия и нажмите на кнопку Добавить действие

Подключение

  1. В поле «Подключение» выберите подключение Аспро.Cloud.

Дубликаты

  1. В поле «Обработка дубликатов» выберите правило:
    • «Не проверять на дубликаты» — всегда создавать нового контрагента;
    • «Не создавать при дубликате» — если найден, не создавать и не обновлять;
    • «Обновить дубликат, иначе создать» — обновить найденного или создать нового;
    • «Только обновить дубликат» — обновлять только найденного.
  2. Чтобы искать существующего контрагента, отметьте нужные поля для проверки дубля или укажите «ID».
  3. При необходимости включите «Выбирать дубль по макс. ID», если по условиям может найтись несколько записей.

Карточка контрагента

  1. В поле «Тип контрагента» выберите «Юридическое лицо» или «Физическое лицо».
  2. Для юридического лица заполните «Название». Для физического лица заполните «Имя».
  3. При необходимости укажите телефоны, email, ответственного, категорию, сферу деятельности, ИНН, КПП и другие поля.
  4. Заполните дополнительные поля портала, если они отобразились в форме.
  5. Нажмите «Сохранить».

Запустите обработку

  1. В обработку начнут поступать данные из настроенного источника.
  2. По очереди выполнятся все добавленные действия.
  3. Входящие данные, статус и история отобразятся в «Истории операций».

integrations: Входящие данные, статус и история отобразятся в «Истории операций»