> 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 do Playbook iniciam automaticamente os Playbooks publicados. Use-os quando um Playbook deva ser executado numa agenda, responder a uma solicitação HTTP, monitorar 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 Entrada configurados para a execução. As execuções acionadas aparecem em **Histórico de execuções**. As execuções que precisam de Revisão Humana também aparecem na Caixa de entrada. | Acionador | Como funciona | Ideal para | | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | | **Agendamento** | Executa-se numa cadência recorrente, como todas as segundas-feiras às 9h. | Auditorias semanais de conteúdo, verificações de atualidade do Brand Kit, relatórios recorrentes. | | **Webhook** | Inicia quando um sistema externo envia um pedido HTTP para o URL do webhook do Playbook. | Eventos de publicação do CMS, submissões de formulários, integrações de terceiros. | | **Monitorização** | Usa 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 competitivos, monitorização de mercado, monitorização da saúde do conteúdo. | | **Insight de AEO** | Inicia quando os limiares ativados do AEO Insight são cumpridos, como alteração na taxa de menções, quota de voz ou taxa de citações. | Atualização programática, resposta competitiva, lacunas de cobertura de AEO. | {% hint style="info" %} Os acionadores do AEO Insight estão disponíveis apenas quando ativados para o seu workspace. {% endhint %} As ações agendadas são desativadas quando um workspace muda de um plano pago para Free. Fazer upgrade depois não as reativa automaticamente. Veja [Ações agendadas após um downgrade para Free](/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 você quer que os sistemas downstream executem. 1. Abra o Playbook publicado. 2. Clique em **Adicionar gatilho**. 3. Selecione o tipo de Acionador. 4. Escolha **Predefinido** ou uma versão fixa do Playbook. 5. Configure as definições do Acionador. 6. Defina quaisquer valores de Entrada necessários que devam vir do Acionador. 7. Salve o Acionador. 8. Revise a primeira Sessão acionada em **Histórico de execuções**. Para Acionadores de Webhook, copie a URL do webhook depois de salvar o Acionador. Envie uma `POST` solicitação para essa URL com o formato de payload abaixo. ## 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**, **Monitorização**, ou **Insight de AEO**. | | Versão | Todos os Acionadores | A versão do Playbook que o Acionador executa. **Predefinido** segue a versão publicada atual. Uma versão fixada continua executando a versão selecionada até que você a altere. | | Configuração de entrada | Todos os Acionadores | Valores que o Acionador passa para a execução do Playbook. As Entradas obrigatórias precisam de um valor da configuração do Acionador ou do payload do webhook. | | URL do Webhook | Webhook | A URL que sistemas externos chamam para iniciar o Playbook. Copie esta URL da configuração do Acionador de Webhook. | | Corpo da solicitação | Webhook | Corpo JSON contendo 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 os Inputs, atualize quaisquer mapeamentos de colunas da Grid e a configuração de Input do Trigger antes de executar em escala. Novos Inputs obrigatórios 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 da solicitação deve incluir um `inputs` objeto. Cada chave dentro de `inputs` deve corresponder a um nome de variável de Entrada do Playbook. Para encontrar ou editar um nome de variável de Entrada, abra a Entrada e clique em **Mostrar definições avançadas**. ```json { "inputs": { "value": "valor de entrada substituído", "non_req": "substituição opcional", "non_req_2": "outra substituição opcional" } } ``` | Campo | Obrigatório | Descrição | | -------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `inputs` | Sim | Objeto contendo os valores de Entrada do Playbook para a execução. | | `inputs.` | Depende da Entrada | Valor para uma Entrada do Playbook. Use o nome da variável de Entrada, não o rótulo exibido. As Entradas obrigatórias precisam de um valor da configuração do Acionador ou do payload do webhook. As Entradas opcionais podem ser omitidas, a menos que você queira substituí-las para a execução. | ## Exemplos ### Solicitação de webhook Substitua `WEBHOOK_TRIGGER_URL` com a URL que a AirOps lhe fornece quando você configura o Acionador de Webhook. ```bash curl --request POST \ --url 'WEBHOOK_TRIGGER_URL' \\ --header 'content-type: application/json' \ --data '{ "inputs": { "value": "valor de entrada substituído", "non_req": "substituição opcional", "non_req_2": "outra substituição opcional" } }' ``` --- # 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=&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.