Skip to main content
Uma dúvida recorrente: dá para enviar o conteúdo do Caderno por uma automação? A resposta curta é não — e esta página explica o que dá, o que não dá e por onde ir.

O quadro em uma tabela

O conteúdo das páginas do Caderno não está disponível para automações, nem na referência da API, nem no MCP. A única operação de Caderno exposta fora da interface é copiá-lo junto com um projeto clonado.

Por que a automação não alcança o Caderno

Os campos de uma automação que aceitam variáveis — mensagem, assunto e corpo de e-mail, corpo customizado de webhook — leem o que está no contexto de execução, e completam o que falta com a função query. Nenhuma das consultas disponíveis devolve páginas do Caderno. A que mais se aproxima pelo nome é project_medias, e ela traz o conteúdo publicado no projeto — a aba Conteúdo, não o Caderno. A lista completa está em Variáveis nas automações.

O que fazer no lugar

Na maioria dos casos, o que precisa sair da plataforma é uma informação estruturada — e essa informação costuma já estar em um formulário ou no conteúdo do projeto.
As respostas de formulário já vêm carregadas no contexto, em project.form_answers. Não é preciso consulta.Uma montagem comum: gatilho Formulário editado + ação Disparar webhook, com o corpo customizado assim:
O filtro json com true devolve o JSON identado — bom para enxergar a estrutura na primeira execução e depois recortar só os campos que interessam:

Ações: comunicação, IA e execução

Os detalhes de Envia conteúdo do projeto e de Disparar webhook, incluindo o botão de testar o endpoint.

O Caderno na API

A referência da API não expõe endpoints para ler ou escrever páginas do Caderno. A única operação disponível é ao clonar um projeto: o corpo da requisição aceita forum, que copia o Caderno do projeto de origem para o clone.
Trecho do corpo de POST /api/management/projects/{project}/clone
Na referência da API essa opção ainda aparece com o nome técnico fórum, que é como o recurso se chama internamente. Na interface, o mesmo recurso é o Caderno.

O Caderno no MCP

O MCP da Olie segue a mesma regra da API: o assistente consegue consultar projetos, funis, métricas, formulários e o conteúdo dos projetos, e consegue clonar um projeto pedindo que o Caderno venha junto — mas não lê nem escreve as páginas.

Se o Caderno é mesmo o alvo

Quando a informação que precisa sair está no Caderno e não em outro lugar, hoje as saídas são manuais:

Copiar da página

O conteúdo da página é texto rico comum — selecionar e copiar funciona para levar para outro documento.

Repetir a informação no lugar certo

Se um dado do Caderno precisa circular por integração toda vez, o caminho sustentável é registrá-lo também em um campo de formulário, que a automação alcança.
Vale medir a necessidade antes: em boa parte dos casos o que a integração precisa não é a página inteira, e sim dois ou três campos. Esses campos rendem mais como formulário dinâmico — ficam consultáveis, filtráveis e disponíveis para automação.

Por onde continuar

Variáveis nas automações

O que existe no contexto e todas as consultas disponíveis.

Sintaxe avançada

Condicionais, laços e filtros das expressões.

O Caderno

O que é o Caderno e onde ele existe.

Referência da API

Autenticação, filtros e todos os endpoints.