API e webhooks

1. No MeetingIQ, crie um token de API em Einstellungen → API & Webhooks (Definições → API e webhooks). Por razões de segurança, só é mostrado uma vez.
2. Consulte a API REST ou introduza um URL de webhook para o qual enviamos cada reunião concluída.
3. Pronto. Para Make, Zapier ou n8n, basta o URL de webhook gerado nessa ferramenta.

Todos os endpoints são só de leitura, devolvem JSON e esperam o token no cabeçalhoAuthorization: Bearer miq_…Limite: 120 pedidos por minuto por token.

Exemplo

curl -H "Authorization: Bearer miq_..." \
  "https://meetingiq.de/api/v1/meetings?status=completed&limit=10"

Resposta

{
  "data": {
    "id": "6165b3df-…", "title": "Jour Fixe Vertrieb", "status": "completed",
    "language": "de", "durationSec": 2984,
    "summaryShort": "…", "summary": "…",
    "keyPoints": ["…"], "decisions": ["…"],
    "participants": [{ "name": "Anna Beispiel", "email": "anna@firma.de" }],
    "tasks": [{ "title": "Angebot nachfassen", "assignee": { "name": "Anna" },
                "dueDate": null, "status": "open" }],
    "links": { "self": "…", "transcript": "…", "app": "…" }
  }
}

Assim que uma reunião estiver totalmente processada, enviamos o resultado completo para o seu URL por POST, com a mesma estrutura da API. As entregas falhadas são repetidas automaticamente, e cada entrega pode ser consultada com o respetivo estado na interface.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (ID desta entrega)
X-MeetingIQ-Signature: sha256=…         (HMAC sobre o corpo em bruto)

{ "event": "meeting.completed", "timestamp": "…", "data": { …Meeting… } }

Verificar a assinatura (Node.js)

const expected = "sha256=" + crypto
  .createHmac("sha256", SIGNING_SECRET)
  .update(rawBody)
  .digest("hex");

crypto.timingSafeEqual(
  Buffer.from(expected),
  Buffer.from(req.headers["x-meetingiq-signature"])
);

Não precisa de uma integração adicional. As três ferramentas aceitam um webhook de entrada genérico:

• Make: crie um módulo «Custom Webhook» e copie o URL gerado.
• Zapier: «Webhooks by Zapier» → acionador «Catch Hook».
• n8n: nó Webhook, utilize o URL de produção.

Introduza o URL no MeetingIQ em Einstellungen → API & Webhooks (Definições → API e webhooks). Um clique em «Testen» (Testar) envia de imediato uma entrega de teste, para que possa criar o mapeamento de campos sem esperar pela próxima reunião.

O tratamento e o armazenamento são feitos exclusivamente na UE. Os tokens são guardados apenas como hash, podem ser revogados a qualquer momento, e cada entrega de webhook é assinada. Os acessos através da API ficam rastreáveis no registo de auditoria. Mais pormenores no nosso centro de privacidade e no acordo de tratamento de dados (ambos em alemão).