> 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 → No site → Atualizações de conteúdo** para rever a atividade de publicação de conteúdo. Sempre que uma página é publicada ou atualizada através do AirOps, a atualização é registada e apresentada aqui, quer tenha sido feita através de MCP, API ou uma etapa de fluxo de trabalho. 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 ser atualizadas.

As atualizações de conteúdo são registadas automaticamente quando utiliza etapas nativas de integração com CMS em fluxos de trabalho ou exportações do Grid. Para integrações personalizadas (etapas de código, chamadas à API), pode registar explicitamente as atualizações de conteúdo através da [etapa Track Content Update](https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/content-updates/track-content-update.md) do fluxo de trabalho, da [API Content Updates](https://docs.airops.com/api-reference/endpoints/brand-kits/content-updates), ou da ferramenta MCP `track_aeo_page_content_update` .

{% hint style="info" %}
Se a [Deteção automática de alterações](https://docs.airops.com/docs/pt/insights/onsite/content-updates/automated-change-detection.md) estiver ativada no seu espaço de trabalho, cada atualização de conteúdo que registar também desencadeia uma nova captura da página, para que a diferença na tabela Alterações dos detalhes da página se mantenha atualizada. As alterações detetadas são apresentadas neste feed como atualizações de conteúdo `Page Refreshed` marcadas como detetadas automaticamente.
{% endhint %}

***

## Como são registadas as atualizações de conteúdo

| Origem                                                                                                                                | Como funciona                                                                                                                                                                     | Ação necessária                              |
| ------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| [**Deteção automática de alterações**](https://docs.airops.com/docs/pt/insights/onsite/content-updates/automated-change-detection.md) | Uma captura semanal de cada página incluída regista uma atualização de conteúdo `Page Refreshed` quando é detetada uma alteração relevante, sem necessidade de integração com CMS | Ativada por predefinição no plano Enterprise |
| **Etapa nativa de CMS (fluxo de trabalho)**                                                                                           | Detetada automaticamente quando uma etapa de CMS compatível cria ou atualiza conteúdo                                                                                             | Nenhuma                                      |
| **Exportação do Grid**                                                                                                                | Detetada automaticamente ao exportar linhas para um CMS compatível através do Grid                                                                                                | Nenhuma                                      |
| **Etapa Track Content Update**                                                                                                        | Adicionada manualmente a um fluxo de trabalho para registar uma atualização de conteúdo                                                                                           | Adicione a etapa e configure o URL e o tipo  |
| **MCP**                                                                                                                               | A ferramenta `track_aeo_page_content_update` regista atualizações de conteúdo a partir de qualquer cliente MCP                                                                    | Chame a ferramenta com o URL e o tipo        |
| [**API pública**](https://docs.airops.com/api-reference/endpoints/brand-kits/content-updates)                                         | `POST /public_api/brand_kits/{brand_kit_id}/content_updates` cria atualizações de conteúdo de forma programática                                                                  | Envie um pedido à API                        |

***

## Deteção automática através de integrações com CMS

Quando um fluxo de trabalho utiliza uma etapa nativa de CMS para criar ou atualizar conteúdo, o AirOps regista automaticamente a atualização de conteúdo. O sistema obtém 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 compatíveis nos fluxos de trabalho

| Integração    | Publicar (página nova)                | Atualizar (atualizaçã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 compatíveis nas exportações do Grid

| Integração    | Publicar                 | Atualizar                      |
| ------------- | ------------------------ | ------------------------------ |
| **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 a deteção automática. As outras integrações de CMS (Builder.io, ContentStack, Contentful, Craft CMS, Framer, HubSpot CMS, Sanity, Strapi, Storyblok) não detetam automaticamente as atualizações de conteúdo. Nos fluxos de trabalho que publicam conteúdo através destas integrações ou de qualquer outra integração não suportada, adicione um [Registar atualização de conteúdo](https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/content-updates/track-content-update.md) passo após o passo do CMS para registar manualmente a atualização de conteúdo.
{% endhint %}

***

## Tipos

| Tipo                  | Significado                                       |
| --------------------- | ------------------------------------------------- |
| **Página publicada**  | Foi criada e publicada uma nova página            |
| **Página atualizada** | O conteúdo de uma página existente foi atualizado |

***

## Associação ao Brand Kit

Para cada atualização de conteúdo, o URL da página tem de corresponder a um domínio configurado no Brand Kit do seu espaço de trabalho. O AirOps verifica automaticamente o domínio do URL face a todos os domínios e URLs de marca do Brand Kit. Não é necessário selecionar manualmente um Brand Kit.

Um URL de página pode corresponder a mais do que um Brand Kit. Se o seu espaço 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 para caminhos, como subcaminhos de localização, 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 abrangido por nenhum Brand Kit específico para caminhos é registado no(s) Brand Kit(s) ao nível do domínio.

Se não for encontrada nenhuma correspondência, a deteção automática ignora silenciosamente a atualização de conteúdo. As origens manuais (passo Registar atualização de conteúdo, API, MCP) devolvem um erro para que possa corrigir o URL.

***

## Painel de atualizações de conteúdo

**Insights → No site → 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 no intervalo de datas selecionado. Cada tipo tem a sua própria linha, para que possa ver de relance o ritmo de publicação e a frequência das atualizações.

### Histórico de atualizações de conteúdo

Uma tabela ordenável e filtrável com as seguintes colunas:

| Coluna        | Descrição                                                                 |
| ------------- | ------------------------------------------------------------------------- |
| **Tipo**      | Página publicada ou Página atualizada                                     |
| **Origem**    | Origem da atualização: Automática, API, MCP ou Fluxos de trabalho e 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 de chave-valor com contexto adicional                               |

Use a caixa de pesquisa para encontrar atualizações por URL. Filtre **Origem** por **Automático**, **API**, **MCP**, ou **Fluxos de trabalho e grelhas**. Escolha «Automático» para rever as alterações detetadas automaticamente.

Quando a deteção de alterações estiver disponível, adicione um filtro de **Categoria** para selecionar uma ou mais categorias de alterações: **Esquema**, **Metadados**, **Títulos**, **Conteúdo**, ou **Estrutura**. As categorias descrevem alterações em páginas existentes. O filtro restringe as atualizações correspondentes; **Páginas criadas** não apresenta qualquer valor enquanto um filtro de categoria estiver ativo, porque as categorias não se aplicam a páginas novas.

É possível selecionar e eliminar vários itens de uma só vez para facilitar a limpeza.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-1a2f8e537ef8a800895694d7aabb6a7d1d2ab824%2Fcontent-updates-01-dashboard.png?alt=media" alt="Content Updates dashboard with an updates-over-time chart and history of published and refreshed spaceops.io pages"><figcaption><p>Acompanhe todas as publicações e atualizações de páginas num só lugar.</p></figcaption></figure>

***

## Atualizações de conteúdo na vista de detalhes da página

Ao consultar a vista de detalhes de uma página, um cartão de **Atualizações de conteúdo relacionadas** aparece na parte inferior, mostrando todas as atualizações de conteúdo cujo URL corresponde ao dessa página. Assim, tem uma cronologia de todas as publicações e atualizações dessa página específica, com colunas para o tipo, a origem, a data e os metadados.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-fd444719bec4817c8261ed53668de33ff05d8c7c%2Fcontent-updates-02-page-detail.png?alt=media" alt="Page detail view with content update markers on the citation rate chart"><figcaption><p>As atualizações de conteúdo aparecem nos gráficos da página.</p></figcaption></figure>

***

## Última atualização e páginas desatualizadas

A [tabela Páginas](https://docs.airops.com/docs/pt/insights/onsite/pages.md) inclui uma coluna **Última atualização** que indica há quanto tempo foi registada a atualização de conteúdo mais recente de cada página (por exemplo, «há 6 meses»). Esta coluna só fica visível quando está ativo um filtro de páginas desatualizadas.

Use o filtro inteligente **Páginas desatualizadas** para mostrar as páginas cuja atualização de conteúdo mais recente foi há mais de 6 meses. Também estão disponíveis outras opções de filtro: há 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 são incluídas nos resultados filtrados. Combine o filtro «Páginas desatualizadas» com «Oportunidades de atualização» para dar prioridade às páginas a atualizar primeiro, com base no impacto na visibilidade.

***

## Metadados das atualizações de conteúdo

Cada atualização de conteúdo pode incluir metadados, ou seja, pares de chave-valor que fornecem contexto adicional sobre a atualização.

### Metadados do sistema

Anexados automaticamente a cada atualização de conteúdo:

| Chave                            | Descrição                                                                |
| -------------------------------- | ------------------------------------------------------------------------ |
| `airops_app_id`                  | O ID do fluxo de trabalho que gerou a atualização de conteúdo            |
| `airops_app_type`                | O tipo de aplicação AirOps (por exemplo, fluxo de trabalho)              |
| `airops_execution_id`            | O ID da execução do fluxo de trabalho                                    |
| `airops_integration_page_status` | O estado da página indicado pelo CMS (por exemplo, `published`, `draft`) |
| `airops_grid_table_id`           | O ID da tabela Grid (para atualizações de conteúdo exportado do Grid)    |

### Atributos personalizados

Pode adicionar os seus próprios pares de chave-valor (até 20 por atualização de conteúdo) ao utilizar o passo Track Content Update, a API ou o MCP. No passo Track Content Update, tanto as chaves como os valores são compatíveis com [modelos Liquid](https://docs.airops.com/docs/pt/acoes/workflow-concepts/liquid-template.md).

***

## Acesso programático

Crie, liste e obtenha atualizações de conteúdo programaticamente através da [API Content Updates](https://docs.airops.com/api-reference/endpoints/brand-kits/content-updates). As atualizações de conteúdo criadas através da API têm a origem `api`. O URL tem de corresponder a um domínio do Brand Kit no seu espaço de trabalho.

As ferramentas MCP `track_aeo_page_content_update` e `list_aeo_page_content_updates` oferecem as mesmas funcionalidades 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=<question>&goal=<user_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.
