Executar código personalizado com workers (beta)

Os Workers do Notion fazem parte da nossa plataforma para desenvolvedores. Eles executam código personalizado na infraestrutura do Notion para potencializar:

• Sincronização da base de dados

• Ferramentas para Agentes Personalizados

• Gatilhos de webhook

• Os workers estão disponíveis nos Planos Business e Enterprise.

• Por padrão, os Workers estão ativados para o espaço de trabalho (apenas para proprietários).

• Os proprietários do espaço de trabalho podem:

  • Limitar a criação de Workers apenas aos proprietários.

  • Permitir que membros ou grupos específicos criem Workers.

  • Desativar os Workers para o espaço de trabalho.

• Se você estiver tentando implantar ou gerenciar um Worker, normalmente será preciso seguir a nossa documentação para desenvolvedores e usar a Notion CLI.

• Você pode ativar o Modo de Desenvolvedor para visualizar Workers no Notion, ler registros e desativar ou excluir Workers. Para implantar um Worker ou alterar seu código ou configuração, use a Notion CLI ou a ferramenta de codificação da sua equipe. Saiba mais sobre o modo de desenvolvedor →

Para saber mais sobre os preços dos workers, consulte este artigo.

A sincronização de banco de dados (impulsionada por Workers) traz informações de ferramentas externas para uma base de dados do Notion e as mantém atualizadas automaticamente. Depois de configurada, a base de dados sincronizada permanece atualizada por conta própria, para que sua equipe e seus agentes sempre vejam os dados mais recentes sem que ninguém precise copiar ou colar entre ferramentas.

Alguns exemplos comuns:

• Sincronizar tickets de suporte do Zendesk em uma base de dados de triagem.

• Sincronizar contas do Salesforce em um rastreador de pipeline.

• Sincronizar dados de uma ferramenta ou base de dados interna.

Depois de ativa, a base de dados sincronizada se comporta como qualquer outra base de dados no Notion. O acesso é regido pelas suas permissões de compartilhamento padrão do Notion.

As ferramentas de agentes (operadas por workers) ampliam o que os seus Agentes Personalizados conseguem fazer para além das ações nativas do Notion e MCP, com recursos adaptados à forma como a sua equipe trabalha.

Alguns exemplos comuns:

• Consultar um armazém de dados.

• Gerar ativos a partir de um documento do Notion.

• Realizar ações em outro aplicativo que não seja nativamente compatível ou disponível via MCP.

Os gatilhos de webhook (operados por workers) permitem que um evento em outra ferramenta inicie um fluxo de trabalho no Notion ou em qualquer outro sistema conectado.

Alguns exemplos comuns:

• Fechar uma tarefa quando uma pull request é aprovada.

• Atualizar um registro de CRM quando uma assinatura é alterada.

• Criar um documento de integração quando uma proposta é assinada.

Depois de configurado, o fluxo de trabalho é automaticamente executado sempre que ocorrer o evento, para que a sua equipe não precise mover manualmente as informações de uma ferramenta para outra.

Com o Modo de Desenvolvedor, você pode abrir Workers a partir da seção de desenvolvedor na sua barra lateral. Use esta visualização para verificações rápidas e ações básicas. No Notion, você pode:

• Ver todos os Workers em uma lista.

• Abrir um Worker e visualizar Visão geral, registros, Variáveis de ambiente e Configurações.

• Ler registros do Worker.

• Desativar ou excluir um Worker.

Para implantar um Worker ou alterar seu código ou configuração, use a Notion CLI ou a ferramenta de codificação da sua equipe.

Por padrão, apenas a pessoa que criou um Worker pode modificá-lo e adicioná-lo como uma nova conexão. Compartilhe um Worker com Colegas de equipe para que eles possam conectá-lo a um Agente personalizado ou ajudar a gerenciá-lo.

Saiba mais sobre como compartilhar um Worker →

Tente seguir estas etapas na ordem indicada:

1. Certifique-se de que seu espaço de trabalho seja elegível e que um proprietário do espaço de trabalho tenha habilitado os Workers. Os Workers estão disponíveis nos planos Business e Enterprise e exigem ativação por um administrador do espaço de trabalho.

2. Confirme se você está usando a rota de configuração pretendida. Para a maioria das configurações, você usará a Notion CLI além da documentação para desenvolvedores.

3. Se a implantação do seu Worker falhar, verifique as autorizações em seguida. Você pode não ter acesso para implantar nesse espaço de trabalho, mesmo que consiga visualizar páginas nele.

4. Se o seu Worker for executado, mas não alterar nada no Notion, teste a ação manualmente primeiro. Se você não conseguir fazer a mesma alteração no Notion, geralmente é um problema de autorização ou de configuração do espaço de trabalho.

5. Se o custo parecer maior do que o esperado, diminua a frequência de execução. Workers que são executados com mais frequência custarão mais. Comece com um cronograma mais lento e aumente quando tiver certeza de que está funcionando.

6. Ainda com problemas? Siga a documentação para desenvolvedores para a mensagem de erro específica. Lá você encontrará a correção mais precisa.