Синхронизация: вебхуки

С помощью вебхуков можно настроить интеграцию «OK,Bob!» с календарями. Мы на примере покажем, как это сделать через сервис Albato с Google Calendar.

Регистрация на Albato

1. Перейдите на сайт Albato:

https://new.albato.ru

2. Зарегистрируйтесь:

*Рекомендуется использовать аккаунт Google Mail для упрощения процесса регистрации.

3. Создайте новую связку:

После регистрации вы будете перенаправлены на главную страницу. Нажмите кнопку "Создать новую связку".

Настройка вебхука

1. Добавьте триггер для связки:

Выберите первый пункт "Добавьте триггер, который будет запускать связку".

2. Выберите вебхук:

Найдите в списка "Выберете сервис, откуда получать данные" пункт "Вебхук".

3. Настройте подключение к вебхуку:

Заполните только поле "Название вашего подключения" произвольным именем. Нажимаем кнопку "Далее".

4. Подтвердите создание вебхука:

После настройки подключения вы получите сообщение об успешной генерации вебхука. Нажимаем кнопку "Понятно".

5. Привязка вебхука:

Нажмите кнопку "Продолжить" для ловли вебхука.

6. Скопируйте URL вебхука:

Скопируйте сгенирированный URL вебхука в буфер обмена.

Интеграция с «OK, Bob!»

1. Откройте настройки профиля в web-интерфейсе или через телеграм:

Перейдите в настройки десктопной версии Hey.OkBob и нажмите "Добавить вебхук" (тариф бизнес).

2. Вставьте URL вебхука:

Вставьте скопированный ранее URL вебхука.

3. Создайте тестовую задачу через телеграм или web-версию:

Создайте задачу любым удобным способом в боте.

4. Проверьте успешность вебхука:

Перейдите в Albato и вы получите уведомление об успешном отлове вебхука в виде всплывающего окна с доступными полями.

Настройка Google Calendar

1. Настройте условия:

Для корректной работы интеграции необходимо настроить Google Calendar. Перейдите в "Добавьте действие, которое будет происходить после старта связки".

2. Добавьте действие в Google Calendar:

Выберите Google Calendar из списка "Выберите сервис, куда передавать данные" и установите действие Создать подробное событие (для создания задачи).

3. Подключите Google Calendar к Albato:

Авторизуйте свой аккаунт Google Calendar в Albato.

4. Настройте поля события:

Заполните необходимые поля следующим образом:

• Дата и время окончания: data-endTime (обязательно)
• Дата и время начала: data-startTime (обязательно)
• Отправка уведомлений о мероприятии: по желанию
• Календарь: выберите нужный календарь
• Статус: подтверждённый
• Название: data-content (обязательно, соответствует названию задачи)

5. Настройте входящий вебхук:

Важно соблюдать следующий формат:Ссылка для вставки кода

{
"googleId": "ID события", 
"id": "data-id"
}

• ID события: выбирается из списка.

• data-id: также выбирается из списка.

Должно получиться так:

После сверки нажимаем кнопку "Сохранить".

6. Запустите интеграцию:

Нажмите кнопку "Запустить".

7. Проверьте результат:

Нажмите кнопку "Проверить результат".

Вы попадёте на страницу отчетности об ошибках:

Тестирование запуска календаря

1. Создайте задачу:

Создайте задачу через телеграм или web-версию

2. Проверка интеграции

Перейдите в Albato и убедитесь, что интеграция работает без ошибок.

3. Проверьте Google Calendar: Убедитесь, что задача появилась в Google Calendar.

Поздравляем! Создание событий в Google Calendar успешно настроено. Теперь перейдём к обновлению и удалению событий.

Обновление и удаление событий

1. Откройте ловец вебхуков:

Перейдите обратно в связку и запустите ловец вебхуков для обработки обновлений нажав на иконку ниже

2. Нажимаем кнопку "Ожидать вебхук"

3. Редактирование задачи через веб-интерфейс:

Перейдите в приложение через web-версию или телеграм и редактируйте созданную через вебхук задачу.

4. Получите необходимые данные:

Перейдите назад в Albato и убедитесь, что в наборе данных присутствуют data-idи data-apis.

Если не удалось получить одно из полей (например, data-apis), создайте новую задачу, запустите цепочку заново и повторите процесс.

5. Добавьте действие удаления события в Google Calendar:

Нажмите на "+"_и "Действие"

• ID мероприятия: data-apis(обязательно)
• Календарь: тот же, что и при создании задачи c вашим google аккаунтом

6. Добавьте действие обновления события в Google Calendar:

• ID мероприятия: data-apis (обязательно)
• Календарь: тот же, что и при создании задачи
• Название: data-content(обязательно)
• Дата и время окончания: data-endTime (обязательно)
• Дата и время начала: data-startTime(обязательно)

7. Настройте роутеры:

Шаги показывают действия в схеме

Инструмент: Прервать связку при условии (Шаг 6)

Условия заполнения строго такие:

Инструмент: Роутер (Шаг 2)

Условия строго такие:

Инструмент: Роутер (Шаг 4)

Условия строго такие:

7. Завершение настройки:

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

Финальное тестирование