Automatize o Transept com gatilhos de webhook

Abra um fluxo de trabalho salvo no construtor e observe o cartão de gatilho no topo — aquele que diz Você o executa manualmente. É um seletor. Manual é o padrão: você mesmo clica em Executar. Webhook fornece ao fluxo de trabalho uma URL privada para a qual um sistema externo envia um POST, fazendo com que a execução comece sozinha. Um gatilho pertence a um fluxo de trabalho salvo, portanto, salve o fluxo primeiro — a opção Webhook permanece desativada em rascunhos não salvos.

Mude o cartão para Webhook, defina o que o disparo afeta (abaixo) e salve. O Transept gera uma URL secreta para este fluxo de trabalho específico e a exibe uma única vez — copie-a nesse momento, pois apenas um hash é armazenado e a URL completa nunca poderá ser exibida novamente. O segredo fica na URL, em vez de em um cabeçalho, porque os sistemas de envio mais simples não conseguem configurar cabeçalhos; portanto, trate a URL como uma senha — qualquer pessoa que a tiver poderá iniciar a execução.

Ao reabrir o cartão mais tarde, você verá um prefixo mascarado (whk_live_…) no lugar da URL completa, além de uma ação para Rotacionar. A rotação gera uma nova URL e invalida a antiga no instante em que você confirma — é assim que se desativa um link que vazou. Você também pode desativar o gatilho sem excluí-lo, ou removê-lo de vez. O cartão mostra quando ocorreu o último disparo.

Duas configurações decidem o que o fluxo de trabalho afeta quando a URL é acessada:

• Destino — um documento fixo que você define (cada disparo recai sobre esse documento e seu grupo de idiomas) ou a página do Notion indicada no payload recebido (o Transept a associa ao seu documento, importando a página na primeira vez que a identifica).
• Idiomas — todas as versões de idioma (o padrão; a execução se distribui por todos os idiomas do destino como uma execução em grupo) ou apenas o documento em questão.
• Apenas conteúdo atualizado — ativado por padrão, pois uma execução automatizada deve refazer apenas o que mudou desde a última vez, em vez de retraduzir o documento inteiro a cada disparo. Veja Executar apenas o que mudou.

Uma automação de banco de dados do Notion pode acionar o gatilho com sua ação de Enviar webhook: aponte a ação para a URL do gatilho e, toda vez que a automação for executada, o Transept executará o fluxo de trabalho na página que a disparou. Há duas coisas importantes a saber antes de começar a usá-la.

Primeiro, as automações do Notion são disparadas por uma alteração de propriedade (ou uma nova página), e não apenas pela edição do corpo do texto — portanto, editar o texto de uma página pode não disparar nada. O padrão mais confiável é usar uma propriedade de Status que a automação monitore: altere-a (por exemplo, para Pronto para traduzir) e essa mudança servirá como o sinal.

Segundo, um webhook do Notion apenas identifica a página — ele nunca carrega o conteúdo dela — por isso o Transept lê a página por meio da sua conexão com o Notion, que deve ter permissão de acesso ao banco de dados dentro do Notion. Ambas as etapas (conectar o Notion e depois compartilhar o banco de dados com a integração) estão detalhadas na seção “Gatilhos do Notion: dê acesso ao Transept” de Automatize o Transept com a API. Se pular qualquer uma delas, cada disparo será rejeitado com um erro de acesso.

Qualquer ferramenta capaz de enviar um POST HTTP pode disparar o gatilho — uma etapa do Zapier ou n8n, um job de CI ou um curl ao final de um build. Para um destino de documento fixo, o corpo não importa, então um POST vazio é suficiente; apenas um destino de página do Notion lê o corpo para identificar qual página mudou. Não é necessário um cabeçalho de Authorization — o segredo é a URL completa.

Por padrão, um disparo executa o fluxo de trabalho em todas as versões de idioma e — com a opção Apenas conteúdo atualizado ativada — retraduz apenas os blocos cujo conteúdo original mudou desde a última execução, de modo que uma pequena edição custa apenas alguns blocos, não o documento inteiro. Execuções iniciadas dessa forma cobram palavras exatamente como o editor no aplicativo e, se o saldo não for suficiente para cobrir a execução, nada é processado e nada é cobrado.

Uma etapa configurada para aguardar sua revisão ainda fica retida: o disparo traduz até essa etapa e depois fica em espera, e o idioma aparece no painel Prontos para revisão do editor para você aprovar — a automação não pula suas etapas de revisão. E quando um destino de página do Notion não pode ser lido (geralmente porque o banco de dados não foi compartilhado com a integração), o card do gatilho exibe a última falha como uma nota de “não foi possível ler a página do Notion”, com registro de data e hora, para que você veja por que um disparo não resultou em nada.