Notion Workers: o que a sincronização faz e o que não faz

Notion Workers são programas pequenos em TypeScript que o Notion hospeda e executa para você. Uma das coisas que eles fazem é sincronizar: puxar dados de um serviço externo para um banco de dados do Notion, em intervalos programados.

Essa sincronização anda em um sentido só, de fora para dentro do Notion. Toda coluna que ela controla vira somente leitura, então você não consegue mudar o título de uma tarefa nem a data de entrega pelo lado do Notion.

Workers também exigem um plano Business ou Enterprise, e a partir de 15 de outubro de 2026 cada execução é cobrada em créditos do Notion.

O que são os Notion Workers

Um worker é um único arquivo TypeScript que você escreve, publica com a ferramenta de linha de comando ntn e o Notion roda na infraestrutura dele. Você nunca provisiona servidor.

Cada worker registra capacidades, e são três. Syncs puxam registros externos para um banco de dados do Notion em intervalos programados. Tools ficam disponíveis para os Custom Agents do Notion chamarem. Webhooks capturam eventos vindos de outros serviços. Só a primeira é sincronização no sentido em que a maioria das pessoas usa a palavra.

O próprio Notion traça essa linha na central de ajuda. As automações são nativas e feitas para qualquer pessoa configurar, enquanto os Workers são para desenvolvedores que querem rodar código próprio. O recurso está em beta, e os webhooks um passo atrás, em alfa.

Notion Workers e 2sync de um relance

Com os Workers, as colunas sincronizadas ficam somente leitura

Essa é a restrição que decide a maior parte dos fluxos de trabalho. A documentação de sincronização do Notion diz sem rodeios, para uma sincronização feita por Worker: as colunas sincronizadas são somente leitura, e nenhuma propriedade declarada no schema da sincronização pode ser editada à mão. Títulos e ícones de linha ficam travados do mesmo jeito, e linhas não podem ser criadas nem apagadas manualmente. Só a sincronização escreve nelas.

As colunas que você acrescenta fora do schema continuam editáveis, então dá para manter o seu próprio campo de status ao lado dos dados sincronizados. Nos campos sincronizados em si você não mexe.

Imagine um worker do Todoist. Ele traz as suas tarefas para o Notion com perfeição. Aí você abre o Notion, tenta adiar uma entrega em um dia, e o Notion não deixa. Para mudar a data você vai ao Todoist, muda lá e espera a próxima execução.

Num painel que ninguém edita, esse comportamento está certo e é uma vantagem real: garante que o Notion bate com a origem. Num fluxo em que o Notion é onde você de fato trabalha, ele tira o motivo pelo qual você conectou os dois aplicativos.

A API de sincronização não tem opção bidirecional nenhuma. A saída que o Notion oferece para empurrar mudanças de volta é um segundo worker, separado, construído sobre a capacidade de webhook e disparado por uma automação do Notion. Esse caminho de volta é você quem escreve, e junto com ele a prevenção de loop, as regras de conflito e a detecção de exclusões.

Quem pode usar Workers e quanto custa

Os Workers estão disponíveis nos planos Business e Enterprise. O Notion Business custa US$ 20 por membro/mês. Um workspace no plano gratuito ou no Plus não usa Workers de jeito nenhum, por mais que os membros saibam programar.

Por padrão o recurso vem ligado só para os proprietários, então num workspace de equipe alguém com permissão de administrador precisa liberar o acesso antes que qualquer pessoa publique alguma coisa.

A cobrança é a parte que merece conta na ponta do lápis. O beta gratuito do Notion cobre as execuções de Worker até 14 de outubro de 2026. A partir de 15 de outubro de 2026 elas consomem créditos do Notion, que custam US$ 0,01 cada, e o Notion estima uma execução em cerca de US$ 0,0023. Cada vez que uma sincronização programada roda, conta uma execução.

