O que cada recurso alcança
A tabela compara o Caderno com os dois recursos que costumam ocupar o lugar dele nas integrações:
O conteúdo das páginas do Caderno não está disponível para automações nem para o MCP. Na API, ele só é alcançado com o acesso de uma pessoa, como mostra O Caderno na API.
Por que a automação não alcança o Caderno
Alguns campos de uma automação aceitam variáveis: a mensagem, o assunto e o corpo de e-mail e o corpo customizado de webhook. Esses campos leem o que está no contexto de execução e completam o que falta com a funçãoquery.
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.- Enviar respostas de formulário
- Enviar o conteúdo do projeto
- Escrever de volta na plataforma
As respostas de formulário já vêm carregadas no contexto, em O filtro Veja mais exemplos de consulta em Sintaxe avançada.
project.form_answers. Não é preciso consulta.Uma montagem comum: gatilho Formulário editado + ação Disparar webhook, com o corpo customizado assim:json com true devolve o JSON indentado, o que ajuda a enxergar a estrutura na primeira execução. Depois, recorte só o que interessa.Para as respostas de um formulário específico, use a consulta get_form_answers. Ela precisa do pivot, o endereço que diz onde o formulário está anexado, e esse pivot vem pronto da consulta project_dynamic_forms: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
As páginas do Caderno são lidas e gravadas pelas mesmas rotas que a interface usa. Essas rotas são reservadas a pessoas, ou seja, à sessão de um usuário. Com token de aplicação, elas respondem HTTP 403 commessage: "access_denied_for_applications". Elas também não aparecem na referência da API.
A pessoa precisa ter permissão de edição no registro:
projects.edit.{id} para projeto, por exemplo.
Com token de aplicação, 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 não tem ferramenta de Caderno. O assistente consegue consultar projetos, funis, métricas, formulários e o conteúdo dos projetos. Ele também consegue clonar um projeto com o Caderno junto, mas não lê nem escreve as páginas do Caderno.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.
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.