Интеграция с Google Calendar

Скопировать ссылку на статью

Скопировано

Модуль Google Calendar создаёт события календаря по данным заказов Simla. Событие создаётся, когда заказ переходит в выбранный статус. В событие можно передать дату и время, название, описание, участников, ссылку Google Meet и цвет.

Содержание

1. Возможности модуля
2. Что нужно для настройки
3. Как подключить модуль
4. Как подключить Google-аккаунт
5. Как выбрать календарь и узнать его ID
6. Как настроить создание события
7. Как настроить описание, участников и уведомления
8. Как проверить работу модуля
9. Ошибки и ограничения

Возможности модуля

• создание события Google Calendar при переходе заказа в выбранный статус;
• настройка даты, времени начала и окончания из пользовательских полей заказа;
• создание подходящих пользовательских полей заказа из настроек модуля;
• настройка названия, описания, формата дат и цвета события;
• добавление клиента, менеджера и дополнительных email как участников;
• отправка email-уведомлений участникам;
• создание ссылки Google Meet;
• создание задачи в CRM при ошибке синхронизации;

Что нужно для настройки

Перед началом подготовьте:

• календарь Google Calendar. Для основного календаря достаточно значения primary;
• при использовании другого календаря — его идентификатор календаря;
• статус заказа, при переходе в который должно создаваться событие.

Как подключить модуль

1. Откройте Маркетплейс → Google Calendar и нажмите Подключить.
2. После успешного подключения откройте настройки модуля в CRM.

Как подключить Google-аккаунт

1. В разделе Подключение к Google нажмите Подключить Google-аккаунт.
2. Войдите в существующий Google-аккаунт, используйте тот, которому доступен выбранный календарь.
3. Разрешите модулю работать с Google Calendar.
4. После возврата в CRM убедитесь, что в настройках отображается статус подключённого Google-аккаунта.

Как выбрать календарь и узнать его ID

По умолчанию модуль использует значение primary — основной календарь подключённого Google-аккаунта. Чтобы записывать события в другой календарь, укажите его идентификатор.

1. Сбоку, в списке Мои календари, наведите курсор на нужный календарь, нажмите на три точки ⋮ и выберите Настройки и общий доступ.
2. Прокрутите страницу до раздела Интеграция календаря.
3. Под Идентификатор календаря находится адрес: выделите и скопируйте его. У основного календаря это адрес Gmail, у дополнительного он заканчивается на @group.calendar.google.com.
4. Вставьте это значение в поле Календарь для событий в настройках модуля и сохраните настройки.

Для общего календаря подключённый Google-аккаунт должен иметь право создавать и редактировать события.

Как настроить создание события

1. В блоке Когда создавать событие выберите Статус заказа. Событие будет создаваться, когда заказ перейдёт в этот статус.
2. В блоке Дата и время выберите поля заказа Начало события и Конец события типа «Дата и время».
3. Если подходящего поля нет, выберите Создать новое поле. После сохранения модуль создаст пользовательское поле заказа нужного типа в CRM.
4. Если в CRM уже используются отдельные поля даты и времени, включите Раздельные поля для даты и времени (не рекомендуется) и настройте их. Это устаревшая схема: поле даты и текстовые поля времени в формате ЧЧ:ММ.
5. Нажмите Сохранить настройки.

Примечание

Значение Создать новое поле не создаёт поле в момент выбора. Поле появляется только после успешного сохранения настроек.

Как настроить описание, участников и уведомления

В блоке Название и описание выберите пользовательское поле для названия события или оставьте значение по умолчанию: сайт и номер заказа. Добавьте строки описания и расположите их в нужном порядке. При необходимости выберите формат дат, включите обычный текст или настройте цвет события.

В блоке Участники и уведомления можно:

• добавить клиента, менеджера и email из дополнительного поля как участников;
• включить отправку уведомлений Google участникам;
• создать ссылку Google Meet для события.

В блоке Обработка ошибок и состояние включите создание задачи в CRM при ошибке, если ответственному менеджеру нужно получать уведомления о проблемах синхронизации.

Как проверить работу модуля

1. Сохраните настройки.
2. Создайте или откройте тестовый заказ.
3. Заполните выбранные поля даты и времени либо поля Начало события и Конец события.
4. Переведите заказ в настроенный статус.
5. Дождитесь следующего запуска синхронизации.
6. Откройте выбранный календарь Google и убедитесь, что событие создано с корректными датой, временем, названием и описанием.
7. Если были включены участники или Google Meet, проверьте их наличие в событии.

Ошибки и ограничения

• События не создаются, пока модуль выключен в CRM, обязательные настройки не сохранены или Google-аккаунт не подключён.
• В рекомендуемой схеме используются поля заказа типа «Дата и время» для начала и конца события.
• В раздельной схеме время указывается в формате ЧЧ:ММ, например 09:30; если не выбрать дату окончания, используется дата начала.
• Если выбран общий календарь, у Google-аккаунта должны быть права на создание и изменение событий.
• Уведомления гостям отправляет Google Calendar; их доставка зависит от настроек Google и адресов участников.
• Отключение Google-аккаунта останавливает создание событий, но не удаляет сохранённые настройки модуля.