API и уебхукове

1. В MeetingIQ създайте API токен в Einstellungen → API & Webhooks (Настройки → API и уебхукове). От съображения за сигурност той се показва само веднъж.
2. Изпращайте заявки към REST API или въведете URL адрес на уебхук, към който да изпращаме всяка завършена среща.
3. Готово. За Make, Zapier или n8n ви е нужен само генерираният там URL адрес на уебхука.

Всички крайни точки са само за четене, връщат JSON и очакват токена в заглавкатаAuthorization: Bearer miq_…Лимит: 120 заявки на минута за токен.

Пример

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

Отговор

{
  "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": "…" }
  }
}

Щом една среща бъде напълно обработена, изпращаме пълния резултат към вашия URL адрес чрез POST, в същата структура като API. Неуспешните доставки се повтарят автоматично, а всяка доставка може да се види заедно със статуса си в интерфейса.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (ID на тази доставка)
X-MeetingIQ-Signature: sha256=…         (HMAC върху необработеното тяло)

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

Проверка на подписа (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"])
);

За това не ви е нужна допълнителна интеграция. И трите приемат общ входящ уебхук:

• Make: създайте модул „Custom Webhook“ и копирайте генерирания URL адрес.
• Zapier: „Webhooks by Zapier“ → тригер „Catch Hook“.
• n8n: възел Webhook, използвайте продукционния URL адрес.

Въведете URL адреса в MeetingIQ в Einstellungen → API & Webhooks (Настройки → API и уебхукове). С щракване върху „Testen“ (Тест) веднага се изпраща тестова доставка, така че можете да изградите съпоставянето на полетата, без да чакате следващата среща.

Обработката и съхранението се извършват изключително в ЕС. Токените се съхраняват само като хеш, могат да бъдат отменени по всяко време, а всяка доставка на уебхук е подписана. Извличането чрез API може да се проследи в одитния журнал. Подробности ще намерите в нашия център за поверителност и в договора за обработване на данни (и двата на немски).