Microsoft Bookings (предварительная версия)

Microsoft Bookings — это средство планирования и входит в семейство продуктов Microsoft Office. Он позволяет пользователям и организациям создавать страницы резервирования и легко бронировать встречи клиентов.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Стандарт Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Стандарт Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Стандарт Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Поддержка Microsoft 365
URL https://support.microsoft.com/en-us/contactus#
Метаданные соединителя
Publisher Корпорация Майкрософт
Веб-сайт https://book.ms
Политика конфиденциальности https://docs.microsoft.com/en-us/microsoft-365/bookings/bookings-faq?view=o365-worldwide#privacy
Категории Управление бизнесом; Сотрудничество

Соединитель Microsoft Bookings построен с целью расширения встреч Booking с другими функциями, которые power platform должен предложить. Вы когда-нибудь искали пользовательские рабочие процессы, которые вы хотели создать для ваших клиентов, когда они делают назначение с вашим бизнесом, например, Booking a Zoom собрание вместе с встречей, интеграция метода оплаты с помощью Шрипе, отправка данных клиентов в систему CRM, отправка приветственных писем? Соединитель booking — это решение для этих вопросов. С помощью этого соединителя мы открываем все действия по резервированиям встреч, например создание, обновление и удаление bookings.

Предпосылки

Клиенты, пытающиеся использовать соединитель Bookings, должны иметь лицензию Bookings Business для использования этого соединителя. Microsoft Bookings будет доступен с этими лицензиями.

Получение учетных данных

Microsoft Bookings использует проверку подлинности Идентификатора Microsoft Entra. Наличие допустимой учетной записи O365 обеспечит проверку подлинности для использования соединителя Bookings. Вы должны быть вошедшего пользователя, чтобы создать потоки на основе встреч.

Начало работы с соединителем

Для создания настраиваемого потока с помощью приложений Bookings в качестве триггеров необходимо знать SMTP-адрес booking busineess. Потоки можно создавать с помощью встреч резервирования, которые создаются, обновляются или отменяются в качестве триггеров. Ниже приведены некоторые распространенные потоки, которые можно создать:

Интеграция с Stripe

Полоса позволяет частным лицам и предприятиям принимать платежи через Интернет. Вы можете отслеживать клиентов, заказы, счета и многое другое; Дополнительные сведения о Полосе | Microsoft Power Automate

Интеграция с Zoom

Этот соединитель поможет автоматизировать операции масштабирования собраний; Дополнительные сведения о собраниях масштабирования (независимый издатель) | Microsoft Power Automate

Интеграция с Dynamic 365

Dynamics 365 Sales Insights помогает увеличить объем продаж с помощью аналитических сведений, управляемых искусственным интеллектом, которые способствуют персонализированной вовлеченности и упреждающим принятию решений для создания связей. ; Дополнительные сведения о Dynamics 365 Sales Insights | Microsoft Power Automate

Ниже приведен список соединителей: список поддерживаемых соединителей | Microsoft Power Automate

Известные проблемы и ограничения

  1. Только администраторы Bookings могут создавать потоки с помощью триггеров встречи. Описание. Сейчас только администраторы Bookings (отличные от администраторов клиента) могут создавать триггеры встречи. Если вы являетесь пользователем, который не является администратором (участник группы, планировщик, средство просмотра, гость), необходимо попросить администратора создать поток. Кроме того, вы можете запросить доступ администратора.

  2. Для каждого почтового ящика Bookings можно создать только 5 потоков. Описание. Для почтового ящика резервирования можно создать только 5 потоков. Это ограничение уровня почтовых ящиков Bookings, а не ограничение для каждого администратора. Если вы ищете несколько действий для триггера встречи, вы можете добавить это в одном из существующих потоков с помощью кнопки "Добавить действие". Вы можете обратиться в службу поддержки других администраторов Booking.

  3. Ошибки с фразой "Персонал не входит в состав Bookings Business", "Недопустимый орган" при создании потока. Описание. Убедитесь, что вы являетесь частью указанного почтового ящика Bookings, и вы являетесь администратором для того же. Вы можете перейти на вкладку "Сотрудники" и проверить то же самое.

  4. Некоторые параметры Bookings - Отмена причины для 1:1 Bookings не заполнены. Описание: указанные парамтеры не появляются сейчас, и мы работаем над решением этого в ближайшее время.

  5. Ошибка плохого шлюза. Если возникают проблемы в серверном API для создания потоков. 502 Ошибки неправильного шлюза отображаются. Сообщите об этом же в службу поддержки Microsoft 365.