O intervalo mais curto que uma sincronização aceita é de 5 minutos. Nesse ritmo, uma única sincronização dispara 8.640 vezes num mês de 30 dias.

Fontes: preços dos Notion Workers e planos do Notion, ambos verificados em 15 de setembro de 2026. Os valores do 2sync saem da nossa página de preços.

O método é o do próprio Notion. O exemplo publicado por eles coloca uma sincronização do Salesforce a cada 15 minutos em 2.880 execuções e US$ 6,62 por mês, e a mesma aritmética produz os números acima.

Duas ressalvas, as duas puxando para o mesmo lado. O Notion avisa que os créditos por execução variam conforme o trabalho que o worker faz, então US$ 0,0023 é piso e não teto. E o conselho de solução de problemas deles, quando a conta vem mais alta do que o esperado, é reduzir a frequência das execuções. Custo e dados atualizados puxam para lados opostos, e isso é proposital.

O preço por execução também esconde o que você está pagando. A execução é cobrada mesmo quando nada mudou na origem. Uma agenda que ganha três eventos novos por semana dispara as mesmas 8.640 sincronizações por mês no intervalo de 5 minutos, e todas entram na conta. O medidor acompanha a consulta, não o trabalho, e é por isso que um banco de dados parado custa igual a um movimentado.

Se você monta isso para clientes, multiplique tudo. Créditos, assento Business e o teto de execuções são todos do workspace, e cada cliente tem o dele. Dez clientes com uma sincronização cada não somam US$ 19,87 por mês: somam dez vezes isso, mais dez assentos.

Uma coisa a mais que a tabela não mostra: Workers não rodam mais rápido do que a cada 5 minutos. Os intervalos de 3 e de 2 minutos dos nossos planos Premium e Pro não estão disponíveis a preço nenhum, e o padrão de uma sincronização nova é a cada 30 minutos.

Você registra o seu próprio app do Google ou da Microsoft

Os Workers não cuidam do login no provedor por você. Para uma API que exige autorização do usuário, a documentação do Notion manda registrar uma capacidade OAuth e fornecer as suas próprias credenciais. Para Google Agenda, Gmail ou Google Tarefas, isso quer dizer o seu projeto no Google Cloud e o seu app OAuth.

As regras do Google passam a valer para você, e não para o Notion. Elas são rígidas.

• Um app não verificado tem teto de 100 usuários, para sempre. O limite do Google vale para toda a vida do projeto e não pode ser zerado nem alterado. E os seus usuários veem o aviso de app não verificado no caminho.
• No modo de teste, os tokens expiram a cada sete dias. Um projeto deixado em Testing aceita até 100 usuários de teste, e as autorizações expiram sete dias depois do consentimento, tokens de atualização inclusive. Uma sincronização montada assim para de funcionar toda semana.
• O Gmail exige avaliação de segurança anual. Todos os escopos do Gmail, o gmail.readonly entre eles, são classificados como restritos. Qualquer app que leia dados restritos através de um servidor precisa passar por uma avaliação de segurança no framework CASA e repetir esse exame pelo menos a cada 12 meses. Só a verificação pode levar várias semanas.

O 2sync opera os aplicativos verificados do Google e da Microsoft e pede apenas os escopos estreitos listados na nossa página de segurança. Conectar o Gmail ou o Google Agenda leva o tempo de uma tela de login.

Para uma agência ou um consultor que configura isso para clientes, a diferença pesa muito. Cem contas é pouco quando cada cliente traz a equipe inteira, e o teto vale para a vida do projeto: chegou lá, você não reseta, você recomeça com outro projeto. Some a auditoria CASA anual, as semanas de verificação e o seu nome na tela de consentimento de cada cliente. Do outro lado, o cliente clica em conectar.

Apontar um worker para um banco de dados que você já usa

