MeetingIQ
ΣύνδεσηΔοκιμάστε δωρεάν για 14 ημέρες
Για προγραμματιστές

API και webhooks

Μεταφέρετε αυτόματα μεταγραφές, περιλήψεις και εργασίες στα δικά σας συστήματα, μέσω του REST API ή ενός webhook. Χωρίς παράκαμψη μέσω αμερικανικών υπηρεσιών: όλα λειτουργούν στη δική μας υποδομή στην ΕΕ.

Δοκιμάστε δωρεάν για 14 ημέρεςΔείτε τις τιμές

Περιλαμβάνεται από το πακέτο Pro. Η πρόσβαση στο API είναι ήδη ενεργή κατά τη δοκιμή 14 ημερών.

Σύνδεση σε 3 βήματα

  1. Στο MeetingIQ, δημιουργήστε ένα API token στο Einstellungen → API & Webhooks (Ρυθμίσεις → API και webhooks). Για λόγους ασφαλείας εμφανίζεται μόνο μία φορά.
  2. Είτε κάνετε ερωτήματα στο REST API είτε καταχωρίζετε ένα URL webhook, στο οποίο στέλνουμε κάθε σύσκεψη που ολοκληρώνεται.
  3. Αυτό ήταν. Για Make, Zapier ή n8n χρειάζεστε μόνο το URL webhook που δημιουργείται εκεί.

REST API

Όλα τα endpoints είναι μόνο για ανάγνωση, επιστρέφουν JSON και αναμένουν το token στην κεφαλίδαAuthorization: Bearer miq_…Όριο: 120 αιτήματα ανά λεπτό ανά token.

GET/api/v1/meetingsΛίστα, με φιλτράρισμα κατά κατάσταση
GET/api/v1/meetings/{id}Περίληψη, βασικά σημεία, εργασίες
GET/api/v1/meetings/{id}/transcriptΠλήρες κείμενο + τμήματα ανά ομιλητή

Παράδειγμα

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

Webhooks

Μόλις ολοκληρωθεί η επεξεργασία μιας σύσκεψης, στέλνουμε το πλήρες αποτέλεσμα στο 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, Zapier και n8n

Δεν χρειάζεστε επιπλέον ενσωμάτωση για αυτό. Και τα τρία δέχονται ένα γενικό εισερχόμενο webhook:

  • Make: δημιουργήστε μια ενότητα «Custom Webhook» και αντιγράψτε το URL που δημιουργείται.
  • Zapier: «Webhooks by Zapier» → trigger «Catch Hook».
  • n8n: κόμβος Webhook, χρησιμοποιήστε το production URL.

Καταχωρίστε το URL στο MeetingIQ στο Einstellungen → API & Webhooks (Ρυθμίσεις → API και webhooks). Ένα κλικ στο «Testen» (Δοκιμή) στέλνει αμέσως μια δοκιμαστική παράδοση, ώστε να στήσετε την αντιστοίχιση πεδίων χωρίς να περιμένετε την επόμενη σύσκεψη.

Προστασία δεδομένων

Η επεξεργασία και η αποθήκευση γίνονται αποκλειστικά στην ΕΕ. Τα tokens αποθηκεύονται μόνο ως hash, μπορούν να ανακληθούν ανά πάσα στιγμή, και κάθε παράδοση webhook είναι υπογεγραμμένη. Η ανάκτηση μέσω του API είναι ανιχνεύσιμη στο αρχείο ελέγχου. Λεπτομέρειες θα βρείτε στο κέντρο απορρήτου μας και στη σύμβαση επεξεργασίας δεδομένων (και τα δύο στα γερμανικά).

Ερωτήσεις για την ενσωμάτωση;

Πείτε μας σε ποιο σύστημα πρέπει να καταλήγουν τα δεδομένα και θα το ρυθμίσουμε μία φορά μαζί σας.

Δοκιμάστε δωρεάνΕπικοινωνήστε μαζί μας