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.

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

1. Acesse Configurações no menu lateral e clique em Integrações.
2. Informe a URL do Webhook, que é o endereço do endpoint externo que irá receber as notificações (ex: https://seu-dominio.com/webhook).
3. Defina um Secret com no mínimo 8 caracteres. Esse valor é utilizado para assinar e validar a autenticidade de cada requisição recebida.
4. Clique em Salvar configurações.

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.

Segurança

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.

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