Ο οδηγός Mokapen

Jamie

Η ενσωμάτωση Jamie φέρνει αυτόματα στο Mokapen απομαγνητοφωνήσεις συσκέψεων και σημειώσεις AI από το meetjamie.ai. Όταν μια σύσκεψη επεξεργαστεί στο Jamie, το Mokapen μπορεί να δημιουργήσει ένα έγγραφο, μια σημείωση ή να κρατήσει μόνο έναν ελαφρύ δείκτη και — όταν είναι δυνατό — να συνδέσει το αποτέλεσμα με το αντίστοιχο ραντεβού που υπάρχει ήδη στο ημερολόγιό σας.

Το Jamie είναι ένα AI note taker με προτεραιότητα στην ιδιωτικότητα που λειτουργεί χωρίς bot στη σύσκεψη. Αυτή η ενσωμάτωση απευθύνεται σε ομάδες πωλήσεων και customer success που ήδη καταγράφουν με το Jamie και θέλουν το αποτέλεσμα (περίληψη, ενέργειες, πλήρης διάλογος) δίπλα στο ραντεβού CRM.

Γενική επισκόπηση ενσωματώσεων: Ενσωματώσεις.

Απαιτήσεις

• Πλάνο Mokapen που περιλαμβάνει την ενσωμάτωση Jamie (Premium — εικονίδιο μεταλλίου στη σελίδα αν δεν είναι διαθέσιμη στο πλάνο σας).
• Λογαριασμός Jamie σε πλάνο Pro / Team / Enterprise (ή επιλέξιμο) με δικαίωμα δημιουργίας κλειδιών API και webhooks.
• Προαιρετικό αλλά προτεινόμενο: Google Calendar ή Outlook Calendar συγχρονισμένο με το Mokapen, ώστε τα ραντεβού να αντιστοιχίζονται με το id συμβάντος ημερολογίου.

Σύνδεση

Το Jamie συνδέεται με κλειδί API (χωρίς OAuth). Επικολλάτε το κλειδί μία φορά στο Mokapen και στη συνέχεια ρυθμίζετε το webhook που ειδοποιεί το Mokapen όταν μια σύσκεψη είναι έτοιμη.

1. Μενού χρήστη → Integrations → Jamie.
2. Κάντε κλικ στο Sync / Connect (απαιτείται κατάλληλο πλάνο Premium).
3. Δημιουργήστε κλειδί API στο Jamie: Settings → Developers → API Keys (τεκμηρίωση για developers). Χρησιμοποιήστε προσωπικό (/v1/me) ή workspace (/v1/workspace) κλειδί.
4. Επικολλήστε το κλειδί στο Mokapen και επιβεβαιώστε το Connect.
5. Όταν η σύνδεση επιτύχει, η σελίδα εμφανίζει τη σύνδεση και ξεκλειδώνει τις ρυθμίσεις webhook και αποθήκευσης.

Webhook

Μετά τη σύνδεση του κλειδιού API, η σελίδα Integrations → Jamie εμφανίζει ένα URL webhook για αντιγραφή. Στο Jamie μεταβείτε στα Settings → Integrations → Webhooks, δημιουργήστε webhook, επικολλήστε το URL του Mokapen και εγγραφείτε στο meeting.completed.

Επιλέξτε έλεγχο ταυτότητας στο Jamie:

• API key (προτεινόμενο) — το Jamie στέλνει το μυστικό στο x-jamie-api-key (ή σε προσαρμοσμένη κεφαλίδα). Επικολλήστε το ίδιο μυστικό στο Mokapen στο πεδίο Webhook secret.
• Signature — το Jamie υπογράφει με HMAC-SHA256 στο x-jamie-signature. Επικολλήστε το μυστικό υπογραφής στο Mokapen.

Πατήστε Save στη σελίδα Mokapen μετά την αλλαγή του webhook secret ή των επιλογών αποθήκευσης.

Ρυθμίσεις αποθήκευσης

Ακόμα στη σελίδα Integrations → Jamie, επιλέξτε πώς αποθηκεύεται κάθε επεξεργασμένη σύσκεψη στο Mokapen:

• Document — δημιουργεί έγγραφο με το περιεχόμενο της σύσκεψης (ιδανικό για μεγάλες απομαγνητοφωνήσεις).
• Note — δημιουργεί σημείωση συνδεδεμένη με το αντιστοιχισμένο ραντεβού όταν είναι δυνατό.
• URL — αποθηκεύει ελαφρύ δείκτη χωρίς εισαγωγή του πλήρους κειμένου.

Μπορείτε επίσης να ενεργοποιήσετε ή να απενεργοποιήσετε τη συμπερίληψη της περίληψης (και των ενεργειών) και της απομαγνητοφώνησης.

Αντιστοίχιση ραντεβού

