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

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

Λειτουργίες
Σύνδεσμος συν ομιλίας
Η απάντηση δίνει τον σύνδεσμο που ανοίγει τη συνομιλία στο 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 | Το αναγνωριστικό της συνομιλίας. Ο ίδιος πελάτης στο ίδιο κανάλι παίρνει πάντα την ίδια συνομιλία. |
isOldUser | false όταν ο πελάτης δημιουργήθηκε από αυτή την κλήση. |
Σφάλματα
Μια αποτυχημένη κλήση απαντά με κατάσταση σφάλματος και ένα μήνυμα:
| Μήνυμα | Αιτία |
|---|---|
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 δεν είναι έγκυρο. |
Στιγμιότυπα οθόνης
Ένα CRM, ένα help desk και μια οθόνη διαχείρισης παραγγελιών ανοίγουν η καθεμία τη σωστή συνομιλία στο MonoChat
Ανάθεση της συνομιλίας σε εκπρόσωπο ή ομάδα εργασίας στην ίδια κλήση API
Ένας νέος πελάτης και μια νέα συνομιλία δημιουργούνται αυτόματα από το αίτημα API
Μία κλήση API επιστρέφει τον σύνδεσμο της συνομιλίας
Ένα κουμπί «Chat on WhatsApp» σε ένα CRM ανοίγει τη συνομιλία του πελάτη με ένα κλικ
Η νέα κλήση του API για τον ίδιο πελάτη ανοίγει την υπάρχουσα συνομιλίαΣυχνές ερωτήσεις
Στέλνει το Session Link μήνυμα στον πελάτη;
Όχι. Ανοίγει ή δημιουργεί μόνο τη συνομιλία και επιστρέφει έναν σύνδεσμο προς αυτήν. Για να γράψετε πρώτοι στον πελάτη, χρησιμοποιήστε την εφαρμογή WhatsApp Template API.
Με ποια κανάλια λειτουργεί;
WhatsApp, Instagram και τα άλλα κανάλια που είναι συνδεδεμένα στον χώρο εργασίας σας στο MonoChat. Ονομάζετε στο αίτημα τον τύπο καναλιού και το όνομα χρήστη του καναλιού σας.
Θα δημιουργήσει διπλές συνομιλίες;
Όχι. Ο ίδιος πελάτης στο ίδιο κανάλι παίρνει πάντα την ίδια συνομιλία.
Ποιος μπορεί να ανοίξει τον σύνδεσμο;
Άτομα που έχουν συνδεθεί στο MonoChat και επιτρέπεται να βλέπουν τη συγκεκριμένη συνομι λία.