> 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/playbooks/triggers.md).

# Gatilhos de Playbook

Inicie Playbooks automaticamente com triggers de Agenda, Webhook, Monitor e AEO Insight

Os acionadores de Playbook iniciam automaticamente Playbooks publicados. Use-os quando um Playbook tiver de ser executado segundo um horário, responder a um pedido HTTP, monitorizar uma condição ou reagir a um sinal do AirOps ativado.

## Visão geral

Os acionadores executam uma versão selecionada do Playbook e passam os valores de Input configurados para a execução. As execuções acionadas aparecem em **Histórico de execuções**. As execuções que requerem revisão humana também aparecem na Caixa de entrada.

| Acionador              | Como funciona                                                                                                                                                    | Ideal para                                                                                      |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| **Agendamento**        | Executa-se com uma periodicidade recorrente, por exemplo, todas as segundas-feiras às 9:00.                                                                      | Auditorias semanais de conteúdo, verificações periódicas do Brand Kit e relatórios recorrentes. |
| **Webhook**            | Inicia-se quando um sistema externo envia um pedido HTTP para o URL do webhook do Playbook.                                                                      | Eventos de publicação no CMS, envios de formulários e integrações de terceiros.                 |
| **Monitorização**      | Utiliza o Parallel Web Systems para verificar uma consulta de monitorização a cada 12 horas e inicia o Playbook quando a condição é detetada.                    | Alertas da concorrência, monitorização do mercado e monitorização da saúde do conteúdo.         |
| **Informações de AEO** | Inicia-se quando os limites de AEO Insight ativados são atingidos, por exemplo, quando a taxa de menções, a quota de voz ou a taxa de citações sofre alterações. | Atualização programática, resposta à concorrência e lacunas na cobertura de AEO.                |

{% hint style="info" %}
Os acionadores de AEO Insight só estão disponíveis quando ativados para o seu espaço de trabalho.
{% endhint %}

As ações agendadas são desativadas quando um espaço de trabalho passa de um plano pago para o Free. Uma atualização posterior não as reativa automaticamente. Consulte [Ações agendadas após a mudança para o plano Free](https://docs.airops.com/docs/pt/o-seu-espaco-de-trabalho/settings/billing.md#scheduled-actions-after-a-free-downgrade).

## Como configurar

Configure um acionador depois de publicar a versão do Playbook que pretende que os sistemas a jusante executem.

1. Abra o Playbook publicado.
2. Clique em **Adicionar acionador**.
3. Selecione o tipo de acionador.
4. Escolha **Predefinição** ou uma versão fixada do Playbook.
5. Configure as definições do acionador.
6. Defina os valores de Input necessários que devem ser fornecidos pelo acionador.
7. Guarde o acionador.
8. Reveja a primeira sessão acionada em **Histórico de execuções**.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-42e824543f378742c3d7bb7adbe94c6e08bedf14%2Ftriggers-01-add-trigger.png?alt=media" alt="Add Trigger menu on a published Playbook with Schedule, Webhook, Monitor, and AEO Insight"><figcaption><p>Escolha um tipo de acionador para um Playbook publicado.</p></figcaption></figure>

Novo **Agendamento** Por predefinição, os acionadores estão definidos para **quarta-feira às 3:00** no seu fuso horário local. Reveja o dia, a hora e o fuso horário antes de guardar. Os agendamentos existentes mantêm os valores configurados.

No caso dos acionadores de webhook, copie o URL do webhook depois de guardar o acionador. Envie um pedido `POST` para esse URL com o formato de payload abaixo.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-36a24626a1ed2992e15ebfd1d0fd28a6a313d960%2Ftriggers-02-webhook-config.png?alt=media" alt="Playbook Triggers panel with the saved Webhook Trigger URL, a copy button, and Read Docs"><figcaption><p>Copie o URL do webhook depois de guardar um acionador de webhook.</p></figcaption></figure>

## Parâmetros

| Parâmetro               | Aplica-se a          | Descrição                                                                                                                                                          |
| ----------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Tipo de acionador       | Todos os acionadores | A condição que inicia o Playbook, como **Agendamento**, **Webhook**, **Monitor**, ou **AEO Insight**.                                                              |
| Versão                  | Todos os acionadores | A versão do Playbook que o Trigger executa. **Predefinida** segue a versão publicada atual. Uma versão fixada continua a ser executada até a alterar.              |
| Configuração de entrada | Todos os acionadores | Valores que o Trigger transmite para a execução do Playbook. As entradas obrigatórias têm de receber um valor da configuração do Trigger ou do payload do webhook. |
| URL do webhook          | Webhook              | O URL que os sistemas externos chamam para iniciar o Playbook. Copie este URL da configuração do Webhook Trigger.                                                  |
| Corpo do pedido         | Webhook              | Corpo JSON que contém um `inputs` objeto com os nomes das variáveis de entrada do Playbook como chaves.                                                            |

{% hint style="warning" %}
Se uma nova versão do Playbook alterar as entradas, atualize quaisquer mapeamentos de colunas do Grid e a configuração de entradas do Trigger antes de executar em grande escala. As novas entradas obrigatórias sem valores mapeados ou configurados podem fazer com que as execuções falhem na validação ou sejam ignoradas.
{% endhint %}

## Formato do payload do webhook

O corpo do pedido tem de incluir um `inputs` objeto. Cada chave dentro de `inputs` deve corresponder ao nome de uma variável de entrada do Playbook.

Para encontrar ou editar o nome de uma variável de entrada, abra a entrada e clique em **Mostrar definições avançadas**.

```json
{
  "inputs": {
    "value": "overridden value input",
    "non_req": "optional override",
    "non_req_2": "another optional override"
  }
}
```

| Campo                          | Obrigatório        | Descrição                                                                                                                                                                                                                                                                                                   |
| ------------------------------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `inputs`                       | Sim                | Objeto que contém os valores das entradas do Playbook para a execução.                                                                                                                                                                                                                                      |
| `inputs.<input_variable_name>` | Depende da entrada | Valor para uma entrada do Playbook. Utilize o nome da variável de entrada, não o rótulo apresentado. As entradas obrigatórias têm de receber um valor da configuração do Trigger ou do payload do webhook. As entradas opcionais podem ser omitidas, a menos que pretenda substituí-las para esta execução. |

## Gerir Triggers através do MCP

Um agente ligado ao AirOps MCP pode utilizar `list_playbook_triggers`, `create_playbook_trigger`, `update_playbook_trigger`, e `delete_playbook_trigger` para gerir Triggers de Schedule, Webhook, Monitor e AEO Insight. Aplicam-se as mesmas permissões do Playbook e a mesma validação de entradas que na aplicação.

Peça primeiro ao agente que inspecione os Triggers existentes e, em seguida, especifique o tipo de Trigger, as entradas e se deve seguir a versão publicada ou fixar uma versão. Para um Trigger AEO Insight, o parâmetro de configuração é `insight_config`. Estas ferramentas gerem Triggers do Playbook; não gerem Triggers de Workflow ou Grid.

## Exemplos

### Pedido de webhook

Substitua `WEBHOOK_TRIGGER_URL` pelo URL fornecido pela AirOps quando configura o Webhook Trigger.

```bash
curl --request POST \
  --url 'WEBHOOK_TRIGGER_URL' \
  --header 'content-type: application/json' \
  --data '{ 
    "inputs": {
      "value": "overridden value input",
      "non_req": "optional override",
      "non_req_2": "another optional override"
    }
  }'
```


---

# 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/playbooks/triggers.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.