Uma sincronização pode se ligar a um banco de dados que já existe, com uma declaração attached vinculada pela linha de comando. O aviso do Notion nessa página merece ser citado: anexar entrega ao seu worker o controle do banco de dados real, linhas inclusive, e a sincronização pode sobrescrever ou apagar linhas existentes, resultando em perda de dados.

Tem uma segunda armadilha mais abaixo. Apagar o worker, ou tirar a declaração do banco de dados do código e publicar de novo, não libera o banco de dados. Ele fica travado e órfão, e o conserto é um comando de desvinculação que você precisa saber rodar antes.

O modo replace tem uma esquisitice própria. Ele apaga qualquer linha que não tenha visto durante um ciclo, então uma sincronização que falha no meio do caminho não apaga nada, de propósito, e o banco de dados fica com linhas velhas até a próxima execução limpa.

Nada disso está escondido. Está escrito com clareza, e o mérito é do Notion. Também é um conjunto de modos de falha que a pessoa que publicou o worker passa a carregar.

O 2sync nunca toma um banco de dados para si. Ele escreve só as propriedades que você mapeia, deixa as outras colunas em paz, e você continua podendo criar, editar e apagar linhas no Notion na mão.

O que você teria de construir e manter

Um worker te dá um ambiente de execução e um agendador. O resto do que uma ferramenta de sincronização faz é você quem escreve.

• Controle de taxa. O Notion fornece um pacer que você mesmo configura, dez requisições por segundo por exemplo, e os números são decisão sua para cada API que você toca. Errar neles faz o provedor te barrar. O nosso tratamento de novas tentativas usa backoff exponencial e lotes de tamanho variável no Notion, no Google, na Microsoft e no Todoist, e ninguém configura nada.
• Regras de conflito. Quando a mesma ficha muda dos dois lados entre duas execuções, alguma coisa precisa decidir o que vence. Resolvemos conflitos por campo, e não por item, então um título alterado no Notion e uma data alterada no Google Agenda sobrevivem os dois.
• Detecção de exclusões. Decidir que um registro ausente significa apagar, e não que a busca falhou, é a diferença entre um banco de dados arrumado e um vazio. Os nossos limites de segurança param uma sincronização antes que ela remova mais da metade dos itens sincronizados, e de novo antes que ela crie duplicatas.
• Teto de execuções do workspace. O Notion limita as sincronizações a 600 execuções por hora no workspace inteiro, divididas entre todos os workers publicados nele. Dez sincronizações no intervalo de 5 minutos consomem 120 delas por hora, então um workspace movimentado tem um teto para planejar em volta.

Nada disso é exótico. É simplesmente o que um motor de sincronização faz depois que outra pessoa já escreveu o código. Depois vem a manutenção comum que qualquer integração carrega. APIs de provedor mudam, schemas envelhecem, e acrescentar um campo a um banco de dados sincronizado significa editar o bloco de schema, editar o mapeamento, publicar de novo, zerar o estado da sincronização e disparar uma nova execução.

Quando um Worker é a ferramenta certa

Os Workers são bons de verdade num trabalho que nenhum serviço de sincronização cobre. Vale nomear esse trabalho com precisão.

Se você está no Business, escreve TypeScript e quer um espelho somente leitura do Salesforce, do Zendesk, do Stripe, do Jira ou de um banco de dados interno dentro do Notion, um Worker foi feito exatamente para isso. Nada precisa sair da infraestrutura do Notion, a trava de somente leitura garante que o espelho bate com a origem, e um agente consegue ler o resultado. O mesmo vale para qualquer coisa com API JSON para a qual nenhum fornecedor construiu conector.

O que você está comprando é alcance. Um Worker sincroniza qualquer coisa contra a qual você saiba programar, um conjunto de sistemas muito mais amplo do que qualquer produto de sincronização suporta. Se os sistemas que você tinha em mente são bancos de dados, e não agendas e tarefas, isso é uma categoria diferente da nossa, e a nossa comparação com o Whalesync mostra onde cada um encaixa.

