Microsoft Bookings (versão prévia)
O Microsoft Bookings é uma ferramenta de agendamento e faz parte da família de produtos do Microsoft Office. Ele permite que usuários e organizações criem páginas de reserva e ajudam seus clientes a reservar compromissos facilmente.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Standard | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte do Microsoft 365 |
| URL | https://support.microsoft.com/en-us/contactus# |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft Corporation |
| Website | https://book.ms |
| Política de privacidade | https://docs.microsoft.com/en-us/microsoft-365/bookings/bookings-faq?view=o365-worldwide#privacy |
| Categorias | Gestão de empresas; Colaboração |
O conector do Microsoft Bookings foi criado com a finalidade de estender compromissos do Booking com outras funcionalidades que a plataforma power tem a oferecer. Você já procurou fluxos de trabalho personalizados que deseja criar para seus clientes quando eles fizerem uma nomeação com sua empresa, como reservar uma reunião do Zoom junto com um compromisso, integrando uma forma de pagamento usando o Sripe, carregando dados do cliente em um sistema CRM, enviando emails de boas-vindas? O conector de reserva é uma solução para essas solicitações. Com esse conector, estamos expondo todas as ações de reserva de compromissos, como Criar/Atualizar/Excluir reservas.
Pré-requisitos
Os clientes que tentam usar o Bookings Connector devem ter uma Licença comercial do Bookings para usar esse conector. O Microsoft Bookings estará disponível com essas licenças.
Como obter credenciais
O Microsoft Bookings usa a autenticação da ID do Microsoft Entra. Ter uma conta O365 válida garantirá que você esteja autenticado para usar o conector do Bookings. Você deve ser um usuário conectado para criar fluxos baseados em compromisso.
Introdução ao conector
Para criar um fluxo personalizado com os apppointments do Bookings como gatilhos, você precisará saber o endereço SMTP do Busineess booking. Você pode criar fluxos com o compromisso de reservas sendo criado/atualizado/cancelado como gatilhos. Aqui estão alguns dos fluxos comuns que você pode criar:
Integração com o Stripe
O Stripe permite que pessoas privadas e empresas aceitem pagamentos pela Internet. Você pode acompanhar clientes, pedidos, faturas e muito mais; Para obter mais informações , Stripe | Microsoft Power Automate
Integração com o Zoom
Esse Conector ajudará a automatizar operações de reunião do Zoom; Para obter mais informações , Zoom Meetings (Independent Publisher) | Microsoft Power Automate
Integração com o Dynamic 365
O Dynamics 365 Sales Insights ajuda a aumentar suas vendas com a ajuda de insights orientados por IA que promovem o engajamento personalizado e a tomada de decisões proativas para ajudar a criar relações. ; Para obter mais informações , Dynamics 365 Sales Insights | Microsoft Power Automate
Aqui está toda a lista de conectores: Lista de conectores com suporte | Microsoft Power Automate
Problemas e limitações conhecidos
Somente os administradores do Bookings podem criar fluxos usando gatilhos de compromisso. Descrição: no momento, somente os administradores do Bookings (diferentes dos administradores de locatário) podem criar gatilhos de compromisso. Se você for um usuário que não seja um administrador (Membro da Equipe, Agendador, Visualizador, Convidado), peça ao administrador para criar um fluxo. Como alternativa, você também pode solicitar acesso de administrador.
Somente 5 fluxos podem ser criados por Caixa de Correio do Bookings. Descrição: para uma Caixa de Correio de Reserva, somente 5 fluxos podem ser criados. Esse é um limite de nível de Caixa de Correio do Bookings e não um limite por administrador. Se você estiver procurando mais de uma ação para um gatilho de compromisso, poderá adicioná-la em um dos fluxos existentes usando o botão Adicionar Ação. Você pode entrar em contato com outros administradores do Booking para obter suporte.
Erros ao dizer "Equipe não faz parte do Bookings Business", "Autoridade inválida" ao criar um fluxo. Descrição: Verifique se você faz parte da caixa de correio do Bookings e se você é um administrador para o mesmo. Você pode acessar a guia da equipe e verificar o mesmo.
Alguns dos parâmetros bookings – Cancel Reason for 1:1 Bookings não são preenchidos. Descrição: os parâmetros ditos não aparecem agora e estamos trabalhando para corrigir isso em breve.
Erro de gateway incorreto – se houver problemas na API de back-end para criar fluxos. 502 Erros de gateway incorretos são vistos. Relate o mesmo ao suporte do Microsoft 365.
Erros e soluções comuns
Códigos de erro HTTP ao criar fluxos:
- '401': Verifique se há problemas relacionados à autenticação em sua conexão.
- '403': somente administradores de reservas podem criar fluxos de compromisso. Verifique (1) na seção Problemas conhecidos e limitações.
- '403': O domínio da URL de notificação não faz parte da lista de permitidos.
- '429': número mais do que o esperado de fluxos de compromissos criados para uma empresa. Verifique (2) na seção Problemas conhecidos e limitações.
- '502': esse é um erro interno do servidor. Relate isso ao engenheiro de suporte com todos os detalhes de erro na resposta de criação de fluxo.
perguntas frequentes
O que fazer se meu calendário do Booking não fizer parte da lista suspensa nos gatilhos? Resposta: essa lista suspensa se baseia em calendários de reservas acessados recentemente para os quais o usuário é administrador. Você pode visitá-lo uma vez na página da Web do Bookings e isso deve garantir que o Calendário de Reservas seja exibido. Você também pode não ter acesso de administrador se não estiver vendo uma caixa de correio específica sozinha.
Se (1) não funcionar, como criar um fluxo para um calendário do qual sou administrador? Resposta: você pode inserir um valor personalizado. O valor aqui será o endereço SMTP da Empresa/ Você pode ir para sua página do Bookings. Procure a guia Integrações e selecione a opção Power Automate. Você pode copiar o endereço SMTP exibido aqui e cole-o na caixa de texto do fluxo.
Como obter dados do cliente das respostas do gatilho de compromisso? Resposta: se essa for uma reserva 1:1, os campos de nível superior, como CustomerName, CustomerEmail etc. podem ser usados. Se for uma reserva de grupo, a matriz de clientes poderá ser usada para obter campos como displayName (email de clientes, displayName etc) pode ser usado com uma opção "Foreach" do power automate.
Por que os StaffMembers são uma matriz? Resposta: Você poderá atribuir mais de um membro da equipe como host. Se o serviço tiver apenas uma equipe como host, os detalhes da equipe serão vistos na matriz de membros da equipe.
Há uma ID comum que pode ser usada entre gatilhos para um mesmo compromisso? Resposta: Sim, você pode usar o selfServiceAppointmentId. Esse campo será preenchido para todos os tipos de compromissos , seja online ou In-Person ou Pessoal Reservado ou Cliente Reservado. O campo "ID" é uma ID de troca e não é exclusivo entre gatilhos.
Há uma maneira de obter o que foi alterado na notificação do gatilho de compromisso de atualização? Resposta: Não, isso não é possível hoje.
Como funcionam as notificações para vários participantes? Resposta: no caso de compromissos com vários participantes, a adição de novos clientes (após o primeiro) é disparada como um compromisso de atualização e não como um compromisso de criação. Isso se deve ao fato de que adicionar um novo cliente a uma reserva criada significa essencialmente adicionar um participante a uma entidade de compromisso de reservas existente. O primeiro cliente que foi adicionado ao slot sempre dispara o gatilho de criação de compromisso, pois esse é o ponto em que a entidade de compromisso de reserva é criada.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Listar Empresas de Reserva em que o usuário é administrador |
Operação usada para listar todas as caixas de correio para as quais o usuário que acessa é um Administrador. |
Listar Empresas de Reserva em que o usuário é administrador
Operação usada para listar todas as caixas de correio para as quais o usuário que acessa é um Administrador.
Retornos
- Corpo
- ListMailboxResponse
Gatilhos
| Quando um compromisso é atualizado |
Esse gatilho é usado para ouvir a atualização de compromissos de reservas. Selecione uma página de reserva ou insira o endereço SMTP da página de reserva que você está ansioso para ouvir os eventos de compromisso de atualização. |
| Quando um compromisso é cancelado |
Esse gatilho é usado para escutar o cancelamento de compromissos de reservas. Selecione uma página de reserva ou insira o endereço SMTP da página de reserva que você está ansioso para ouvir para cancelar eventos de compromisso. |
| Quando um compromisso é criado |
Esse gatilho é usado para ouvir a criação de compromissos de reservas. Selecione uma página de reserva ou insira o endereço SMTP da página de reserva que você está ansioso para ouvir para criar eventos de compromisso |
Quando um compromisso é atualizado
Esse gatilho é usado para ouvir a atualização de compromissos de reservas. Selecione uma página de reserva ou insira o endereço SMTP da página de reserva que você está ansioso para ouvir os eventos de compromisso de atualização.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Página de reserva.
|
SMTPAddress | True | string |
Selecionar uma página de reserva |
|
change_type
|
change_type | True | array of string |
Alterações para escutar |
Retornos
- Corpo
- AppointmentData
Quando um compromisso é cancelado
Esse gatilho é usado para escutar o cancelamento de compromissos de reservas. Selecione uma página de reserva ou insira o endereço SMTP da página de reserva que você está ansioso para ouvir para cancelar eventos de compromisso.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Página de reserva.
|
SMTPAddress | True | string |
Selecionar uma página de reserva |
|
change_type
|
change_type | True | array of string |
Alterações para escutar |
Retornos
- Corpo
- AppointmentData
Quando um compromisso é criado
Esse gatilho é usado para ouvir a criação de compromissos de reservas. Selecione uma página de reserva ou insira o endereço SMTP da página de reserva que você está ansioso para ouvir para criar eventos de compromisso
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Página de reserva.
|
SMTPAddress | True | string |
Selecionar uma página de reserva |
|
change_type
|
change_type | True | array of string |
Alterações para escutar |
Retornos
- Corpo
- AppointmentData
Definições
ListMailboxResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Caixas
|
mailboxes | array of MailboxEntity |
Todas as entidades de caixa de correio. |
Entidade de Caixa de Correio
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome de exibição
|
displayName | string |
Nome de exibição da caixa de correio. |
|
SMTP da caixa de correio
|
string |
SMTP da caixa de correio booking. |
AppointmentData
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Informações adicionais
|
AdditionalInfo | string |
Informações adicionais sobre a reserva. |
|
Email do cliente
|
CustomerEmail | string |
Endereço de email do cliente no caso de reservas 1:1. |
|
Id do Cliente
|
CustomerId | string |
ID do cliente no caso de reservas 1:1. |
|
Nome de Exibição do Local
|
CustomerLocation.DisplayName | string |
Nome de exibição do local do cliente. Local preenchido da página C2 para reserva 1:1. |
|
City
|
CustomerLocation.PhysicalAddress.City | string |
Cidade à qual o cliente pertence para reserva 1:1. |
|
PaísOuRegião
|
CustomerLocation.PhysicalAddress.CountryOrRegion | string |
País ou região do cliente para reserva 1:1. |
|
Código Postal
|
CustomerLocation.PhysicalAddress.PostalCode | string |
Cep do cliente para reserva 1:1. |
|
Estado
|
CustomerLocation.PhysicalAddress.State | string |
Estado ao qual o cliente pertence na reserva 1:1. |
|
Rua
|
CustomerLocation.PhysicalAddress.Street | string |
Rua à qual o cliente pertence na reserva 1:1. |
|
Nome do Cliente
|
CustomerName | string |
Nome do Cliente para reserva 1:1. |
|
CustomerNotes
|
CustomerNotes | string |
Notas do cliente para reserva 1:1. |
|
CustomQuestionAnswers
|
CustomQuestionAnswers | array of CustomQuestion |
Todas as perguntas e respostas personalizadas para reserva 1:1. |
|
CustomerPhone
|
CustomerPhone | string |
Telefone do cliente para reserva 1:1. |
|
CustomerTimeZone
|
CustomerTimeZone | string |
Fuso horário do cliente para reserva 1:1. |
|
Clientes
|
Customers | array of CustomerData |
Lista de clientes na reserva 1:N |
|
Duração
|
Duration | integer |
Duração do compromisso |
|
EndTime
|
EndTime | string |
Hora de término do compromisso. |
|
FilledAttendeesCount
|
FilledAttendeesCount | integer |
Número de participantes que reservaram esse slot de appoinment. |
|
ID
|
Id | string |
[Preterido] – use selfServiceAppointmentId como identifer exclusivo para o compromisso de reservas. |
|
IsSMSNotificationsEnabled
|
IsSMSNotificationsEnabled | boolean |
Campo para verificar se a notificação por SMS está habilitada para o compromisso. |
|
JoinWebURL
|
JoinWebURL | string |
URL para ingressar neste compromisso online. |
|
MaxAttendeesCount
|
MaxAttendeesCount | integer |
Número máximo de participantes permitido neste appoinment. |
|
SelfServiceAppointmentId
|
SelfServiceAppointmentId | string |
ID do compromisso para o compromisso de reserva. |
|
ServiceId
|
ServiceId | string |
Identificador de Serviço Exclusivo. |
|
NomeDoServiço
|
ServiceName | string |
Nome do serviço de reservas. |
|
ServiceNotes
|
ServiceNotes | string |
Notas de nível de serviço para a equipe e o administrador. |
|
StaffMembers
|
StaffMembers | array of StaffMemberData |
Lista de membros da equipe |
|
Hora de Início
|
StartTime | string |
Hora de início do compromisso. |
|
Acompanhamento de dados
|
TrackingData | string |
Dados de acompanhamento de campanha. |
|
Cancelar Motivo
|
CancelReason | string |
Motivo do cancelamento deste compromisso de reserva |
CustomerData
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Email
|
string |
Email do cliente na reserva de grupo. |
|
|
ID
|
Id | string |
ID exclusiva do cliente na reserva de grupo. |
|
Nome de Exibição do Local
|
Location.DisplayName | string |
Nome de exibição do local do cliente. Local preenchido da página C2 para reserva de grupo. |
|
City
|
Location.PhysicalAddress.City | string |
Cidade à qual o cliente pertence para a reserva de grupo. |
|
País ou região
|
Location.PhysicalAddress.CountryOrRegion | string |
País ou região do cliente para reserva de grupo. |
|
Código postal
|
Location.PhysicalAddress.PostalCode | string |
Cep do cliente para reserva em grupo. |
|
Estado
|
Location.PhysicalAddress.State | string |
Estado ao qual o cliente pertence na reserva de grupo. |
|
Rua
|
Location.PhysicalAddress.Street | string |
Rua à qual o cliente pertence na reserva do grupo. |
|
Nome de Exibição
|
Name | string |
Nome de exibição do cliente na reserva de grupo. |
|
Anotações
|
Notes | string |
Anotações do cliente na reserva de grupo. |
|
Timezone
|
TimeZone | string |
Fuso horário do cliente na reserva de grupo. |
|
Respostas
|
Answers | array of CustomQuestion |
Todas as perguntas e respostas personalizadas. |
StaffMemberData
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
DisplayName
|
DisplayName | string |
Nome de exibição da equipe atribuída para este compromisso. |
|
Endereço de Email
|
EmailAddress | string |
Endereço de email da equipe atribuída a esse compromisso. |
|
ID
|
Id | string |
Identificador exclusivo do Staff. |
CustomQuestion
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Resposta
|
Answer | string |
Responda a essa pergunta personalizada. |
|
AnswerOptions
|
AnswerOptions | array of string |
Todas as opções de resposta. |
|
IsRequired
|
IsRequired | boolean |
Informa se responder a essa pergunta é obrigatório. |
|
Pergunta
|
Question | string |
Pergunta a ser respondida. |
|
QuestionID
|
QuestionID | string |
Identificador exclusivo da pergunta a ser respondida. |
|
SelectedOptions
|
SelectedOptions | array of integer |
Todas as opções de resposta selecionadas. |