Распространенные ошибки и средства устранения неполадок

Коды ошибок HTTP при создании потоков:

  1. '401': проверьте наличие проблем, связанных с проверкой подлинности в подключении.
  2. '403': только администраторы Bookings могут создавать потоки встреч. Проверьте (1) в разделе "Известные проблемы и ограничения".
  3. '403': домен URL-адреса уведомления не является частью разрешенного списка.
  4. '429': более ожидаемое количество потоков встреч, созданных для бизнеса. Проверьте (2) в разделе "Известные проблемы и ограничения".
  5. '502': это внутренняя ошибка сервера. Сообщите об этом инженеру службы поддержки со всеми сведениями об ошибке в ответе на создание потока.

Часто задаваемые вопросы

  1. Что делать, если календарь booking не является частью раскрывающегося списка триггеров? Ответ. Этот раскрывающийся список основан на недавно доступных календарях резервирования, для которых пользователь является администратором. Вы можете посетить его один раз на веб-странице Bookings, и это должно гарантировать, что календарь bookings появится. Возможно, у вас также нет доступа администратора, если вы не видите отдельный почтовый ящик.

  2. Если (1) не работает, как создать поток для календаря, на который я являюсь администратором? Ответ. Можно ввести настраиваемое значение. Значением здесь будет SMTP-адрес бизнеса/ Вы можете отправиться на страницу Bookings. Найдите вкладку "Интеграция" и выберите параметр Power Automate. Вы можете скопировать SMTP-адрес, отображаемый здесь, и вставить его в текстовое поле потока.

  3. Как получить данные клиента из ответов триггера встречи? Ответ. Если это резервирование 1:1, то можно использовать поля верхнего уровня, такие как CustomerName, CustomerEmail и т. д. Если это групповые резервирования, массив клиентов можно использовать для получения полей, таких как displayName (электронная почта клиентов, отображаемое имя клиентов и т. д.), можно использовать с параметром power automate "Foreach".

  4. Почему StaffMembers является массивом? Ответ. Вы сможете назначить нескольких сотрудников в качестве узла. Если у вашей службы есть только один персонал в качестве узла, то сведения о персонале будут представлены в массиве участников персонала.

  5. Существует ли общий идентификатор, который можно использовать в триггерах для одной встречи? Ответ. Да, можно использовать selfServiceAppointmentId. Это поле будет заполнено для всех типов встреч— будь то онлайн или In-Person или персонал, забронировать или клиент. Поле "Id" является идентификатором обмена и не является уникальным для триггеров.

  6. Есть ли способ получить изменения в уведомлении триггера встречи обновления? Ответ: Нет, это невозможно сегодня.

  7. Как работают уведомления о встречах с несколькими участниками? Ответ. В случае встреч с несколькими участниками добавление новых клиентов (после первого) активируется в качестве встречи обновления, а не как создание встречи. Это связано с тем, что добавление нового клиента в созданное резервирование по сути означает добавление участника в существующую сущность встречи резервирования. Первый клиент, добавленный в слот, всегда активирует триггер создания встречи, так как это точка при создании сущности встречи.

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

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Список предприятий Booking, где пользователь является администратором

Операция, используемая для перечисления всех почтовых ящиков, для которых пользователь, обращающийся к ней, является администратором.

Список предприятий Booking, где пользователь является администратором