Όταν φτάσει μια απομαγνητοφώνηση, το Mokapen προσπαθεί να την συνδέσει με υπάρχον ραντεβού χρησιμοποιώντας το externalId του συμβάντος ημερολογίου από το Jamie (αναγνωριστικά συγχρονισμού Google Calendar ή Outlook Calendar ήδη αποθηκευμένα στο Mokapen).

Αν κανένα ραντεβού δεν ταιριάζει, το έγγραφο ή η σημείωση δημιουργείται ούτως ή άλλως — απλώς δεν συνδέεται με συμβάν ημερολογίου.

Κοινή χρήση με συναδέλφους

Όπως και στις άλλες ενσωματώσεις Mokapen, μπορείτε να μοιραστείτε τη σύνδεση Jamie με επιλεγμένους συναδέλφους ή ολόκληρο τον οργανισμό από τα στοιχεία ελέγχου κοινής χρήσης συγχρονισμού στη σελίδα ρυθμίσεων.

Τι συμβαίνει μετά από μια σύσκεψη

1. Το Jamie ολοκληρώνει την επεξεργασία και στέλνει meeting.completed (το payload περιλαμβάνει περίληψη, απομαγνητοφώνηση και εργασίες).
2. Το Mokapen λαμβάνει το payload, προαιρετικά επαληθεύει το κλειδί API ή την υπογραφή HMAC και βάζει μια εργασία παρασκηνίου στην ουρά.
3. Η εργασία χρησιμοποιεί το περιεχόμενο του webhook (και μπορεί να καταφύγει στο Jamie API meetings.get όταν χρειάζεται), εφαρμόζει τις επιλογές αποθήκευσης και δημιουργεί το έγγραφο/σημείωση.
4. Αν βρεθεί αντιστοίχιση ραντεβού, το νέο στοιχείο συνδέεται με αυτό το ραντεβού.
5. Διπλότυπες παραδόσεις για την ίδια σύσκεψη αγνοούνται μέσω αποδιπλοποίησης συγχρονισμού.

Συχνά προβλήματα

• Δεν εμφανίζεται τίποτα μετά από κλήση — ελέγξτε ότι το URL webhook έχει επικολληθεί σωστά στο Jamie, ότι το συμβάν είναι meeting.completed, ότι η ενσωμάτωση είναι ακόμα συνδεδεμένη και ότι το πλάνο Premium περιλαμβάνει αυτή την εφαρμογή. Βεβαιωθείτε επίσης ότι ο worker ουράς εκτελείται.
• Δημιουργήθηκε έγγραφο αλλά όχι στο ραντεβού — το externalId ημερολογίου δεν ταίριαξε. Κρατήστε ενεργό τον συγχρονισμό ημερολογίου για την πιο αξιόπιστη αντιστοίχιση.
• Απόρριψη webhook / σφάλματα υπογραφής — το μυστικό στο Mokapen πρέπει να ταιριάζει ακριβώς με ό,τι δείχνει το Jamie κατά τη δημιουργία του webhook· αναδημιουργήστε και στις δύο πλευρές αν δεν είστε βέβαιοι.
• Αποθηκεύεται μόνο σύντομη εγγραφή — ελέγξτε το Save as και τα πλαίσια επιλογής περίληψης/απομαγνητοφώνησης· η λειτουργία URL παραλείπει σκόπιμα το πλήρες κείμενο.
• Μη έγκυρο κλειδί API — αναδημιουργήστε το κλειδί στο Jamie (Settings → Developers → API Keys) και συνδεθείτε ξανά. Η πρόσβαση API απαιτεί επιλέξιμο πλάνο Jamie.

Αποσύνδεση

Χρησιμοποιήστε το Disconnect στη σελίδα Integrations → Jamie (διαθέσιμο στον χρήστη που συνέδεσε την ενσωμάτωση). Αφαιρέστε ή απενεργοποιήστε επίσης το webhook στο Jamie αν δεν θέλετε πλέον παραδόσεις.

Τα έγγραφα και οι σημειώσεις που έχουν ήδη δημιουργηθεί παραμένουν στο Mokapen· η αποσύνδεση σταματά μόνο την άφιξη νέων απομαγνητοφωνήσεων.

Συχνές ερωτήσεις

Q: Το Mokapen συμμετέχει στη σύσκεψη ως bot;

A: Όχι. Το Jamie καταγράφει χωρίς bot· το Mokapen λαμβάνει μόνο τις επεξεργασμένες σημειώσεις μέσω webhook/API.

Q: Προσωπικό ή workspace κλειδί API;

A: Λειτουργούν και τα δύο. Το Mokapen εντοπίζει το εύρος κατά τη σύνδεση. Χρησιμοποιήστε workspace κλειδί αν χρειάζεστε συσκέψεις από ολόκληρο το Jamie workspace.

Q: Πού βρίσκεται η επίσημη τεκμηρίωση Jamie;

A: API και Webhooks.