Μετάβαση στο κύριο περιεχόμενο

Session Link

Session Link icon
Developer API

Λάβετε έναν άμεσο σύνδεσμο προς τη συνομιλία ενός πελάτη από τα δικά σας συστήματα· ο πελάτης και η συνομιλία δημιουργούνται αν δεν υπάρχουν ακόμη.

  • WhatsApp
  • Instagram
  • REST API

Επισκόπηση​

Μία κλήση API με ένα κανάλι και τον αριθμό τηλεφώνου ή το e-mail ενός πελάτη επιστρέφει έναν σύνδεσμο που ανοίγει τη συνομιλία του πελάτη στο MonoChat. Αν ο πελάτης ή η συνομιλία δεν υπάρχουν ακόμη, δημιουργούνται.

Βάλτε τον σύνδεσμο στο CRM, στο help desk ή στην οθόνη παραγγελιών σας και η ομάδα σας μεταβαίνει απευθείας από εκεί στη συνομιλία.

Βασικά σημεία​

  • Άνοιγμα ή δημιουργία. Λειτουργεί για πελάτη σε συγκεκριμένο κανάλι WhatsApp, Instagram ή άλλο, με αριθμό τηλεφώνου ή e-mail.
  • Δρομολόγηση στη διαδρομή. Αναθέστε τη συνομιλία σε εκπρόσωπο, με αναγνωριστικό ή e-mail, ή σε ομάδα εργασίας στην ίδια κλήση.
  • Ίδιος πελάτης, ίδια συνομιλία. Η νέα κλήση για τον ίδιο πελάτη και κανάλι επιστρέφει την υπάρχουσα συνομιλία.

Εγκατάσταση και ρύθμιση​

  1. Εγκαταστήστε το Session Link από το Ρυθμίσεις › MonoStore › Εφαρμογές, ή ανοίξτε τον σύνδεσμο εγκατάστασης app.monochat.ai/apps/vvKJe8Nbp4EQNy2KA. Αν δεν έχετε λογαριασμό MonoChat, ο σύνδεσμος σας επιτρέπει να εγγραφείτε πρώτα και εγκαθιστά την εφαρμογή για εσάς.
  2. Δημιουργήστε ένα API token στο Προφίλ › Tokens API. Το token εμφανίζεται μόνο μία φορά, γι' αυτό αντιγράψτε το αμέσως. Δείτε τα Tokens API.
  3. Ανοίξτε το Ρυθμίσεις › Session Link API. Η τεκμηρίωση εκεί δείχνει την ακριβή διεύθυνση endpoint του χώρου εργασίας σας και έτοιμα προς αντιγραφή παραδείγματα αιτημάτων. Δοκιμάστε το παράδειγμα με ένα από τα κανάλια σας.
  4. Προσθέστε ένα κουμπί «Chat on WhatsApp» στο CRM, στο help desk ή στην οθόνη παραγγελιών σας, που καλεί το API και ανοίγει το url που επιστρέφεται.
σημείωση
  • Ο σύνδεσμος ανοίγει το MonoChat για άτομα που έχουν συνδεθεί και επιτρέπεται να βλέπουν τη συγκεκριμένη συνομιλία.
  • Η κλήση ανοίγει μόνο τη συνομιλία· δεν στέλνει μήνυμα στον πελάτη. Χρησιμοποιήστε το WhatsApp Template API για να γράψετε πρώτοι.

Οθόνη προς οθόνη​

Το Session Link έχει μία οθόνη: την τεκμηρίωσή του στο Ρυθμίσεις › Session Link API. Όλα τα υπόλοιπα γίνονται μέσω του API.

Εγκατάσταση​

Κάντε κλικ στο Εγκατάσταση στο πάνελ Προεπισκόπηση εφαρμογής MonoStore. Μετά την εγκατάσταση, το Session Link API εμφανίζεται στο μενού Ρυθμίσεις.

Πάνελ Προεπισκόπηση εφαρμογής MonoStore για το Session Link με το κουμπί Εγκατάσταση

Η καρτέλα Τεκμηρίωση περιέχει την αναφορά API για τον χώρο εργασίας σας, σε έξι ενότητες:

  • Introduction: τι κάνει το API (βρίσκει ή δημιουργεί τον πελάτη και τη συνομιλία, προαιρετικά την αναθέτει και επιστρέφει απευθείας σύνδεσμο) και η ακριβής διεύθυνση του endpoint POST του χώρου εργασίας σας, έτοιμη προς αντιγραφή.
  • Authentication: πώς να στείλετε το API token ως Bearer token στην κεφαλίδα Authorization.
  • Request Parameters: κάθε πεδίο του σώματος του αιτήματος και ποια είναι υποχρεωτικά.
  • Examples: έτοιμα προς αντιγραφή παραδείγματα αιτημάτων.
  • Assignment Types: πώς να αναθέσετε τη συνομιλία σε ομάδα εργασίας, σε εκπρόσωπο με αναγνωριστικό ή σε εκπρόσωπο με e-mail.
  • Tips: πρακτικές συμβουλές για τη χρήση του συνδέσμου στα δικά σας συστήματα.

Η ίδια αναφορά υπάρχει σε αυτή τη σελίδα: δείτε Αναφορά API, Πεδία αιτήματος, Παράδειγμα αιτήματος και Σφάλματα.

Τεκμηρίωση Ρυθμίσεις › Session Link API με την εισαγωγή, τη διεύθυνση endpoint του χώρου εργασίας και την ενότητα ταυτοποίησης

Λειτουργίες​

Η απάντηση δίνει τον σύνδεσμο που ανοίγει τη συνομιλία στο MonoChat και το αναγνωριστικό της συνομιλίας.