Операция, используемая для перечисления всех почтовых ящиков, для которых пользователь, обращающийся к ней, является администратором.

Возвращаемое значение

Триггеры

При обновлении встречи

Этот триггер используется для прослушивания обновления встреч резервирования. Выберите страницу резервирования или введите SMTP-адрес страницы резервирования, которую вы с нетерпением ожидаете, чтобы слушать события обновления встречи.

При отмене встречи

Этот триггер используется для прослушивания отмены встреч резервирования. Выберите страницу резервирования или введите SMTP-адрес страницы бронирования, которую вы с нетерпением ожидаете, чтобы слушать события отмены встречи.

При создании встречи

Этот триггер используется для прослушивания создания встреч резервирования. Выберите страницу резервирования или введите SMTP-адрес страницы резервирования, которую вы с нетерпением ожидаете, чтобы слушать события создания встреч

При обновлении встречи

Этот триггер используется для прослушивания обновления встреч резервирования. Выберите страницу резервирования или введите SMTP-адрес страницы резервирования, которую вы с нетерпением ожидаете, чтобы слушать события обновления встречи.

Параметры

Имя Ключ Обязательно Тип Описание
Страница резервирования.
SMTPAddress True string

Выбор страницы резервирования

change_type
change_type True array of string

Изменения для прослушивания

Возвращаемое значение

Тело
AppointmentData

При отмене встречи

Этот триггер используется для прослушивания отмены встреч резервирования. Выберите страницу резервирования или введите SMTP-адрес страницы бронирования, которую вы с нетерпением ожидаете, чтобы слушать события отмены встречи.

Параметры

Имя Ключ Обязательно Тип Описание
Страница резервирования.
SMTPAddress True string

Выбор страницы резервирования

change_type
change_type True array of string

Изменения для прослушивания

Возвращаемое значение

Тело
AppointmentData

При создании встречи

Этот триггер используется для прослушивания создания встреч резервирования. Выберите страницу резервирования или введите SMTP-адрес страницы резервирования, которую вы с нетерпением ожидаете, чтобы слушать события создания встреч

Параметры

Имя Ключ Обязательно Тип Описание
Страница резервирования.
SMTPAddress True string

Выбор страницы резервирования

change_type
change_type True array of string

Изменения для прослушивания

Возвращаемое значение

Тело
AppointmentData

Определения

ListMailboxResponse

Имя Путь Тип Описание
Почтовых ящиков
mailboxes array of MailboxEntity

Все сущности почтового ящика.

MailboxEntity

Имя Путь Тип Описание
Показать имя
displayName string

Отображаемое имя почтового ящика.

SMTP почтового ящика
email string

SMTP почтового ящика Booking.

AppointmentData

Имя Путь Тип Описание
Дополнительные сведения
AdditionalInfo string

Дополнительные сведения о резервировании.

Электронная почта клиента
CustomerEmail string

Адрес электронной почты клиента в случае резервирования 1:1.

Идентификатор клиента
CustomerId string

Идентификатор клиента в случае резервирования 1:1.

Отображаемое имя расположения
CustomerLocation.DisplayName string

Отображаемое имя расположения клиента. Расположение, заполненное на странице C2 для резервирования 1:1.

Город
CustomerLocation.PhysicalAddress.City string

Город клиент принадлежит к 1:1 резервирования.

CountryOrRegion
CustomerLocation.PhysicalAddress.CountryOrRegion string

Страна или регион клиента для бронирования 1:1.

Почтовый индекс
CustomerLocation.PhysicalAddress.PostalCode string

Почтовый индекс клиента для бронирования 1:1.

Государство
CustomerLocation.PhysicalAddress.State string

Состояние, к которому принадлежит клиент в резервировании 1:1.

Улица
CustomerLocation.PhysicalAddress.Street string

Улица, к которой принадлежит клиент в резервировании 1:1.

ИмяКлиента
CustomerName string

Имя клиента для бронирования 1:1.

CustomerNotes
CustomerNotes string

