> 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/campaigns/opportunities.md).

# Oportunidades

Reveja oportunidades de Campaign, edite briefs e aja antes de as recomendações expirarem

**Oportunidades** é o separador Campanha onde a sua equipa analisa as ações recomendadas. Cada oportunidade é uma ação proposta, com um resumo e páginas ou prompts de apoio opcionais. Analise o resumo antes de o trabalho passar para **Ação**.

## Fluxo de análise

1. Abra a Campanha.
2. Selecione **Oportunidades**.
3. Gere oportunidades com o Quill ou um **Acionador**. Use **Adicionar mais** para encontrar mais oportunidades, adicionar uma manualmente ou importar um ficheiro CSV. Se a Campanha estiver vazia, use o menu pendente **Encontrar oportunidades** .
4. Aguarde até que a geração termine. Normalmente, demora entre 15 e 30 minutos.
5. Abra um cartão de oportunidade para ler o respetivo resumo, a página-alvo e o contexto de apoio.
6. Edite o resumo se a ação recomendada precisar de instruções mais claras.
7. Analise as páginas ou os prompts de apoio. Todo o contexto de apoio é transferido para a linha Ação quando aceita a oportunidade.
8. Clique em **Aceitar oportunidade** para enviar o trabalho para **Ação**, ou em **Recusar oportunidade** para a excluir.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-90aff33cef25d493bf82bb5d07b55e6034f9fc07%2Fcampaign-opportunities-01-tab.png?alt=media" alt="Campaign Opportunities tab with six new opportunities for SpaceOps pages, two selected for Decline or Take action, and collapsed Expired and Declined groups"><figcaption><p>Analise as novas oportunidades antes de expirarem, ao fim de 14 dias.</p></figcaption></figure>

## Utilização de tarefas para a geração de oportunidades

A geração de oportunidades executa o Playbook de estratégia da Campanha e utiliza tarefas do espaço de trabalho. Quando houver uma estimativa disponível, consulte-a em **Gerar oportunidades**, **Encontrar mais oportunidades**, ou nas definições do acionador da Campanha.

A estimativa baseia-se na utilização média de tarefas das cinco últimas execuções de estratégia concluídas da Campanha. Se não houver execuções anteriores, o AirOps utiliza a média da semana anterior para o mesmo tipo de ação. Não é apresentada qualquer estimativa quando não há dados de comparação. A utilização real pode diferir da estimativa.

## Grupos de oportunidades

| Grupo                   | Conteúdo                                                                                        |
| ----------------------- | ----------------------------------------------------------------------------------------------- |
| **Novas oportunidades** | Recomendações pendentes que a sua equipa ainda não aceitou nem recusou.                         |
| **Expiradas**           | Recomendações cujo prazo de análise terminou. Restaure-as para as analisar e aceitar novamente. |
| **Recusadas**           | Oportunidades que a sua equipa decidiu não prosseguir.                                          |

As oportunidades aceites aparecem em **Ação** e deixam de aparecer em **Oportunidades**. Use **Mostrar tudo** quando um grupo tiver mais oportunidades do que as apresentadas na primeira página. Selecione várias oportunidades novas para as aceitar ou recusar em conjunto, ou use **Aceitar todas** para o grupo de novas oportunidades.

## Expiração das oportunidades

As oportunidades de campanhas pendentes têm um prazo de revisão de 14 dias. Para reconsiderar uma oportunidade, abra **Expiradas** ou **Recusadas** e selecione **Restaurar**. A oportunidade volta para **Novas oportunidades** com um novo prazo de 14 dias, durante o qual pode analisá-la, editá-la e aceitá-la. O restauro preserva a data de criação original.

Quando aceita uma campanha recomendada, as oportunidades iniciais recebem o prazo de revisão a partir do momento da aceitação da campanha.

A expiração é automática; a página atual de **definições da campanha** não permite configurar um período de expiração.

## O que pode analisar

Abra o cartão de uma oportunidade para consultar o briefing completo e o contexto.

