> 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/acoes/workflow-concepts/workflow-steps/openai-ads.md).

# OpenAI Ads

Crie, edite e arquive recursos de anúncios da OpenAI com os Workflow Steps ativados.

Os OpenAI Ads Steps permitem que um Workflow crie e gerencie campanhas de anúncios, grupos de anúncios e anúncios do ChatGPT. Encadeie Steps para construir a hierarquia da conta e carregue imagens criativas antes de criar anúncios.

{% hint style="info" %}
As ações do OpenAI Ads Workflow exigem ativação separada no workspace e uma conta do ChatGPT Ads conectada. Entre em contato com a sua equipe da AirOps se a integração não estiver disponível no seletor de Steps.
{% endhint %}

## Como Configurar

1. Adicione uma **OpenAI Ads** Adicione um Step ao seu Workflow e escolha uma ação.
2. Selecione a autenticação do OpenAI Ads. Use uma chave criada em [Gestor de Anúncios do ChatGPT](https://docs.airops.com/docs/pt/insights/analytics/settings/chatgpt-ads-manager.md).
3. Teste a conexão. Uma chave válida ainda pode exigir análise da conta antes de ela ficar pronta para anunciar.
4. Selecione um recurso pai existente ou, para uma ação de criação, referencie o pai criado por um Step anterior.
5. Configure os inputs da ação. Escolha **Pausado** ao preparar recursos para revisão antes da entrega.
6. Execute o Workflow e inspecione os detalhes do recurso retornado e o status de revisão do anúncio.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-9ff2439b819ed119039867ffe808d8f04f368476%2Fopenai-ads-01-create-campaign.png?alt=media" alt="OpenAI Ads step set to Create Campaign with a SpaceOps authentication, budget, and Paused status"><figcaption><p>Crie recursos de anúncios como Pausado para que você possa revisá-los primeiro.</p></figcaption></figure>

## Ações e parâmetros

| Ação                                  | Principais inputs                                                                                                                            |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Criar Campanha**                    | Nome, status explícito, objetivo, tipo e valor do orçamento, e quaisquer configurações de agendamento ou segmentação                         |
| **Editar Campanha**                   | Seleção da campanha e os campos a atualizar                                                                                                  |
| **Arquivar Campanha**                 | Seleção da campanha                                                                                                                          |
| **Criar Grupo de Anúncios**           | Campanha existente ou ID/referência da campanha, nome do grupo, lance máximo, status e dicas de contexto                                     |
| **Editar Grupo de Anúncios**          | Seleções de campanha e grupo de anúncios, além dos campos a atualizar                                                                        |
| **Arquivar Grupo de Anúncios**        | Seleções de campanha e grupo de anúncios                                                                                                     |
| **Fazer upload da imagem do anúncio** | URL pública que aponta diretamente para uma imagem                                                                                           |
| **Criar Anúncio**                     | Grupo de anúncios existente ou ID/referência do grupo de anúncios, nome, status, título, texto, URL de destino e File ID da imagem carregada |
| **Editar Anúncio**                    | Seleções de campanha, grupo de anúncios e anúncio, além dos campos a atualizar                                                               |
| **Arquivar Anúncio**                  | Seleções de campanha, grupo de anúncios e anúncio                                                                                            |

Insira os valores de orçamento e lance na moeda da conta de anúncios. Use os inputs de data e hora para especificar o agendamento e o fuso horário. As dicas de contexto podem ser linhas separadas ou um array JSON de um Step anterior.

**Fazer upload da imagem do anúncio** retorna um `file_id`. Passe esse valor para **Criar Anúncio** para o criativo do cartão de chat. As ações de criar, editar e arquivar retornam a resposta do provedor; as respostas de anúncios incluem `review_status`.

### Reexecutando Steps de criação

Reexecutar o mesmo Step de criação no mesmo Workflow reutiliza sua campanha, grupo de anúncios ou anúncio original, mesmo que você altere os inputs. Use um **Editar** Step para atualizar um recurso existente. Use um Step de criação diferente ou um Workflow diferente quando a intenção for criar um recurso separado.

Um Step de upload de imagem pode retornar um novo `file_id` em uma reexecução. Isso não faz com que o Step de criação seguinte crie um segundo anúncio.

{% hint style="warning" %}
Estes Steps gravam na sua conta de anúncios conectada. Recursos ativos podem veicular anúncios e gastar orçamento. O arquivamento é irreversível. Use status explícitos de pausado e um processo de revisão ao construir um Workflow de criação.
{% endhint %}

## Exemplo

Construa um Workflow com estes Steps:

1. **Criar Campanha** com o objetivo e orçamento desejados, com status **Pausado**.
2. **Criar Grupo de Anúncios** usando o ID da campanha retornado pelo primeiro Step, também **Pausado**.
3. **Fazer upload da imagem do anúncio** usando uma URL pública para o seu criativo aprovado.
4. **Criar Anúncio** usando o ID do grupo de anúncios e o `file_id`, com copy aprovada e URL de destino e status **Pausado**.
5. Revise os recursos e o criativo retornados antes de ativá-los por meio de uma superfície de gerenciamento habilitada.


---

# 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/acoes/workflow-concepts/workflow-steps/openai-ads.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.
