ok, bob!

Редакция OK, Bob!

1 октября

Как подключить Google Calendar

Введение

Эта инструкция поможет вам настроить интеграцию Ok,Bob! с Google Calendar через сервис Albato. С её помощью вы сможете автоматизировать создание и обновление событий из OK, Bob! в вашем календаре.

Важно знать! Для настройки потребуется платный тариф в сервисе Albato. Подойдет тариф "Basic", который поддерживает работу с вебхуками и позволяет настроить автоматизацию процессов между приложениями. На 01.10.2024 стоимость тарифа 1690/мес.

Часть 1: Регистрация на Albato

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

https://new.albato.ru

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

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

3. Создайте новый аккаунт:

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

Часть 2: Настройка вебхука

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

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

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

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

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

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

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

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

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

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

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

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

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

Часть 3: Интеграция с Ok, Bob!

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

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

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

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

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

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

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

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

Часть 4: Настройка 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 успешно настроено. Теперь перейдём к обновлению и удалению событий.

Часть 5: Обновление и удаление событий

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" (обязательно)

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

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

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

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

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

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

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