O que ele não cobre é o caso em que uma pessoa edita a mesma ficha nos dois lugares. Esse é outro problema, e uma coluna somente leitura não resolve. Marcar uma tarefa como concluída no Notion e esperar que o Google Tarefas concorde é a versão cotidiana disso.

Como o 2sync cobre o mesmo terreno

O 2sync conecta o Notion nos dois sentidos com Google Agenda, Todoist, Google Tarefas, Outlook Calendar, Gmail, Outlook Mail, Google Contatos e Contatos do Outlook. As mudanças andam nos dois sentidos sozinhas, e as suas propriedades do Notion continuam editáveis o tempo todo.

A direção é definida por campo, não por automação, então uma mesma ficha pode ter campos bidirecionais ao lado de campos que só andam num sentido. O organizador ou a data de criação podem ficar presos ao provedor enquanto o título e a data continuam editáveis no Notion.

Essa escolha pesa mais do que parece. Quase 79% dos nossos usuários ativos rodam só bidirecional, e trabalham a partir do aplicativo que estiver aberto na hora. Um espelho somente leitura não serviria a nenhum deles.

Qualquer pessoa que saiba montar um banco de dados no Notion consegue configurar uma automação. A configuração acontece no navegador e leva uns cinco minutos: conectar o provedor, escolher o banco de dados do Notion, mapear as propriedades, definir filtros se você quiser. Nada é instalado e nada é publicado, então não sobra código para manter quando uma API muda. Em 127.000 contas e 202 países já processamos mais de 2,5 milhões de itens sincronizados.

O preço é por conta, e não por membro, e todo plano traz todas as integrações. Se você quer os detalhes de como a direção se comporta antes de configurar qualquer coisa, sincronização bidirecional e unidirecional explica campo por campo.

Qual dos dois encaixa no seu fluxo

Pense de trás para frente, a partir de onde a edição acontece.

• Você só lê os dados no Notion, e eles vêm de um sistema que mais ninguém conecta. Construa um Worker, se estiver no Business e alguém aí escrever TypeScript.
• Você edita nos dois aplicativos. Use uma ferramenta de sincronização bidirecional. Um Worker não devolve as suas edições do Notion, por mais coisa que você monte em volta. O 2sync escreve as mudanças nos dois sentidos, campo a campo.
• Você está no plano gratuito ou no Plus. Workers não estão disponíveis para você. O 2sync funciona em qualquer plano do Notion, gratuito incluído.
• Você quer uma ação pontual, e não correspondência contínua, como postar no Slack quando uma linha muda. Isso é plataforma de automação, e as alternativas ao Zapier para Notion comparam as opções realistas, com o 2sync frente ao Zapier item por item.
• Você quer agenda, tarefas e e-mail no Notion sem escrever nada. Comece pelo Google Agenda, pelo Outlook Calendar, pelo Todoist ou pelo Gmail.

As duas abordagens também convivem bem. Um Worker espelhando o seu CRM e o 2sync sincronizando a sua agenda resolvem problemas diferentes no mesmo workspace.

Conclusão

Os Notion Workers são um recurso para desenvolvedores, e o Notion diz isso com todas as letras. Eles esticam o alcance do Notion até qualquer API contra a qual você saiba programar, e fazem isso sem você levantar servidor.

O que eles não fazem é sincronização bidirecional. As colunas que um Worker sincroniza são somente leitura, a sincronização escreve para dentro do Notion e nunca para fora, e a saída é um segundo worker que você constrói e mantém. Some o plano Business, os créditos que valem a partir de 15 de outubro de 2026 e o seu próprio app OAuth com os tetos do Google pendurados nele, e o retrato honesto é uma ferramenta poderosa mirada num trabalho estreito.

Se os seus dados só precisam ser lidos no Notion, esse trabalho pode ser o seu. Se você trabalha nos dois aplicativos, precisa que as edições viajem nos dois sentidos.

FAQ