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 operar as seguintes funções:

• Sincronização da base de dados

• Ferramentas para Agentes Personalizados

• Gatilhos de webhook

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

• O proprietário do espaço de trabalho precisa ativar os workers para o espaço de trabalho.

• Para implantar ou gerenciar um worker, normalmente será preciso seguir a nossa documentação para desenvolvedores e usar a Notion CLI.

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

A sincronização de bases de dados (operada 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 se mantém atualizada por conta própria, assim a sua equipe e os seus agentes sempre veem os dados mais recentes sem que ninguém precise copiar ou colar informações de uma ferramenta para outra.

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 publicada, a base de dados sincronizada se comporta como qualquer outra base de dados no Notion. O acesso é controlado por suas autorizaçõ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.

Tente seguir estas etapas na ordem indicada:

1. Confirme que o seu espaço de trabalho é elegível e que um proprietário do espaço de trabalho ativou os workers. Os workers estão disponíveis nos Planos Business e Enterprise e precisam ser ativados por um administrador do espaço de trabalho.

2. Confirme se você está usando o caminho de configuração correto. Para a maioria das configurações, você usará a Notion CLI e a documentação para desenvolvedores.

3. Se a implantação do seu worker falhar, verifique as permissões em seguida. Você pode não ter acesso para fazer a implantação nesse espaço de trabalho, mesmo que consiga visualizar as 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 isso é um problema de autorização ou de configuração do espaço de trabalho.

5. Se o custo parecer mais alto do que o esperado, reduza a frequência de execução. Quanto maior a frequência de execução de um worker, maior será o seu custo. Comece com uma frequência menor e aumente-a quando tiver certeza de que está funcionando.

6. Ainda não deu certo? Siga a documentação para desenvolvedores em relação à mensagem de erro específica. Lá você encontrará a correção mais precisa.