Reservas da Microsoft (Pré-visualização)
O Microsoft Bookings é uma ferramenta de agendamento e faz parte da família de produtos Microsoft Office. Ele permite que usuários e organizações criem páginas de reserva e ajuda seus clientes a reservar compromissos facilmente.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Standard | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Standard | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Standard | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - 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 | |
|---|---|
| Editora | Corporação Microsoft |
| Sítio Web | 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 Empresarial; Colaboração |
O conector Microsoft Bookings foi criado com o objetivo de estender os compromissos de reserva com outras funcionalidades que a plataforma de energia tem a oferecer. Você já procurou fluxos de trabalho personalizados que você queria criar para seus clientes quando eles marcam uma nomeação com sua empresa, como, Reservar uma reunião do Zoom junto com um compromisso, Integrar um método de pagamento usando o Sripe, Carregar dados do cliente para um sistema CRM, enviar e-mails de boas-vindas? Booking connector é uma solução para essas perguntas. Com este conector, estamos expondo todas as ações de marcação de compromissos - como Criar/Atualizar/Excluir de Reservas.
Pré-requisitos
Os clientes que tentam usar o Bookings Connector devem ter uma Licença Comercial de Bookings para usar esse conector. O Microsoft Bookings estará disponível com estas licenças.
Como obter credenciais
O Microsoft Bookings usa a autenticação de ID do Microsoft Entra. Ter uma conta O365 válida garantirá que você esteja autenticado para usar o conector de reservas. Você deve ser um usuário conectado para criar fluxos baseados em compromissos.
Introdução ao conector
Para criar um fluxo personalizado com os apppointments do Bookings como gatilhos, você precisará saber o endereço SMTP do Booking busineess. Você pode criar fluxos com reservas, compromissos sendo criados/atualizados/cancelados como gatilhos. Aqui estão alguns dos fluxos comuns que você pode criar:
Integração com Stripe
O Stripe permite que particulares e empresas aceitem pagamentos pela internet. Você pode rastrear clientes, pedidos, faturas e muito mais; Para mais informações Stripe | Microsoft Power Automate [en]
Integração com Zoom
Este conector ajudará a automatizar as operações de reunião do Zoom; Para mais informações Zoom Meetings (Editora Independente) | Microsoft Power Automate [en]
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 envolvimento personalizado e a tomada de decisões proativas para ajudar a construir relacionamentos. ; Para obter mais informações, Dynamics 365 Sales Insights | Microsoft Power Automate [en]
Aqui está toda a lista de conectores: Lista de conectores suportados | Microsoft Power Automate [en]
Problemas conhecidos e limitações
Somente os administradores de reservas podem criar fluxos usando gatilhos de compromisso. Descrição: No momento, apenas os administradores de reservas (diferentes dos administradores de locatário) podem criar gatilhos de compromisso. Se for um utilizador que não é administrador (Membro da Equipa, Programador, Visualizador, Convidado), deve pedir ao administrador para criar um fluxo. Como alternativa, você também pode solicitar acesso de administrador.
Apenas 5 fluxos podem ser criados por Caixa de Correio de Reservas. Descrição: Para uma caixa de correio de reservas, apenas 5 fluxos podem ser criados. Este é um limite de nível de Caixa de Correio de Reservas e não um limite por administrador. Se você estiver procurando por 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 de reservas para obter suporte.
Erros ao dizer "Funcionários que não fazem parte do Bookings Business", "Autoridade inválida" ao criar um fluxo. Descrição: Certifique-se de que faz parte da referida Caixa de Correio de Reservas e que é administrador da mesma. Você pode ir para a guia pessoal e verificar o mesmo.
Alguns dos parâmetros de reservas - Cancelar motivo para reservas 1:1 não estão preenchidos. Descrição: Os ditos paramters 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. Informe 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 na sua conexão.
- '403': Apenas os administradores de reservas podem criar fluxos de compromissos. Verifique (1) na seção Problemas conhecidos e limitações.
- '403': O domínio URL de notificação não faz parte da lista permitida.
- «429»: Número de fluxos de nomeação mais do que o esperado criados para uma empresa. Verifique (2) na seção Problemas conhecidos e limitações.
- '502': Este é um erro interno do servidor. Por favor, informe isso ao seu engenheiro de suporte com todos os detalhes do erro na resposta de criação de fluxo.
FAQ
O que devo fazer se o meu calendário de reservas não fizer parte da lista suspensa nos gatilhos? Resposta: Esta lista suspensa é baseada em calendários de reservas acessados recentemente para os quais o usuário é administrador. Pode visitá-lo uma vez a partir da página Web de Reservas e isto deve garantir que o Calendário de Reservas é apresentado. Você também pode não ter acesso de administrador se não estiver vendo apenas uma caixa de correio específica.
Se (1) não funcionar, Como faço para 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 a sua página de reservas. Procure a guia Integrações e selecione a opção Power Automatic. Você pode copiar o endereço SMTP exibido aqui e colá-lo na caixa de texto do fluxo.
Como obter os dados do cliente a partir das respostas do gatilho de compromisso? Resposta: Se esta é uma reserva 1:1, então os campos de nível superior como CustomerName, CustomerEmail etc podem ser usados. Se for uma reserva de grupo, a matriz de clientes pode ser usada para obter campos como displayName (e-mail de clientes, clientes displayName etc) pode ser usado com uma opção de automação de energia "Foreach".
Porque é que os StaffMembers são uma matriz? Resposta: Você poderá atribuir mais de um membro da equipe como anfitrião. Se o seu serviço tiver apenas uma equipe como anfitrião, os detalhes da equipe serão vistos na matriz de membros da equipe.
Existe um id comum que se pode usar entre gatilhos para um mesmo compromisso? Resposta: Sim, você pode usar o selfServiceAppointmentId. Este campo será preenchido para todos os tipos de consultas - seja Online ou In-Person ou Pessoal Reservado ou Cliente Reservado. O campo "Id" é um ID de troca e não é exclusivo entre gatilhos.
Existe uma maneira de obter o que mudou na notificação de gatilho de compromisso de atualização? Resposta: Não, isso não é possível hoje.
Como funcionam as notificações para compromissos com vários participantes? Resposta: No caso de compromissos com vários participantes, a adição de novos clientes (após o primeiro) é acionada 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 agendamento de reservas existente. O primeiro cliente que foi adicionado ao slot sempre aciona o gatilho de criação de compromisso, pois é o ponto em que a entidade de compromisso de reserva é criada.
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Listar empresas de reservas em que o usuário é administrador |
Operação usada para listar todas as caixas de correio para as quais o usuário de acesso é um administrador. |
Listar empresas de reservas em que o usuário é administrador
Operação usada para listar todas as caixas de correio para as quais o usuário de acesso é um administrador.
Devoluções
- Body
- ListMailboxResponse
Acionadores
| Quando um compromisso é atualizado |
Este gatilho é usado para ouvir a atualização de marcações. Selecione uma página de reserva ou digite 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 |
Este gatilho é usado para ouvir para cancelar compromissos de reservas. Selecione uma página de reserva ou digite o endereço SMTP da página de reserva que você está ansioso para ouvir cancelar eventos de compromisso. |
| Quando um compromisso é criado |
Este gatilho é usado para ouvir para criar marcações de compromissos. Selecione uma página de reserva ou digite o endereço SMTP da página de reserva que você está ansioso para ouvir criar eventos de compromisso |
Quando um compromisso é atualizado
Este gatilho é usado para ouvir a atualização de marcações. Selecione uma página de reserva ou digite o endereço SMTP da página de reserva que você está ansioso para ouvir os eventos de compromisso de atualização.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Página de reservas.
|
SMTPAddress | True | string |
Selecione uma página de reserva |
|
change_type
|
change_type | True | array of string |
Alterações para ouvir |
Devoluções
- Body
- AppointmentData
Quando um compromisso é cancelado
Este gatilho é usado para ouvir para cancelar compromissos de reservas. Selecione uma página de reserva ou digite o endereço SMTP da página de reserva que você está ansioso para ouvir cancelar eventos de compromisso.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Página de reservas.
|
SMTPAddress | True | string |
Selecione uma página de reserva |
|
change_type
|
change_type | True | array of string |
Alterações para ouvir |
Devoluções
- Body
- AppointmentData
Quando um compromisso é criado
Este gatilho é usado para ouvir para criar marcações de compromissos. Selecione uma página de reserva ou digite o endereço SMTP da página de reserva que você está ansioso para ouvir criar eventos de compromisso
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Página de reservas.
|
SMTPAddress | True | string |
Selecione uma página de reserva |
|
change_type
|
change_type | True | array of string |
Alterações para ouvir |
Devoluções
- Body
- AppointmentData
Definições
ListMailboxResponse
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
caixas de correio
|
mailboxes | array of MailboxEntity |
Todas as entidades de caixa de correio. |
MailboxEntity
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome de exibição
|
displayName | string |
Nome para exibição da caixa de correio. |
|
Caixa de correio SMTP
|
string |
SMTP da caixa de correio de Reserva. |
NomeaçãoDados
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Informação Adicional
|
AdditionalInfo | string |
Informações adicionais sobre a reserva. |
|
E-mail do cliente
|
CustomerEmail | string |
Endereço de e-mail do cliente em 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 da localização do cliente. Localização preenchida a partir da página C2 para 1:1 Reserva. |
|
City
|
CustomerLocation.PhysicalAddress.City | string |
Cidade a que o cliente pertence para reserva 1:1. |
|
País ou Região
|
CustomerLocation.PhysicalAddress.CountryOrRegion | string |
País ou região do cliente para reserva 1:1. |
|
Código Postal
|
CustomerLocation.PhysicalAddress.PostalCode | string |
Código postal do cliente para reserva 1:1. |
|
Estado
|
CustomerLocation.PhysicalAddress.State | string |
Estado onde o cliente pertence na reserva 1:1. |
|
Rua
|
CustomerLocation.PhysicalAddress.Street | string |
Rua onde o cliente pertence na reserva 1:1. |
|
Nome do Cliente
|
CustomerName | string |
Nome do cliente para reserva 1:1. |
|
Notas do cliente
|
CustomerNotes | string |
Notas do cliente para reserva 1:1. |
|
CustomQuestionAnswers
|
CustomQuestionAnswers | array of CustomQuestion |
Todas as perguntas e respostas personalizadas para reserva 1:1. |
|
Telefone do Cliente
|
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 da nomeação |
|
EndTime
|
EndTime | string |
Hora de fim do compromisso. |
|
FilledAttendeesCount
|
FilledAttendeesCount | integer |
Número de participantes que reservaram esta vaga de appoinment. |
|
Id
|
Id | string |
[Preterido] - use selfServiceAppointmentId como identificador 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 participar neste compromisso online. |
|
MaxAttendeesCount
|
MaxAttendeesCount | integer |
Número máximo de participantes permitido neste aplicativo. |
|
SelfServiceAppointmentId
|
SelfServiceAppointmentId | string |
ID da marcação da marcação. |
|
ServiceId
|
ServiceId | string |
Identificador Único de Serviço. |
|
NomeDoServiço
|
ServiceName | string |
Nome do serviço de reservas. |
|
Notas de Serviço
|
ServiceNotes | string |
Notas de nível de serviço para a equipe e administrador. |
|
Membros do pessoal
|
StaffMembers | array of StaffMemberData |
Lista dos membros do pessoal |
|
Hora de Início
|
StartTime | string |
Hora de início da consulta. |
|
Dados de rastreamento
|
TrackingData | string |
Dados de acompanhamento de campanhas. |
|
Cancelar Motivo
|
CancelReason | string |
Motivo do cancelamento desta marcação |
Dados do Cliente
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Email
|
string |
Email do cliente na reserva de grupo. |
|
|
Id
|
Id | string |
ID único do cliente na reserva de grupo. |
|
Nome de exibição do local
|
Location.DisplayName | string |
Nome de exibição da localização do cliente. Localização preenchida a partir da página C2 para reserva de grupo. |
|
City
|
Location.PhysicalAddress.City | string |
Cidade à qual o cliente pertence para 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 |
Código postal do cliente para reserva de grupo. |
|
Estado
|
Location.PhysicalAddress.State | string |
Estado a que o cliente pertence na reserva de grupo. |
|
Rua
|
Location.PhysicalAddress.Street | string |
Rua onde o cliente pertence na reserva de grupo. |
|
Nome de exibição
|
Name | string |
Nome de exibição do cliente na reserva de grupo. |
|
Observações
|
Notes | string |
Notas do cliente na reserva de grupo. |
|
Timezone
|
TimeZone | string |
Fuso horário do cliente na reserva de grupo. |
|
Answers
|
Answers | array of CustomQuestion |
Todas as perguntas e respostas personalizadas. |
StaffMemberData
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome de Exibição
|
DisplayName | string |
Exibir Nome da equipe designada para este compromisso. |
|
Endereço de Email
|
EmailAddress | string |
Endereço de e-mail do pessoal designado para esta nomeação. |
|
Id
|
Id | string |
Identificador único do pessoal. |
Pergunta personalizada
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Resposta
|
Answer | string |
Resposta a esta pergunta personalizada. |
|
Opções de resposta
|
AnswerOptions | array of string |
Todas as opções de resposta. |
|
IsRequired
|
IsRequired | boolean |
Diz se responder a esta pergunta é obrigatório. |
|
Question
|
Question | string |
Pergunta a ser respondida. |
|
QuestionID
|
QuestionID | string |
Identificador Único da Pergunta a Responder. |
|
Opções selecionadas
|
SelectedOptions | array of integer |
Todas as opções de resposta selecionadas. |