Интеграция

Получение записей из youcanbook.me → Отправка сообщения в Telegram

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

Приём записей youcanbook.me через webhook POST: URL источника в Notifications → After new booking → Webhook, поля firstName, email, startsAt, endsAt.
Настройка отправки сообщений в Telegram: подключение бота, режим текста, опции оповещения и текст сообщения для чата, группы или канала.

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

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

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

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

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

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

Личный чат

Найдите в Telegram бота WebJackBot.
Отправьте ему скопированное сообщение /start с токеном.

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

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

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

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

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

В списке типов источника выберите «youcanbook.me» и нажмите кнопку «Выбрать».

Источник «youcanbook.me»

youcanbook.me отправляет webhook после новой записи. Укажите URL источника и получите firstName, email, startsAt, endsAt.

URL вебхука

Выберите нужный тип источника и нажмите «Выбрать».
Нажмите «Сохранить».
Скопируйте «URL» целиком - адрес уже содержит параметры приёма данных.

Настройка в youcanbook.me

В youcanbook.me откройте Notifications.
Выберите After new booking → Webhook.
Вставьте скопированный URL источника.
Сохраните настройки уведомления.

Действие «Отправить сообщение в Телеграм»

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

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

Подключение

В поле «Подключение» выберите ранее созданное подключение типа «Телеграм».

Параметры сообщения

В поле «Режим» выберите «Текст», «Markdown» или «HTML».
При необходимости включите «Отключить предпросмотр ссылок» и «Отключить звуковое оповещение».
В поле «Текст» введите сообщение или подставьте переменные из сценария.
Нажмите «Сохранить».

Оформление текста

Режим в поле «Режим» и разметка в «Текст» должны совпадать.

«Текст» - сообщение без разметки.

«Markdown»

Оформление	Пример
Жирный	`жирный`
Курсив	`_курсив_`
Ссылка	`[текст](https://example.com)`
Код в строке	`код`

Вложенные стили и подчёркивание в «Markdown» не поддерживаются.

«HTML»

Оформление	Пример
Жирный	`<b>жирный</b>`
Курсив	`<i>курсив</i>`
Подчёркнутый	`<u>подчёркнутый</u>`
Зачёркнутый	`<s>зачёркнутый</s>`
Спойлер	`<tg-spoiler>скрытый текст</tg-spoiler>`
Ссылка	`<a href="https://example.com">текст</a>`
Код в строке	`<code>код</code>`
Блок кода	`<pre>блок кода</pre>`

Теги можно вкладывать, например <b>важно: <i>имя</i></b>.

Частые ошибки при настройке действия

Частые ошибки

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

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

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