Compartilhar via


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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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:

  1. '401': Verifique se há problemas relacionados à autenticação em sua conexão.
  2. '403': somente administradores de reservas podem criar fluxos de compromisso. Verifique (1) na seção Problemas conhecidos e limitações.
  3. '403': O domínio da URL de notificação não faz parte da lista de permitidos.
  4. '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.
  5. '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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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

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

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

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

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
email 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
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.