Implementar o conector monday.com Microsoft 365 Copilot

O conector de monday.com Microsoft 365 Copilot integra monday.com itens no ecossistema do Microsoft 365, permitindo que Microsoft 365 Copilot, a Copilot Search e a Microsoft Search obtenham dados de projetos e tarefas de monday.com em experiências do Microsoft 365.

Este artigo descreve como implementar e configurar o conector monday.com no Centro de administração do Microsoft 365.

Pré-requisitos

Antes de implementar o conector monday.com, certifique-se de que cumpre os seguintes pré-requisitos:

É um administrador de pesquisa do Microsoft 365 para a sua organização.
Tem acesso ao URL de instância monday.com da sua organização (por exemplo, https://contoso.monday.com).
Tem as permissões necessárias no monday.com para criar ou gerir aplicações OAuth.
Compreende os limites do plano monday.com, incluindo os limites diários de chamadas à API.

Implementar o conector

Para adicionar o conector monday.com para a sua organização:

Na Centro de administração do Microsoft 365, no painel esquerdo, selecioneConectorescopiadores>.
Aceda ao separador Conectores e, em seguida, selecione Galeria.
Na lista de conectores disponíveis, selecione monday.com.

Definir nome a apresentar

O nome a apresentar é utilizado para identificar referências em respostas copilot e resultados de pesquisa para ajudar os utilizadores a reconhecer a origem do conteúdo. O nome a apresentar também indica conteúdo fidedigno e é utilizado como um filtro de origem de conteúdo.

Pode aceitar o nome a apresentar predefinido de segunda-feira ou personalizá-lo para utilizar um nome que os utilizadores na sua organização reconheçam.

Definir URL da instância

Introduza o URL da instância do seu inquilino monday.com. Normalmente, o URL segue este formato:

https://<your-instance>.monday.com

Escolher tipo de autenticação

O conector monday.com suporta as seguintes opções de autenticação:

OAuth (recomendado).
OAuth 2.0 com uma aplicação monday.com personalizada.

OAuth (recomendado)

Com a autenticação OAuth, pode instalar e autorizar a aplicação Microsoft 365 Copilot segunda-feira na sua área de trabalho monday.com. Durante a autorização, inicie sessão no monday.com e conceda as permissões de leitura necessárias para a ingestão de conteúdos.

Esta opção requer uma configuração mínima e é recomendada para a maioria das organizações.

Instale a aplicação Microsoft 365 Copilot segunda-feira nas áreas de trabalho de segunda-feira através desta ligação.
Reveja as áreas de trabalho que pretende utilizar e o nível de acesso Microsoft 365 Copilot correspondente antes de escolher o botão instalar na janela de pop-up.
Selecione Autorizar para iniciar sessão e conceder acesso.

OAuth 2.0 com aplicação personalizada

Com o OAuth 2.0, cria e configura a sua própria aplicação OAuth no Monday.com Centro de Programadores. Regista o ID de cliente e o segredo do cliente, ativa os âmbitos de leitura necessários, configura os URLs de redirecionamento e promove a aplicação para viver status antes de a utilizar com o conector.

Utilize esta opção quando a sua organização exigir uma configuração personalizada da aplicação OAuth.

Inicie sessão na sua conta monday.com e aceda ao Centro de Programadores do monday.com.
Selecione Criar aplicação.
Na secção Definições Gerais , localize e anote o ID de cliente e o segredo do cliente.
Na secção Compilação , abra o separador permissões & OAuth , selecione o separador Âmbitos e ative todas as permissões de leitura.
Aceda ao separador URLs de Redirecionamento , introduza os seguintes URLs de redirecionamento e selecione Guardar Âmbitos.
- Para Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
- Para o Microsoft 365 Administração Pública:https://gcsgcc.office.com/v1.0/admin/oauth/callback
Selecione Promover ao Vivo para ativar a aplicação.

Introduza o ID de cliente e o segredo do cliente do monday.com.
Selecione Autorizar para iniciar sessão e conceder acesso.
Conceda os âmbitos de API necessários.

Implementar

Pode implementar o conector numa audiência limitada para validar os resultados no Copilot e no Microsoft Search antes de disponibilizar o conector de forma mais abrangente.

Para implementar para um conjunto limitado de utilizadores:

Ative Implementação para audiência limitada.
Especifique os utilizadores ou grupos que podem aceder ao conteúdo do conector.

Quando estiver pronto, selecione Criar para publicar a ligação. O conector começa imediatamente a indexar conteúdo.

O conector monday.com fornece predefinições otimizadas para utilização típica monday.com. A tabela seguinte lista os valores predefinidos que são definidos quando cria a ligação:

Categoria	Setting	Valor padrão
Usuários	Permissões de acesso	Apenas pessoas com acesso a esta origem de dados.
Usuários	Mapeamento de identidade	Identidades de origem de dados mapeadas com Microsoft Entra ID.
Conteúdo	Conteúdo do índice	Todos os quadros e itens, excluindo espaços pessoais. Para obter uma lista de propriedades, veja Personalizar definições de conteúdo.
Rastreamento	Pesquisa incremental	A cada quatro horas.
Rastreamento	Pesquisa completa	Todos os dias.

Estes valores ajudam a equilibrar a atualização do conteúdo, respeitando monday.com limites da API.

Para personalizar os valores predefinidos, selecione Configuração personalizada. Para obter mais informações, veja Personalizar definições.

Depois de criar a ligação, pode rever a status na secção Conectores do Centro de administração do Microsoft 365.

Personalizar definições (opcional)

Pode personalizar os valores predefinidos depois de criar a ligação ao selecionar Configuração personalizada. A configuração personalizada inclui os seguintes separadores:

Usuários
Conteúdo
Rastreamento

Personalizar as definições do utilizador

Permissões de acesso

O conector monday.com Copilot suporta dados visíveis para Apenas pessoas com acesso a esta origem de dados (recomendado) ou a Todos. Se escolher Todos, os dados indexados são apresentados nos resultados da pesquisa para todos os utilizadores.

Identidades do mapa

Para garantir a imposição de permissão correta, mapeie monday.com identidades de utilizador para Microsoft Entra ID.

Escolha a opção Microsoft Entra ID se o ID de e-mail de monday.com utilizadores for igual ao nome principal de utilizador (UPN) dos utilizadores no Microsoft Entra ID.
Escolha a opção de ID não Entra se o ID de e-mail de monday.com utilizadores for diferente do UPN dos utilizadores no Microsoft Entra ID.

Importante

Se escolher Microsoft Entra ID como o tipo de origem de identidade, o conector mapeia os IDs de e-mail dos utilizadores de monday.com diretamente para a propriedade UPN de Microsoft Entra ID.
Se escolheu o ID não Entra para o tipo de identidade, forneça a expressão regular de mapeamento do ID de e-mail para o UPN. Para obter mais informações, consulte Mapear as suas identidades não-Entra ID.
Atualizações para utilizadores ou grupos que regem as permissões de acesso são sincronizados apenas em pesquisas completas. Atualmente, as pesquisas incrementais não suportam o processamento de atualizações para permissões.

Personalizar definições de conteúdo

Filtros de ingestão de conteúdos

Pode escolher os dados que pretende indexar. Utilize a expressão regex das Áreas de Trabalho para selecionar os seus dados antes de serem indexados para controlar que dados são pesquisáveis. Os exemplos seguintes mostram como utilizar expressões regex para selecionar áreas de trabalho específicas.

Cenário	Nomes de áreas de trabalho de exemplo	Expressão Regex	Observações
Correspondência exata de uma única área de trabalho	área de trabalho1	^área de trabalho1$	Correspondência exata da área de trabalho1
Correspondência difusa para uma única área de trabalho	team-marketing-q1	.marketing.	Corresponde a qualquer área de trabalho que contenha marketing no nome
Correspondência exata para várias áreas de trabalho	área de trabalho1, área de trabalho2	^(área de trabalho1\|área de trabalho2)$	Corresponde exatamente à área de trabalho1 ou área de trabalho2
Correspondência difusa para várias áreas de trabalho	workspace-marketing, workspace-sales	^área de trabalho-[a-z]+$	Corresponde a qualquer área de trabalho que comece com a área de trabalho e letras
Correspondência difusa para múltiplas palavras-chave no nome	workspace-engineering, workspace-sales-q4	.(eng\|sales).	Corresponde a áreas de trabalho que contêm engenharia ou vendas no nome

Selecione Pré-visualizar resultados para verificar os valores de exemplo das propriedades e filtros selecionados.

Gerir propriedades

Verifique as propriedades disponíveis na sua instância monday.com. Atribua um esquema à propriedade (defina se uma propriedade é pesquisável, consultada, recuperável ou refinável), reveja a etiqueta semântica e adicione um alias à propriedade. A tabela seguinte lista as propriedades selecionadas por predefinição.

Propriedade Default (Padrão)	Label	Descrição	Esquema
Autores	Autores	O autor dos itens	Consultar, Obter, Procurar
BoardDescription	Nenhum	Descrição do quadro.	Obter, Procurar.
BoardID	Nenhum	Identificador exclusivo do quadro.	Consulta, Obter.
BoardName	Nenhum	Nome do quadro.	Consultar, Obter, Procurar, Refinar
BoardUrl	Nenhum	Ligação do URL para o quadro.	Consulta, Obter.
Conteúdo	CONTEÚDO	Intercale todas as colunas e os valores correspondentes do item.	Pesquisa.
CreatedBy	Criado por	Utilizador que criou o item.	Consultar, Obter, Procurar
DataeHoraDaCriação	Data e hora de criação	Carimbo de data/hora quando o item foi criado.	Consulta, Obter.
GroupID	Nenhum	O identificador exclusivo do grupo.	Consulta, Obter.
GroupName	Nenhum	Nome do grupo.	Consultar, Obter, Procurar.
IconUrl	IconUrl	URL relacionado com o ícone.	Obter
ItemPath	Nenhum	Caminho do item.	Consultar, Obter, Procurar, Refinar.
ItemTerminologia	Nenhum		Consultar, Obter, Refinar.
LastModifiedBy	Última modificação por	Utilizador da última modificação.	Consultar, Obter, Procurar.
DataeHoraDaÚltimaModificação	Hora da última modificação	Carimbo de data/hora da última modificação.	Consulta, Obter.
Título	Título	Título do item de tarefa.	Consultar, Obter, Procurar.
URL	url	URL relacionado com o item.	Obter.
WorkspaceDescription	Nenhum	Descrição da área de trabalho.	Obter, Procurar.
ID da Área de Trabalho	Nenhum	Identificador exclusivo da área de trabalho.	Consulta, Obter.
WorkspaceName	Nenhum	Nome da área de trabalho.	Consultar, Obter, Procurar, Refinar.

Propriedade content

O campo Conteúdo contém um objeto JSON que representa todas as colunas e os respetivos valores correspondentes para um determinado item. Cada chave no objeto JSON corresponde a um nome de coluna (como Assignee ou Status) e cada valor contém os dados específicos desse item. O exemplo seguinte mostra como um item e o respetivo campo Conteúdo são estruturados.

{  
"Assignee": "QC",  
"Status": "Not Started",  
"Date": "Apr 2",  
"Priority": "Medium",  
"Labels": "Benefits, Flexible"  
}

Personalizar intervalos de pesquisa

O conector suporta dois tipos de pesquisa:

Pesquisa incremental, que captura alterações recentes.
Pesquisa completa, que atualiza todos os conteúdos indexados.

Por predefinição, as pesquisas incrementais são executadas a cada quatro horas e as pesquisas completas são executadas diariamente. Pode ajustar estes valores, mas considere monday.com limites diários de chamadas à API se configurar agendas de sincronização mais frequentes.