| Campo                 | Descrição                                                                                        |
| --------------------- | ------------------------------------------------------------------------------------------------ |
| **Briefing**          | A ação recomendada. Pode editá-la antes de a aceitar.                                            |
| **Página de destino** | Nas campanhas de atualização, a página existente que a ação deve atualizar.                      |
| **Contexto**          | Páginas ou instruções de apoio que devem servir de base à ação e aparecer mais tarde em Medição. |
| **Estado**            | Nova, aceite, recusada ou expirada.                                                              |

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-fc2236957d1d5e653f748726c5fc420a4b1e52df%2Fcampaign-opportunities-02-brief.png?alt=media" alt="Opportunity detail with the brief, a Targeted Page box, Opportunity context listing two prompts, and Decline opportunity and Accept opportunity buttons"><figcaption><p>Analise o briefing e o contexto de apoio antes de aceitar.</p></figcaption></figure>

## Analise o briefing e o contexto

Leia o objetivo da oportunidade e o contexto de apoio e, em seguida, edite o briefing se a ação precisar de instruções mais claras. Aceite ou recuse na mesma vista. Não existe uma etapa separada para selecionar o contexto: ao aceitar, todas as páginas e instruções de apoio são incluídas em **Ação** para execução e Medição.

{% hint style="info" %}
As oportunidades recusadas e expiradas continuam acessíveis nos respetivos grupos. Abra **Ação** para trabalhar com as oportunidades aceites.
{% endhint %}

## Adicionar uma oportunidade manualmente

Utilize **Adicionar oportunidade manualmente** quando já souber qual é a ação e não quiser esperar por uma execução de geração.

1. Abra o separador **Oportunidades** da campanha.
2. Abra **Adicionar mais** e clique em **Adicionar oportunidade manualmente**.
3. Numa campanha de atualização, selecione a **Página** que a oportunidade deve atualizar.
4. Adicionar **Contexto de referência** como prompts ou páginas relacionados. Este contexto está associado à oportunidade e é acompanhado em Medição.
5. Escreva o **Resumo**.
6. Clique em **Adicionar oportunidade**. Selecione **Adicionar mais** se quiser permanecer na janela modal e criar outra.

## Importar oportunidades de CSV

Utilize **Importar CSV** no separador **Oportunidades** da campanha para adicionar uma lista de páginas ou prompts existentes do Kit da marca. A importação de CSV está disponível para campanhas de atualização de páginas e de criação de páginas com um Kit da marca. É necessária permissão para editar a campanha.

1. Abra **Adicionar mais → Importar CSV**, ou selecione **Importar CSV** no menu pendente do estado vazio **Encontrar oportunidades** . Carregue o seu ficheiro ou utilize **Transferir modelo** como exemplo.
2. Numa campanha de atualização, associe **URL da página** à sua coluna de URL. Numa campanha de criação, associe **Prompt** ao texto exato de um prompt existente no Kit da marca da campanha; um URL de referência é opcional.
3. Opcionalmente, associe uma coluna **Resumo** ou introduza um **Resumo partilhado**. Pode importar sem um resumo.
4. Numa campanha de atualização, pode associar opcionalmente **Prompt** a um prompt existente do Kit da marca.
5. Clique em **Pré-visualizar** e reveja as linhas prontas, inválidas e duplicadas. Utilize **Voltar** para corrigir o mapeamento.
6. Clique em **Importar** para criar as oportunidades válidas. Reveja as quantidades criadas e ignoradas antes de fechar.

Utilize o modelo CSV para formatar o seu ficheiro. As campanhas de atualização importam URLs de páginas; as campanhas de criação importam prompts existentes do Kit da marca, com URLs de referência opcionais. Os resumos são opcionais em ambos os casos.

Antes de importar, reveja a pré-visualização para identificar linhas inválidas ou duplicadas. As oportunidades importadas aparecem em **Novas oportunidades**, onde pode revê-las e aceitar o trabalho em **Ação**.

```csv
URL,Resumo
https://example.com/guide,Translate this guide into Spanish
https://example.com/blog,Refresh outdated statistics
```

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-96cfcc3f9556917eaeb3515ea4fc82a04fd384d2%2Fcampaign-opportunities-03-csv-import.png?alt=media" alt="Preview opportunities step of a CSV import, with 18 rows ready, 2 skipped as Invalid or Duplicate, and an Import 18 opportunities button"><figcaption><p>Pré-visualize as linhas válidas, inválidas e duplicadas antes de as importar.</p></figcaption></figure>

