O que você vai configurar
- Uma conexão OAuth que dá ao Elido acesso apenas às páginas e bancos de dados do Notion que você selecionar.
- Uma visão clara do que a conexão Beta faz hoje e do que ainda está planejado.
- Um fluxo feito por você que preenche uma tabela do Notion a partir de webhooks do Elido e da API de analytics.
A integração com o Notion é uma conexão OAuth em Beta. Você pode conectar um workspace e escolher quais páginas e bancos de dados o Elido pode ver, e o Elido guarda o token de acesso. Nenhuma linha é criada e nenhuma contagem de cliques é gravada. A sincronização de bancos de dados está planejada. As seções abaixo mostram o que funciona hoje e um caminho DIY que você pode montar agora. Para a receita completa, leia Notion database link sync.
O que funciona hoje
- Conectar um workspace por OAuth em Dashboard → Integrations → Notion → Connect.
- Escolher, no seletor de páginas do Notion, a quais páginas e bancos de dados o Elido pode ter acesso. O Elido não vê nada que você não tenha selecionado.
- Ver se a conexão está ativa e desconectá-la. Ao desconectar, o Elido a marca como revogada. Remova também a conexão no Notion, em Settings → Connections, para que o token deixe de valer.
O que está planejado
Uma sincronização bidirecional entre um banco de dados do Notion e sua biblioteca de links do Elido: slug, destino, tags e contagens de cliques como linhas, mapeamento de colunas e criação de links a partir do Notion. Nenhuma data foi definida.
Conectar por OAuth
- Acesse Dashboard → Integrations → Notion → Connect.
- A tela de OAuth do Notion é aberta. Entre com a conta que tem acesso ao seu workspace.
- No seletor de páginas do Notion, escolha as páginas ou bancos de dados a compartilhar. Você pode adicionar mais depois, sem reautorizar.
- Clique em Allow access. O Notion redireciona você de volta ao Elido.
DIY: preencher uma tabela do Notion a partir do Elido
- No Notion, crie um banco de dados com uma coluna de título, duas colunas de URL (link curto e destino) e uma coluna numérica (cliques). Crie uma integração interna no Notion e compartilhe o banco de dados com ela.
- No Elido, acesse Dashboard → Webhooks → Add → Generic e ative
link.created,link.updatedelink.expired. Aponte para um pequeno script ou automação que verifique a assinatura HMAC (veja o guia de Webhooks) e depois chame a API do Notion para adicionar ou atualizar uma linha. - Para as contagens de cliques, execute um job agendado que leia a API de analytics do Elido e atualize a coluna numérica. Não há webhook por clique, então as contagens não podem ser enviadas em tempo real.
O Notion limita as requisições à API a cerca de 3 por segundo por conexão. Em caso de HTTP 429, aguarde o cabeçalho Retry-After antes de tentar de novo.
Solução de problemas
O banco de dados não aparece no seletor. O Notion só mostra as páginas que você concede de forma explícita. Execute a conexão de novo e selecione as páginas ou bancos de dados corretos.
Nenhuma linha ou contagem de cliques aparece no Notion. É o esperado. Nada é sincronizado ainda. Use o caminho DIY acima.
OAuth revogado ou expirado. Os tokens deixam de funcionar se a conexão for removida no lado do Notion. Reconecte em Dashboard → Integrations → Notion → Reconnect.