Δημιουργία πελάτη όταν χρειάζεται​

Ένας νέος πελάτης δημιουργείται με το όνομα και το επώνυμο που στέλνετε· η απάντηση σάς λέει αν ο πελάτης ήταν ήδη γνωστός.

Ανάθεση​

Ανάθεση σε εκπρόσωπο με αναγνωριστικό ή e-mail, ή σε ομάδα εργασίας.

Οθόνη τεκμηρίωσης​

Η αναφορά API με την ακριβή διεύθυνση endpoint του χώρου εργασίας σας και έτοιμα προς αντιγραφή παραδείγματα αιτημάτων.

Αναφορά API​

Η κλήση είναι ένα POST με σώμα JSON, που ταυτοποιείται με ένα API token.

POST https://app.monochat.ai/api/<slug>/custom-functions/<app-folder>/methods/session-link.js
Authorization: Bearer <API_TOKEN>
Content-Type: application/json
  • Το <slug> είναι το tenant slug του χώρου εργασίας σας, το τμήμα μετά το /tenants/ στη διεύθυνσή σας στο MonoChat.
  • Το <app-folder> είναι ο φάκελος στον οποίο εγκαταστάθηκε η εφαρμογή. Η οθόνη Ρυθμίσεις › Session Link API δείχνει την πλήρη διεύθυνση με συμπληρωμένα και τα δύο.
  • Δημιουργήστε το token στο Προφίλ › Tokens API. Δείτε τα Tokens API.

Πεδία αιτήματος​

ΠεδίοΥποχρεωτικόΠεριγραφή
connectorBrandναιΟ τύπος καναλιού, για παράδειγμα whatsapp ή instagram.
channelUsernameναιΤο όνομα χρήστη του καναλιού σας στο MonoChat, για παράδειγμα ο αριθμός WhatsApp σας χωρίς +.
customer.identityTypeναιphoneNumber ή email.
customer.identityναιΟ αριθμός τηλεφώνου του πελάτη (κωδικός χώρας, χωρίς +) ή η διεύθυνση e-mail.
customer.firstname, customer.lastnameόχιΧρησιμοποιούνται όταν ο πελάτης είναι νέος στο MonoChat. Προεπιλογή -.
assignment.typeόχιagent (αναγνωριστικό χρήστη εκπροσώπου), agentIdentity (e-mail εκπροσώπου) ή workgroup (αναγνωριστικό ομάδας εργασίας).
assignment.valueμε το assignment.typeΤο αναγνωριστικό ή το e-mail στο οποίο ανατίθεται η συνομιλία.

Παράδειγμα αιτήματος​

curl --location 'https://app.monochat.ai/api/<slug>/custom-functions/<app-folder>/methods/session-link.js' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_TOKEN>' \
--data '{
"connectorBrand": "whatsapp",
"channelUsername": "905334445566",
"customer": {
"identityType": "phoneNumber",
"identity": "905306667788",
"firstname": "Ayşe",
"lastname": "Yılmaz"
},
"assignment": { "type": "agentIdentity", "value": "sarah@yourcompany.com" }
}'

Απόκριση​

{
"result": {
"url": "https://app.monochat.ai/tenants/<slug>?tab=messages&sessionTab=all&filter=…&_id=<sessionId>",
"sessionId": "Zeii7vpeeFFnsJepZ",
"isOldUser": true
}
}
ΠεδίοΠεριγραφή
urlΑνοίγει τη συνομιλία στο MonoChat.
sessionIdΤο αναγνωριστικό της συνομιλίας. Ο ίδιος πελάτης στο ίδιο κανάλι παίρνει πάντα την ίδια συνομιλία.
isOldUserfalse όταν ο πελάτης δημιουργήθηκε από αυτή την κλήση.

Σφάλματα​

Μια αποτυχημένη κλήση απαντά με κατάσταση σφάλματος και ένα μήνυμα:

ΜήνυμαΑιτία
connectorBrand, channelUsername and customer fields are requiredΛείπει ένα υποχρεωτικό πεδίο ανώτατου επιπέδου.
customer.identityType must be one of: phoneNumber, emailΤο identityType λείπει ή έχει άλλη τιμή.
customer.identity field is requiredΛείπει ο αριθμός τηλεφώνου ή το e-mail του πελάτη.
Channel not foundΔεν υπάρχει κανάλι αυτού του τύπου με αυτό το όνομα χρήστη στον χώρο εργασίας σας.
Customer Channel not foundΟ πελάτης δεν ήταν δυνατό να αντιστοιχιστεί σε ταυτότητα καναλιού.
Agent user not foundΔεν υπάρχει εκπρόσωπος με το e-mail που δόθηκε στο assignment.value.
401Η κεφαλίδα Authorization λείπει ή το token δεν είναι έγκυρο.

Στιγμιότυπα οθόνης​

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

Όχι. Ανοίγει ή δημιουργεί μόνο τη συνομιλία και επιστρέφει έναν σύνδεσμο προς αυτήν. Για να γράψετε πρώτοι στον πελάτη, χρησιμοποιήστε την εφαρμογή WhatsApp Template API.

Με ποια κανάλια λειτουργεί;​

WhatsApp, Instagram και τα άλλα κανάλια που είναι συνδεδεμένα στον χώρο εργασίας σας στο MonoChat. Ονομάζετε στο αίτημα τον τύπο καναλιού και το όνομα χρήστη του καναλιού σας.

Θα δημιουργήσει διπλές συνομιλίες;​

Όχι. Ο ίδιος πελάτης στο ίδιο κανάλι παίρνει πάντα την ίδια συνομιλία.

Άτομα που έχουν συνδεθεί στο MonoChat και επιτρέπεται να βλέπουν τη συγκεκριμένη συνομιλία.