### Importações de campanhas sociais

Também pode utilizar **Importar CSV** para respostas no Reddit, publicações em subreddits próprios, parcerias no YouTube e vídeos próprios no YouTube, quando esses tipos de campanha estiverem disponíveis. Transfira o modelo para o tipo de campanha, associe os campos de destino ou título e reveja a pré-visualização antes de importar.

Os prompts são opcionais nestas importações. Quando incluir um prompt, utilize o texto exato de um prompt ativo no Brand Kit. Cada linha válida cria uma oportunidade para revisão; a importação não publica conteúdo nem aceita a oportunidade.

## Estrutura JSON da oportunidade

A estrutura simplificada seguinte descreve uma oportunidade de campanha. É a recomendação que a sua equipa analisa antes de a aceitar em **Ação**.

Um objeto Opportunity contém os seguintes campos:

| Campo                        | Estrutura         | Finalidade                                                                                 |
| ---------------------------- | ----------------- | ------------------------------------------------------------------------------------------ |
| `id`                         | Inteiro           | O ID da oportunidade.                                                                      |
| `name`                       | String            | O nome da ação recomendada.                                                                |
| `description`                | String            | O resumo recomendado. Pode editá-lo durante a revisão.                                     |
| `opportunity_schema_version` | Inteiro           | O identificador do esquema. A estrutura aqui descrita utiliza `2`.                         |
| `status`                     | String            | O estado da revisão, como `pending`, `accepted`, `rejected`, ou `expired`.                 |
| `target_page`                | Objeto ou `null`  | A página a atualizar. É `null` no caso de uma oportunidade de criação de página.           |
| `opportunity_contexts`       | Array             | Páginas ou prompts de apoio, ordenados por `position`.                                     |
| `action_item_id`             | Inteiro ou `null` | O registo Action aceite. É `null` enquanto a oportunidade estiver pendente.                |
| `grid_row_id`                | Inteiro ou `null` | A linha Action criada após a aceitação. É `null` enquanto a oportunidade estiver pendente. |

O objeto `target_page` inclui a página `id`, `url`, e `folder`.

Cada item em `opportunity_contexts` inclui:

* `id`: O ID do contexto.
* `rationale`: Por que o contexto sustenta a oportunidade.
* `position`: A ordem do contexto.
* `resource`: A página ou o prompt de suporte.

Um recurso do tipo prompt inclui o respetivo `type`, `id`, o texto do prompt, o tópico e as etiquetas. Um recurso do tipo página inclui o respetivo `type`, `id`, o URL da página, a pasta e os tópicos.

## O que acontece após a aceitação

As oportunidades aceites aparecem em **Ação** como linhas de ação. Cada linha mantém o resumo que aprovou, a página de destino, quando existe, e todo o contexto de suporte.

As oportunidades recusadas não aparecem em **Ação** para que a campanha continue centrada no trabalho que a sua equipa pretende realizar.

## Exemplos

### Análise da atualização de uma página

Numa campanha de atualização, avalie se existe um motivo claro para alterar a página de destino. Entre as boas candidatas podem estar páginas com uma taxa de citações em queda, informações desatualizadas, pressão da concorrência ou uma lacuna entre a página atual e os prompts a que deveria responder.

Analise os prompts de suporte para confirmar que são adequados à atualização. Aceite a oportunidade quando a sua equipa estiver pronta para atualizar essa página ou recuse-a se a recomendação não for relevante.

### Análise da criação de uma nova página

Numa campanha de criação, avalie se o resumo descreve uma página que a sua equipa pode criar. Entre as boas candidatas podem estar páginas associadas a prompts com elevada intenção, uma cobertura própria insuficiente ou lacunas preenchidas por páginas da concorrência.

Avalie se os prompts de suporte são adequados à nova página. Aceite a oportunidade quando a sua equipa puder criar o conteúdo de suporte ou recuse-a se o conteúdo pertencer a outra campanha.


---

# 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/campaigns/opportunities.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.