Заметки клиента для резервирования 1:1.

CustomQuestionAnswers
CustomQuestionAnswers array of CustomQuestion

Все настраиваемые вопросы и ответы на 1:1 резервирования.

CustomerPhone
CustomerPhone string

Телефон клиента для бронирования 1:1.

CustomerTimeZone
CustomerTimeZone string

Часовой пояс клиента для бронирования 1:1.

Customers
Customers array of CustomerData

Список клиентов в резервировании 1:N

Продолжительность
Duration integer

Длительность встречи

EndTime
EndTime string

Время окончания встречи.

FilledAttendeesCount
FilledAttendeesCount integer

Количество участников, которые зарезервировали этот слот приложения.

Идентификатор
Id string

[Не рекомендуется] — используйте selfServiceAppointmentId в качестве уникального идентификатора для встречи с резервированиями.

IsSMSNotificationsEnabled
IsSMSNotificationsEnabled boolean

Поле для проверки включения SMS-уведомления для встречи.

JoinWebURL
JoinWebURL string

URL-адрес для присоединения к этой онлайн-встрече.

MaxAttendeesCount
MaxAttendeesCount integer

Максимальное число участников, разрешенных в этом приложении.

SelfServiceAppointmentId
SelfServiceAppointmentId string

Идентификатор встречи для встречи.

ServiceId
ServiceId string

Уникальный идентификатор службы.

Название сервиса
ServiceName string

Имя службы резервирования.

ServiceNotes
ServiceNotes string

Заметки об уровне обслуживания для сотрудников и администраторов.

StaffMembers
StaffMembers array of StaffMemberData

Список сотрудников

Время начала
StartTime string

Время начала встречи.

Отслеживание данных
TrackingData string

Данные отслеживания кампании.

Причина отмены
CancelReason string

Причина отмены этой встречи резервирования

CustomerData

Имя Путь Тип Описание
Адрес электронной почты
Email string

Электронная почта клиента в групповом резервировании.

Идентификатор
Id string

Уникальный идентификатор клиента в резервировании группы.

Отображаемое имя расположения
Location.DisplayName string

Отображаемое имя расположения клиента. Расположение, заполненное на странице C2 для группового бронирования.

Город
Location.PhysicalAddress.City string

Город, к которому принадлежит клиент для группового бронирования.

Страна или регион
Location.PhysicalAddress.CountryOrRegion string

Страна или регион клиента для группового бронирования.

Почтовый индекс
Location.PhysicalAddress.PostalCode string

Почтовый индекс клиента для группового бронирования.

Государство
Location.PhysicalAddress.State string

Состояние, к которому принадлежит клиент в группе резервирования.

Улица
Location.PhysicalAddress.Street string

Улица, к которой принадлежит клиент в группе резервирования.

Отображаемое имя
Name string

Отображаемое имя клиента в групповом резервировании.

Примечания.
Notes string

Примечания клиента в групповом резервировании.

Timezone
TimeZone string

Часовой пояс клиента в групповом резервировании.

Ответы
Answers array of CustomQuestion

Все настраиваемые вопросы и ответы.

StaffMemberData

Имя Путь Тип Описание
Отображаемое имя
DisplayName string

Отображаемое имя сотрудника, назначенного для этой встречи.

Электронный адрес
EmailAddress string

Адрес электронной почты сотрудников, назначенных этой встрече.

Идентификатор
Id string

Уникальный идентификатор персонала.

CustomQuestion

Имя Путь Тип Описание
Ответ
Answer string

Ответ на этот настраиваемый вопрос.

AnswerOptions
AnswerOptions array of string

Все параметры ответа.

IsRequired
IsRequired boolean

Указывает, является ли ответ на этот вопрос обязательным.

Question
Question string

Ответ на вопрос.

Вопросим
QuestionID string

Уникальный идентификатор ответа на вопрос.

SelectedOptions
SelectedOptions array of integer

Все выбранные параметры ответа.