Você moveu seu espaço de trabalho do Notion ou transferiu conteúdo para outra conta, e agora suas integrações mostram o erro “Token de Integração da API Inválido”. Isso acontece porque os tokens da API estão vinculados a um espaço de trabalho específico. Quando o espaço de trabalho muda, o token antigo não funciona mais. Este artigo explica por que o token se torna inválido, como gerar um novo e como reconectar suas integrações.
Principais conclusões: Corrigindo o token de API inválido após uma mudança de espaço de trabalho
- Configurações de integração > Token de Integração Interna: Gere um novo token no novo espaço de trabalho para substituir o antigo.
- API do Notion > cabeçalho Authorization: Atualize seu código ou ferramenta com o novo valor do token.
- Notion > Conexões: Remova e adicione novamente a integração no novo espaço de trabalho para restaurar o acesso.
Por que o token da API se torna inválido após uma mudança de espaço de trabalho
Cada token de integração da API do Notion é gerado para um espaço de trabalho específico. O token contém uma referência criptografada ao ID desse espaço de trabalho. Quando você move páginas ou bancos de dados para um novo espaço de trabalho, o token antigo ainda aponta para o espaço de trabalho original. O novo espaço de trabalho rejeita o token porque ele não corresponde ao ID de espaço de trabalho esperado. Além disso, se você transferir a propriedade de páginas, a integração deve ser reautorizada no espaço de trabalho de destino. O Notion não migra automaticamente as permissões de integração durante uma transferência de espaço de trabalho. Você deve criar manualmente um novo token de integração no espaço de trabalho de destino e atualizar todas as ferramentas externas ou scripts que usam a API.
Passos para gerar um novo token de integração e reconectar
- Crie uma nova integração interna no novo espaço de trabalho
Abra o novo espaço de trabalho do Notion em um navegador. Vá para Configurações e Membros > Minhas conexões > Desenvolver ou gerenciar integrações. Clique em Nova integração. Dê um nome e selecione o novo espaço de trabalho no menu suspenso. Clique em Enviar. Copie o Token de Integração Interna gerado na tela seguinte. - Adicione a integração ao banco de dados ou página de destino
Abra a página ou banco de dados que você moveu para o novo espaço de trabalho. Clique no menu de três pontos no canto superior direito. Selecione Adicionar conexões. Encontre sua integração na lista e clique nela. A página agora concede permissão para essa integração. - Atualize seu código ou ferramenta de terceiros com o novo token
Localize onde seu token original está armazenado. Pode ser em um script, variável de ambiente ou ferramenta como Zapier, Make ou Automate.io. Substitua a string do token antigo pelo novo token do passo 1. - Teste a conexão
Execute uma chamada de API simples, como listar as páginas no banco de dados. Se você usa uma ferramenta, acione uma ação de teste. Confirme que a resposta não mostra mais o erro “Token de Integração da API Inválido”. - Remova a integração antiga do espaço de trabalho original (opcional)
No espaço de trabalho original, vá para Configurações e Membros > Minhas conexões. Encontre a integração que você criou anteriormente e clique em Remover. Isso evita confusão se você voltar ao espaço de trabalho antigo.
Se o Notion ainda mostrar o erro de token após reconectar
A integração não está conectada ao banco de dados correto
O token de integração funciona apenas se a integração foi adicionada à página ou banco de dados específico. Um erro comum é gerar um novo token, mas esquecer de adicionar a integração ao banco de dados movido. Abra o banco de dados, clique no menu de três pontos, escolha Adicionar conexões e selecione sua integração. Se a integração já estiver listada, remova-a e adicione novamente para atualizar a permissão.
Token foi copiado incorretamente
A string do token diferencia maiúsculas de minúsculas e inclui hífens. Um caractere ausente ou um espaço extra causa o erro. Volte para a página de configurações da integração no novo espaço de trabalho e copie o token novamente. Cole diretamente em seu código ou ferramenta sem edição manual. Se você armazenar o token em uma variável de ambiente, verifique se não há aspas ou espaços em branco ao redor.
Ferramenta de terceiros ainda usa credenciais em cache
Alguns serviços como Zapier ou Make armazenam em cache os detalhes da conexão. Mesmo depois de atualizar o token, a ferramenta pode ainda enviar o antigo. No Zapier, desconecte completamente a conexão do aplicativo Notion e crie uma nova usando o novo token. No Make, exclua o módulo antigo do Notion e adicione um novo com o token atualizado. Após reconectar, execute uma operação de teste.
Token do espaço de trabalho antigo vs token do novo espaço de trabalho: principais diferenças
| Item | Token do espaço de trabalho antigo | Token do novo espaço de trabalho |
|---|---|---|
| ID do espaço de trabalho | Referencia o espaço de trabalho original | Referencia o espaço de trabalho de destino |
| Nome da integração | Pode ser reutilizado, mas o token é diferente | Deve ser gerado novamente |
| Páginas conectadas | Apenas páginas no espaço de trabalho antigo | Apenas páginas no novo espaço de trabalho |
| Status da permissão | Integração não adicionada às páginas movidas | Integração deve ser adicionada manualmente |
| Validade após mudança de espaço de trabalho | Inválido para o novo espaço de trabalho | Válido apenas para o novo espaço de trabalho |
Agora você sabe por que o token da API se torna inválido após uma mudança de espaço de trabalho e como corrigir isso. Gere um novo token no espaço de trabalho de destino, adicione a integração às suas páginas movidas e atualize todas as ferramentas externas que usam a API do Notion. Como dica avançada, armazene o token em uma variável de ambiente segura ou em um gerenciador de segredos para que você possa atualizá-lo em um só lugar, em vez de editar cada script.