Интеграция

Получение результатов звонков из Zvonok → Отправка сообщения в топик Telegram

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

Настройка приёма результатов звонков Zvonok: сохраните источник, скопируйте URL с макросами и укажите его в postback кампании с методом GET.
Настройка отправки сообщения в топик форум-группы Telegram: подключение, ID или название топика, режим разметки, опции и текст сообщения.

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

Не хотите настраивать сами? Сделаем бесплатно

Напишите, какие сервисы нужно связать. Специалист настроит интеграцию, проверит, что данные доходят, и оставит вам готовый процесс.

Получить бесплатную настройку Или следуйте инструкции ниже

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

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

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

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

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

Личный чат

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

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

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

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

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

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

Источник «Zvonok.com: Результат звонка»

После завершения звонков Zvonok отправляет результат на URL источника. Сохраните источник, скопируйте URL с макросами и укажите его в postback кампании, метод GET.

Выбор типа источника

В списке типов источника выберите «Zvonok.com: Результат звонка» и нажмите кнопку «Выбрать».

Получение результатов звонков из Zvonok

URL постбека

Откройте вкладку «Источник данных».
Скопируйте «URL» целиком - в адресе уже подставлены макросы Zvonok.

Постбек в Zvonok

Откройте кампанию в личном кабинете Zvonok.
В поле postback вставьте скопированный «URL».
Убедитесь, что выбран метод GET, и сохраните настройки кампании.

Действие «Telegram: Отправить сообщение в топик»

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

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

Отправка сообщения в топик Telegram

Подключение

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

Топик

Чтобы писать в существующий топик, укажите «ID топика» - целое число больше нуля. Его можно взять из источника «Telegram: Сообщение в топике» или из Telegram.
Чтобы создать новый топик, оставьте «ID топика» пустым и заполните «Название топика» (до 128 символов). Действие вызовет создание топика и отправит сообщение в него.
Если не указаны ни ID, ни название, действие завершится ошибкой.

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

В поле «Режим» выберите «Текст», «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>.

Результат действия

После выполнения доступны поля:

«ID чата Telegram»
«ID топика» - существующий или только что созданный
«Топик создан» - признак, что топик был создан в этом запуске

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

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

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

Застряли на подключении или полях?

Соберём обработку «Получение результатов звонков из Zvonok → Отправка сообщения в топик Telegram», проверим тест и запустим.

Получить бесплатную настройку