Automatize o Transept com gatilhos de webhook

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

Alterne o card para Webhook, defina em que o disparo será executado (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 mostrada novamente. O segredo fica na própria 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 card mais tarde, você verá um prefixo mascarado (whk_live_…) no lugar da URL completa, além da ação Rotacionar. A rotação gera uma nova URL e invalida a antiga no instante em que você confirma — é assim que se descarta um link que vazou. Você também pode mudar o gatilho para Desativado sem excluí-lo, ou removê-lo de vez. O card mostra quando ele foi acionado pela última vez.

Duas configurações definem o que o fluxo de trabalho processa quando a URL é acionada:

• Destino — um documento fixo que você define (cada acionamento é direcionado a esse documento e seu grupo de idiomas) ou a página do Notion indicada no payload recebido (o Transept faz a correspondência com o 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 abrange todos os idiomas do destino como uma execução em grupo) ou apenas um único documento.
• Apenas conteúdo atualizado — ativado por padrão, pois uma execução automatizada deve processar apenas o que mudou desde a última vez, em vez de traduzir todo o documento a cada acionamento. Veja Executar apenas o que mudou.

Uma automação de banco de dados do Notion pode chamar o gatilho com sua ação 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 disparou o acionamento. Há duas coisas que vale a pena saber antes de começar a usá-la.

Primeiro, as automações do Notion são acionadas por uma mudança de propriedade (ou uma nova página), e não apenas por uma edição no 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 traz o conteúdo dela — por isso o Transept lê a página por meio da sua conexão com o Notion, que deve ter acesso concedido 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. Pule qualquer uma delas e cada acionamento 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 o destino de página do Notion lê o corpo para identificar qual página mudou. Não é necessário nenhum cabeçalho Authorization — o segredo é a própria URL.

Por padrão, um acionamento 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 original mudou desde a última execução, de modo que uma pequena edição consome apenas alguns blocos, em vez do documento inteiro. As execuções iniciadas dessa forma cobram palavras exatamente como no editor do aplicativo; 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 em espera: o acionamento traduz até esse ponto e depois para, e o idioma aparece no painel “Pronto para revisão” do editor para você aprovar — a automação não ignora 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 acionamento não resultou em nada.

Sim. Defina o destino do gatilho como “o corpo da requisição é o conteúdo” e tudo o que você enviar via POST para a URL se tornará o documento: Markdown puro, HTML ou texto simples (envie o Content-Type correspondente), ou um JSON como {"content": "…", "content_type": "markdown"}. Escolha em cada gatilho se cada envio cria um novo documento ou atualiza um documento fixo — uma atualização realinha o conteúdo para que apenas os blocos alterados sejam retraduzidos. É assim que uma plataforma de e-mail, uma etapa do Zapier/n8n ou qualquer script envia um modelo ou artigo diretamente para um fluxo de trabalho de tradução sem upload manual. Envios repetidos são deduplicados por 24 horas; inclua um external_id no JSON (o ID da sua mensagem) para controle preciso. Corpos de até 10 MB.