# Webhook

A seção **Integrações** permite ao administrador conectar o Power ATA a sistemas externos, recebendo notificações e eventos da plataforma em tempo real. Atualmente, a integração disponível é via **Webhook**.

<figure><img src="/files/AGssuDFBwwG5i6M1p3H7" alt=""><figcaption></figcaption></figure>

***

## Integração Webhook

O Webhook permite que o Power ATA envie notificações automáticas para um endpoint externo sempre que eventos relevantes ocorrerem na plataforma, como o processamento de uma nova reunião ou a geração de uma ATA.

As notificações são enviadas via requisições **HTTP POST** em tempo real para a URL configurada.

### Como Configurar

{% stepper %}
{% step %}
Acesse **Configurações** no menu lateral e clique em **Integrações**.
{% endstep %}

{% step %}
Informe a **URL do Webhook**, que é o endereço do endpoint externo que irá receber as notificações (ex: `https://seu-dominio.com/webhook`).
{% endstep %}

{% step %}
Defina um **Secret** com no mínimo 8 caracteres. Esse valor é utilizado para assinar e validar a autenticidade de cada requisição recebida.
{% endstep %}

{% step %}
Clique em **Salvar configurações**.
{% endstep %}
{% endstepper %}

***

## Campos de Configuração

| Campo              | Descrição                                                                                          |
| ------------------ | -------------------------------------------------------------------------------------------------- |
| **URL do Webhook** | Endereço do endpoint que receberá as requisições HTTP POST com os eventos da plataforma            |
| **Secret**         | Chave secreta usada para assinar e validar a autenticidade das requisições. Mínimo de 8 caracteres |

**Payload enviado pelo Webhook**

Após a conclusão do processamento de uma reunião, o Power ATA realiza uma requisição HTTP POST para a URL configurada na tela de Integrações caso exista, enviando o seguinte JSON no corpo da requisição:

```
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "title": "Reunião de Planejamento Sprint 42",
  "content": "Nesta reunião foram discutidos os itens do backlog priorizados para a próxima sprint, incluindo melhorias no módulo de relatórios e correções de bugs críticos.",
  "shortDescription": "Planejamento da Sprint 42 com definição de escopo e prioridades.",
  "subject": "Sprint Planning - Março 2026",
  "participants": [
    {
      "displayName": "Carlos",
      "email": "carlos@empresa.com"
    },
    {
      "displayName": "Ana Silva",
      "email": "ana.silva@empresa.com"
    },
    {
      "displayName": null,
      "email": "convidado.externo@parceiro.com"
    }
  ]
}
```

***

**Descrição de cada campo**

| Campo                        | Tipo             | Descrição                                                                                                       |
| ---------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------------- |
| `id`                         | `string (UUID)`  | Identificador único da reunião no Power ATA                                                                     |
| `title`                      | `string`         | Título da reunião conforme registrado no Teams                                                                  |
| `content`                    | `string`         | Conteúdo completo da ATA gerada pela IA                                                                         |
| `shortDescription`           | `string`         | Resumo curto da reunião, gerado automaticamente                                                                 |
| `subject`                    | `string`         | Assunto da reunião conforme definido no convite do calendário                                                   |
| `participants`               | `array`          | Lista de participantes identificados na reunião                                                                 |
| `participants[].displayName` | `string \| null` | Nome de exibição do participante. Pode ser `null` quando o participante é externo e não tem perfil identificado |
| `participants[].email`       | `string`         | E-mail do participante                                                                                          |

***

**Pontos de atenção**

* O campo `displayName` pode retornar `null` para participantes externos que não possuem perfil reconhecido no ambiente da organização. Sistemas que consomem esse webhook devem tratar esse cenário.
* O campo `content` traz o texto completo da ATA, podendo ser extenso dependendo da duração da reunião.
* A notificação é enviada via HTTP POST ao final do processamento da reunião. Caso o servidor de destino retorne um status code entre **200 e 299**, a entrega é considerada bem-sucedida. Em caso de falha (qualquer status fora dessa faixa ou ausência de resposta), o Power ATA realizará automaticamente novas tentativas. Por padrão são **5 tentativas adicionais.**

  &#x20;

***

## Segurança

{% hint style="warning" %}
Mantenha o **Secret sempre em sigilo**. Ele é o mecanismo de segurança que garante que apenas requisições legítimas enviadas pelo Power ATA sejam aceitas pelo seu sistema. Nunca compartilhe esse valor em logs, prints ou ambientes não seguros.
{% endhint %}

> Se o Secret for comprometido, reconfigure imediatamente um novo valor e atualize as configurações nos sistemas que consomem o Webhook.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://azbr.gitbook.io/power-ata/webhook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.