Conectar o Notion
A ligação do Notion no FyneDesk permite que sua equipa envie o contexto de tickets ao Notion, sincronize artigos da base de conhecimento com páginas do Notion e permita que a IA use conteúdo selecionado do Notion ao redigir respostas, resumos e sugestões de triagem.
O que a ligação faz
- Ticket → Notion: cria uma página vinculada do Notion em um banco de dados selecionado quando um ticket é criado, escalonado ou marcado com tag.
- Sincronização da base de conhecimento: publica artigos da base de conhecimento de propriedade do FyneDesk no Notion, ou importa páginas selecionadas do Notion como artigos de propriedade do Notion.
- Fonte de conhecimento para IA: permite que a IA do FyneDesk use páginas e bancos de dados selecionados do Notion junto com sua base de conhecimento e tickets anteriores. Se você mapear status, alterações no Notion também podem atualizar o status do ticket vinculado no FyneDesk.
Antes de começar
- Você precisa ser administrador da organização no FyneDesk.
- Seu workspace do FyneDesk precisa estar no plano Pro.
- Você precisa de acesso ao workspace, às páginas e aos bancos de dados do Notion que deseja que o FyneDesk use.
- Você não precisa criar um app de desenvolvedor no Notion nem configurar webhooks do Notion. O FyneDesk cuida da ligação depois que você a autoriza no Notion.
Passo 1 — Conectar o Notion
- No FyneDesk, abra Configurações → Ligações → Notion.
- Clique em Conectar.
- O Notion abre uma ecrã de autorização. Escolha o workspace correto.
- No seletor de páginas do Notion, selecione as páginas e os bancos de dados que o FyneDesk poderá usar.
- Volte ao FyneDesk. A página de ligação do Notion deve mostrar o status da ligação e as opções de configuração.
Passo 2 — Ativar a ligação
O botão principal de ativação começa desligado. Depois que o Notion estiver conectado, ative a ligação na página de configurações do Notion. Mantenha-o desligado se quiser terminar de escolher bancos de dados, regras de sincronização e fontes de IA antes que algo comece a se mover.
Passo 3 — Configurar Ticket → Notion
Use Ticket → Notion quando um ticket deve se tornar trabalho planejado no Notion, como um escalonamento de engenharia, um bug de produto, uma solicitação de recurso, uma lacuna de documentação ou um acompanhamento de operações.
- Escolha o banco de dados de destino no Notion. É o banco de dados onde o FyneDesk cria a página vinculada.
- Escolha o gatilho: ao criar, ao escalonar ou ao marcar com tag.
- Opcionalmente, mapeie campos do FyneDesk para propriedades do Notion para que a página do Notion chegue com os campos corretos de status, responsável, prioridade ou categoria para o seu fluxo de trabalho.
Quando o gatilho é acionado, o FyneDesk cria uma página do Notion com o título do ticket, os campos principais e um link de volta para o ticket. O FyneDesk não cria páginas duplicadas no Notion para o mesmo ticket.
Passo 4 — Configurar a sincronização base de conhecimento ↔ Notion
A sincronização da base de conhecimento tem dois sentidos. Você pode usar um deles ou ambos, dependendo de onde cada artigo deve ser editado.
- Destino de publicação: escolha o local no Notion onde os artigos da base de conhecimento de propriedade do FyneDesk devem ser publicados.
- Fontes de importação: escolha páginas ou bancos de dados do Notion que devem ser trazidos para o FyneDesk como artigos de propriedade do Notion.
- Proprietário padrão: escolha se os artigos recém-vinculados devem pertencer ao Notion ou ao FyneDesk.
Como funciona a propriedade do artigo
Cada artigo sincronizado tem um proprietário, também chamado de fonte da verdade. Se o FyneDesk for o proprietário do artigo, edite-o no FyneDesk e o Notion mostra um espelho somente leitura. Se o Notion for o proprietário do artigo, edite-o no Notion e o FyneDesk mostra um espelho somente leitura.
O lado espelhado pode mostrar um selo “editado no Notion” ou “editado no FyneDesk” para que sua equipa saiba onde pertencem as alterações. O FyneDesk não mescla edições conflitantes entre os dois lados. Para mudar onde um artigo deve ser editado, troque o proprietário desse artigo.
Passo 5 — Permitir que a IA use o Notion
Para disponibilizar conteúdo do Notion à IA do FyneDesk, escolha as páginas ou bancos de dados do Notion em fontes de IA e ative o botão de fonte de IA. Esse botão começa desligado por padrão.
Quando ativado, os rascunhos de respostas da IA, os resumos e as sugestões de triagem podem usar o conteúdo selecionado do Notion junto com sua base de conhecimento do FyneDesk e tickets anteriores. Editar uma página selecionada do Notion atualiza a fonte de conhecimento da IA depois que a sincronização e a indexação são executadas.
Passo 6 — Mapear status do Notion de volta aos tickets
Se o seu rastreador no Notion usa status, você pode mapear os valores de status do Notion para status ou ações de tickets do FyneDesk. Após o mapeamento, alterar o status na página vinculada do Notion pode atualizar o ticket vinculado no FyneDesk.
A sincronização de status é segura contra loops: uma atualização de status não deve ficar indo e voltando indefinidamente entre o FyneDesk e o Notion.
Monitorar a integridade da ligação
A página de ligação do Notion mostra detalhes de integridade, como o horário da última sincronização ou evento e o status da assinatura. Verifique essa área quando um ticket, artigo ou fonte de IA não parecer atualizado.
Limites a conhecer
- O FyneDesk só vê as páginas e os bancos de dados selecionados no seletor de autorização do Notion.
- A sincronização da base de conhecimento não é um clone perfeito do layout do Notion. Texto simples, títulos, listas, tabelas, imagens, blocos de código, citações, alternâncias e callouts são convertidos corretamente. Incorporações, prévias de links e layouts complexos podem ser simplificados ou substituídos por marcadores.
- Páginas muito grandes do Notion, com cerca de 20.000 blocos ou mais, podem ser truncadas.
- A sincronização não é instantânea. Aguarde um minuto ou alguns minutos para que as alterações apareçam.
- Cada artigo sincronizado da base de conhecimento tem um único proprietário. O lado espelhado é somente leitura até você trocar a propriedade.
- A ligação do Notion requer o plano Pro.
Solução de problemas
O FyneDesk pede para reconectar o Notion. A autorização do Notion pode ter expirado ou sido revogada. Abra Configurações → Ligações → Notion e conecte novamente. A sincronização é retomada depois que a ligação é restaurada.
Um ticket ou artigo não está sincronizando. Confirme que o botão principal está ligado, que o botão do recurso correspondente está ligado e que a página ou o banco de dados do Notion foi compartilhado com o FyneDesk durante a autorização. Para artigos da base de conhecimento, verifique também qual lado é o proprietário do artigo.
A IA não está usando o conteúdo do Notion. Confirme que o botão de fonte de IA está ligado, que a página ou o banco de dados está selecionado como fonte de IA e que houve tempo suficiente para a sincronização e a indexação.
Não encontro uma página ou banco de dados do Notion no FyneDesk. Reconecte o Notion e verifique se esse item está selecionado no seletor de páginas do Notion. O FyneDesk não consegue listar páginas ou bancos de dados que não teve permissão para acessar.
Gerir ou desconectar
Para alterar as páginas compartilhadas, atualizar permissões ou recuperar o acesso após uma revogação, reconecte o Notion na mesma página. Para interromper a integração, clique em Desconectar. Desconectar remove os tokens e a configuração do Notion armazenados no FyneDesk e pausa a sincronização do Notion até que um administrador conecte novamente.
Privacidade & acesso
O acesso ao Notion é limitado às páginas e bancos de dados selecionados pelo seu administrador no Notion. O FyneDesk não recebe acesso a todo o seu workspace do Notion, a menos que essas páginas sejam explicitamente compartilhadas. A ligação é no nível da organização, então os administradores devem selecionar apenas as páginas e os bancos de dados necessários para o repasse de tickets, a sincronização da base de conhecimento e o conhecimento da IA.