> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/insights/onsite/content-updates.md). # Atualizações de conteúdo Acompanhe quando as páginas são publicadas ou atualizadas nos seus workflows, exportações do Grid, API e MCP. Audite atualizações de conteúdo sem atualizar páginas manualmente. Abrir **Insights → Onsite → Atualizações de Conteúdo** para rever a atividade de publicação do seu conteúdo. Sempre que uma página é publicada ou atualizada através da AirOps, a atualização é registada e apresentada aqui, quer tenha sido feita via MCP, API ou uma etapa de workflow. Utilize este histórico para medir a produção, correlacionar alterações de conteúdo com resultados de visibilidade, como citações e cliques, e identificar páginas que precisam de uma atualização. As atualizações de conteúdo são capturadas automaticamente quando utiliza etapas nativas de integração com CMS em workflows ou exportações do Grid. Para integrações personalizadas (etapas de código, chamadas de API), pode registar atualizações de conteúdo explicitamente usando a [Rastrear atualização de conteúdo](/docs/pt/acoes/workflow-concepts/workflow-steps/content-updates/track-content-update.md) etapa de workflow, a [API de Atualizações de Conteúdo](https://docs.airops.com/api-reference/api-reference/brand-kits/content-updates), ou a `track_aeo_page_content_update` ferramenta MCP. {% hint style="info" %} Se [Deteção Automática de Alterações](/docs/pt/insights/onsite/content-updates/automated-change-detection.md) está ativada para a sua área de trabalho, cada atualização de conteúdo que regista também desencadeia uma nova captura da página, para que o diff na tabela Alterações da vista detalhada da página se mantenha atualizado. As alterações detetadas regressam a este feed como `Página Atualizada` atualizações de conteúdo marcadas como detetadas automaticamente. {% endhint %} *** ## Como as Atualizações de Conteúdo são Capturadas | Fonte | Como funciona | Ação necessária | | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | | [**Deteção Automática de Alterações**](/docs/pt/insights/onsite/content-updates/automated-change-detection.md) | Uma captura semanal de cada página inscrita regista uma `Página Atualizada` atualização de conteúdo quando é detetada uma alteração significativa, sem necessidade de integração com CMS | Ativado por defeito no Enterprise | | **Etapa nativa de CMS (workflow)** | Detetada automaticamente quando uma etapa CMS compatível cria ou atualiza conteúdo | Nenhum | | **Exportação do Grid** | Detetada automaticamente ao exportar linhas para um CMS compatível através do Grid | Nenhum | | **Etapa Rastrear Atualização de Conteúdo** | Adicionada manualmente a um workflow para registar uma atualização de conteúdo | Adicione a etapa e configure o URL + tipo | | **MCP** | A `track_aeo_page_content_update` a ferramenta regista atualizações de conteúdo de qualquer cliente MCP | Chame a ferramenta com o URL e o tipo | | [**API Pública**](https://docs.airops.com/api-reference/api-reference/brand-kits/content-updates) | `POST /public_api/brand_kits/{brand_kit_id}/content_updates` cria atualizações de conteúdo de forma programática | Enviar pedido à API | *** ## Deteção Automática a partir de Integrações CMS Quando um workflow utiliza uma etapa nativa de CMS para criar ou atualizar conteúdo, a AirOps captura a atualização de conteúdo automaticamente. O sistema resolve o URL da página a partir da resposta da API do CMS e determina se a ação foi uma publicação ou uma atualização. ### Integrações suportadas em workflows | Integração | Publicar (nova página) | Atualizar (alteração) | | ------------- | ------------------------------------- | ------------------------------------ | | **Webflow** | Criar item de coleção | Atualizar item de coleção | | **WordPress** | Criar publicação | Atualizar publicação | | **Shopify** | Criar artigo, Criar coleção | Atualizar produto, Atualizar coleção | | **Ghost** | Criar publicação, Publicar publicação | Atualizar publicação | ### Integrações suportadas nas exportações do Grid | Integração | Publicar | Atualização | | ------------- | ------------------------ | ------------------------------ | | **Webflow** | Exportação de nova linha | Atualização de linha existente | | **WordPress** | Exportação de nova linha | Atualização de linha existente | {% hint style="warning" %} Apenas as integrações listadas acima suportam deteção automática. Outras integrações CMS (Builder.io, ContentStack, Contentful, Craft CMS, Framer, HubSpot CMS, Sanity, Strapi, Storyblok) não registam atualizações de conteúdo automaticamente. Para workflows que publiquem conteúdo através destas ou de qualquer integração não suportada, adicione uma [Rastrear atualização de conteúdo](/docs/pt/acoes/workflow-concepts/workflow-steps/content-updates/track-content-update.md) etapa após a etapa de CMS para registar a atualização de conteúdo manualmente. {% endhint %} *** ## Tipos | Digite | Significado | | --------------------- | --------------------------------------------------- | | **Página Publicada** | Uma nova página foi criada e publicada | | **Página Atualizada** | Uma página existente teve o seu conteúdo atualizado | *** ## Associação ao Brand Kit Cada atualização de conteúdo requer que o URL da página corresponda a um domínio configurado no Brand Kit da sua área de trabalho. A AirOps verifica automaticamente o domínio do URL contra todos os domínios e URLs de marca do Brand Kit. Não é necessária nenhuma seleção manual do Brand Kit. Um URL de página pode corresponder a mais do que um Brand Kit. Se a sua área de trabalho tiver vários Brand Kits no mesmo domínio (por exemplo, variantes regionais ou arquivadas), é registada uma atualização de conteúdo separada para cada Brand Kit correspondente. Quando os Brand Kits usam URLs de marca específicos por caminho, como subcaminhos de idioma, por exemplo `example.com/es/`, as atualizações de conteúdo são encaminhadas para o Brand Kit correspondente mais específico. Um URL em `example.com/es/…` é registado no `/es/` Brand Kit, enquanto um URL que não esteja sob qualquer Brand Kit específico por caminho é registado nos Brand Kit(s) ao nível do domínio. Se não for encontrada correspondência, a deteção automática ignora silenciosamente a atualização de conteúdo. As fontes manuais (etapa Rastrear Atualização de Conteúdo, API, MCP) devolvem um erro para que possa corrigir o URL. *** ## Painel de Controlo de Atualizações de Conteúdo **Insights → Onsite → Atualizações de Conteúdo** tem duas vistas principais: ### Atualizações ao Longo do Tempo Um gráfico de linhas com contagens diárias de atualizações de conteúdo de publicação e atualização ao longo do intervalo de datas selecionado. Cada tipo tem a sua própria linha, para que possa ver rapidamente o ritmo de publicação e a cadência de atualização. ### Histórico de Atualizações de Conteúdo Uma tabela ordenável e filtrável com as seguintes colunas: | Coluna | Descrição | | ------------- | ---------------------------------------------------------- | | **Digite** | Página Publicada ou Página Atualizada | | **Fonte** | Origem da atualização: Auto, API, MCP ou Workflows & Grids | | **URL** | O URL da página associado à atualização de conteúdo | | **Data** | Quando a atualização de conteúdo foi registada | | **Metadados** | Pares chave-valor com contexto adicional | Use a caixa de pesquisa para encontrar atualizações por URL. Filtrar **Fonte** por **Auto**, **API**, **MCP**, ou **Workflows & Grids**. Escolha Auto para rever alterações detetadas automaticamente. É suportada a seleção e eliminação em massa para limpeza. *** ## Atualizações de Conteúdo na Vista Detalhada da Página Ao visualizar a vista detalhada de uma página, aparece um **Atualizações de Conteúdo Relacionadas** cartão na parte inferior que mostra todas as atualizações de conteúdo cujo URL corresponde a essa página. Isto fornece-lhe uma linha do tempo de cada publicação e atualização para essa página específica, com colunas para tipo, origem, data e metadados. *** ## Última Atualização e Páginas Desatualizadas A [Páginas](/docs/pt/insights/onsite/pages.md) a tabela inclui uma **Última Atualização** coluna que mostra há quanto tempo foi registada a atualização de conteúdo mais recente para cada página (por exemplo, "há 6 meses"). Esta coluna só fica visível enquanto um filtro de páginas desatualizadas estiver ativo. Use a funcionalidade **Páginas Desatualizadas** filtro inteligente para mostrar páginas cuja atualização de conteúdo mais recente tem mais de 6 meses. Estão disponíveis predefinições de filtro adicionais: mais de 1 mês, 3 meses, 6 meses e 1 ano. As páginas sem registo de atualização de conteúdo não estão incluídas nos resultados filtrados. Combine o filtro Páginas Desatualizadas com Oportunidades de Atualização para priorizar que páginas atualizar primeiro com base no impacto na visibilidade. *** ## Metadados de Atualização de Conteúdo Cada atualização de conteúdo pode conter metadados, que são pares chave-valor que fornecem contexto adicional sobre a atualização de conteúdo. ### Metadados do sistema Automaticamente anexados a cada atualização de conteúdo: | Chave | Descrição | | -------------------------------- | ---------------------------------------------------------------------------- | | `airops_app_id` | O ID do workflow que gerou a atualização de conteúdo | | `airops_app_type` | O tipo de app da AirOps (por exemplo, workflow) | | `airops_execution_id` | O ID de execução do workflow | | `airops_integration_page_status` | O estado da página reportado pelo CMS (por exemplo, `publicado`, `rascunho`) | | `airops_grid_table_id` | O ID da tabela do Grid (para atualizações de conteúdo de exportação do Grid) | ### Atributos personalizados Pode adicionar os seus próprios pares chave-valor (até 20 por atualização de conteúdo) ao utilizar a etapa Rastrear Atualização de Conteúdo, API ou MCP. Na etapa Rastrear Atualização de Conteúdo, tanto as chaves como os valores suportam [modelação Liquid](/docs/pt/acoes/workflow-concepts/liquid-template.md). *** ## Acesso Programático Crie, liste e recupere atualizações de conteúdo programaticamente usando a [API de Atualizações de Conteúdo](https://docs.airops.com/api-reference/api-reference/brand-kits/content-updates). As atualizações de conteúdo criadas via API têm origem `api`. O URL deve corresponder a um domínio Brand Kit na sua área de trabalho. A `track_aeo_page_content_update` como no `list_aeo_page_content_updates` As ferramentas MCP fornecem as mesmas capacidades a partir de qualquer cliente compatível com MCP. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.airops.com/docs/pt/insights/onsite/content-updates.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.