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
Известные проблемы и ограничения
Только администраторы Bookings могут создавать потоки с помощью триггеров встречи. Описание. Сейчас только администраторы Bookings (отличные от администраторов клиента) могут создавать триггеры встречи. Если вы являетесь пользователем, который не является администратором (участник группы, планировщик, средство просмотра, гость), необходимо попросить администратора создать поток. Кроме того, вы можете запросить доступ администратора.
Для каждого почтового ящика Bookings можно создать только 5 потоков. Описание. Для почтового ящика резервирования можно создать только 5 потоков. Это ограничение уровня почтовых ящиков Bookings, а не ограничение для каждого администратора. Если вы ищете несколько действий для триггера встречи, вы можете добавить это в одном из существующих потоков с помощью кнопки "Добавить действие". Вы можете обратиться в службу поддержки других администраторов Booking.
Ошибки с фразой "Персонал не входит в состав Bookings Business", "Недопустимый орган" при создании потока. Описание. Убедитесь, что вы являетесь частью указанного почтового ящика Bookings, и вы являетесь администратором для того же. Вы можете перейти на вкладку "Сотрудники" и проверить то же самое.
Некоторые параметры Bookings - Отмена причины для 1:1 Bookings не заполнены. Описание: указанные парамтеры не появляются сейчас, и мы работаем над решением этого в ближайшее время.
Ошибка плохого шлюза. Если возникают проблемы в серверном API для создания потоков. 502 Ошибки неправильного шлюза отображаются. Сообщите об этом же в службу поддержки Microsoft 365.
Распространенные ошибки и средства устранения неполадок
Коды ошибок HTTP при создании потоков:
- '401': проверьте наличие проблем, связанных с проверкой подлинности в подключении.
- '403': только администраторы Bookings могут создавать потоки встреч. Проверьте (1) в разделе "Известные проблемы и ограничения".
- '403': домен URL-адреса уведомления не является частью разрешенного списка.
- '429': более ожидаемое количество потоков встреч, созданных для бизнеса. Проверьте (2) в разделе "Известные проблемы и ограничения".
- '502': это внутренняя ошибка сервера. Сообщите об этом инженеру службы поддержки со всеми сведениями об ошибке в ответе на создание потока.
Часто задаваемые вопросы
Что делать, если календарь booking не является частью раскрывающегося списка триггеров? Ответ. Этот раскрывающийся список основан на недавно доступных календарях резервирования, для которых пользователь является администратором. Вы можете посетить его один раз на веб-странице Bookings, и это должно гарантировать, что календарь bookings появится. Возможно, у вас также нет доступа администратора, если вы не видите отдельный почтовый ящик.
Если (1) не работает, как создать поток для календаря, на который я являюсь администратором? Ответ. Можно ввести настраиваемое значение. Значением здесь будет SMTP-адрес бизнеса/ Вы можете отправиться на страницу Bookings. Найдите вкладку "Интеграция" и выберите параметр Power Automate. Вы можете скопировать SMTP-адрес, отображаемый здесь, и вставить его в текстовое поле потока.
Как получить данные клиента из ответов триггера встречи? Ответ. Если это резервирование 1:1, то можно использовать поля верхнего уровня, такие как CustomerName, CustomerEmail и т. д. Если это групповые резервирования, массив клиентов можно использовать для получения полей, таких как displayName (электронная почта клиентов, отображаемое имя клиентов и т. д.), можно использовать с параметром power automate "Foreach".
Почему StaffMembers является массивом? Ответ. Вы сможете назначить нескольких сотрудников в качестве узла. Если у вашей службы есть только один персонал в качестве узла, то сведения о персонале будут представлены в массиве участников персонала.
Существует ли общий идентификатор, который можно использовать в триггерах для одной встречи? Ответ. Да, можно использовать selfServiceAppointmentId. Это поле будет заполнено для всех типов встреч— будь то онлайн или In-Person или персонал, забронировать или клиент. Поле "Id" является идентификатором обмена и не является уникальным для триггеров.
Есть ли способ получить изменения в уведомлении триггера встречи обновления? Ответ: Нет, это невозможно сегодня.
Как работают уведомления о встречах с несколькими участниками? Ответ. В случае встреч с несколькими участниками добавление новых клиентов (после первого) активируется в качестве встречи обновления, а не как создание встречи. Это связано с тем, что добавление нового клиента в созданное резервирование по сути означает добавление участника в существующую сущность встречи резервирования. Первый клиент, добавленный в слот, всегда активирует триггер создания встречи, так как это точка при создании сущности встречи.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Список предприятий Booking, где пользователь является администратором |
Операция, используемая для перечисления всех почтовых ящиков, для которых пользователь, обращающийся к ней, является администратором. |
Список предприятий Booking, где пользователь является администратором
Операция, используемая для перечисления всех почтовых ящиков, для которых пользователь, обращающийся к ней, является администратором.
Возвращаемое значение
- Тело
- ListMailboxResponse
Триггеры
| При обновлении встречи |
Этот триггер используется для прослушивания обновления встреч резервирования. Выберите страницу резервирования или введите 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 почтового ящика
|
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
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Адрес электронной почты
|
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 |
Все выбранные параметры ответа. |