JavaScript API Live Chat

Χρησιμοποιήστε το JavaScript API του onWebChat για να προσαρμόσετε το widget chat σας και να αυτοματοποιήσετε workflows. Μπορείτε να μεταβιβάσετε δεδομένα επισκέπτη, να ορίσετε τη γλώσσα του widget, να μεγιστοποιήσετε ή να κρύψετε το widget και άλλα.

Για παράδειγμα, μπορείτε να στείλετε στοιχεία του επισκέπτη στο chat, να ορίσετε τη γλώσσα ανά σελίδα ή να ανοίξετε το widget προγραμματιστικά όταν ένας χρήστης κάνει κλικ σε ένα κουμπί.

Προσθέστε τον κώδικα API αμέσως κάτω από το script του widget chat, όπως φαίνεται στα δεξιά.





    <script type='text/javascript'>
        ... onWebChat widget code ...
    </script>
    <script type='text/javascript'>
        ... API functions goes here ...
    </script>

Ορισμός στοιχείων επισκέπτη

Μπορείτε να ορίσετε στοιχεία επισκέπτη πριν ή κατά τη διάρκεια μιας συνεδρίας chat. Για παράδειγμα, ο ορισμός του ονόματος βοηθά την ομάδα σας να αναγνωρίζει επαφές στη λίστα επισκέπτων.

Χρησιμοποιήστε τις ακόλουθες κλήσεις API για να ορίσετε όνομα, email, τηλέφωνο και σημειώσεις επισκέπτη:



    onWebChat.set("name","John");
    onWebChat.set("email","john@mail.com");
    onWebChat.set("phone","1234567890");
    onWebChat.set("notes","notes for visitor ..");

Λήψη στοιχείων επισκέπτη

Μπορείτε επίσης να ανακτήσετε τα στοιχεία του επισκέπτη που έχουν οριστεί μέσω του API, της φόρμας pre-chat ή από ενημερώσεις των εκπροσώπων.

Καλέστε αυτές τις συναρτήσεις μετά την πλήρη φόρτωση του widget. Παράδειγμα:
onWebChat.set("onWebChatLoaded", function() { console.log("visitor name: " + onWebChat.get("name")); });



    onWebChat.get("name");
    onWebChat.get("email");
    onWebChat.get("phone");
    onWebChat.get("notes");

Ορισμός γλώσσας widget

Ορίστε τη γλώσσα του widget χρησιμοποιώντας τον κωδικό γλώσσας για οποιαδήποτε γλώσσα ενεργοποιημένη στο dashboard σας.

Για παράδειγμα, "el" για ελληνικά, "en" για αγγλικά και "es" για ισπανικά. Αν ένας κωδικός δεν είναι ενεργός, το widget χρησιμοποιεί την προεπιλεγμένη σας γλώσσα. Μπορείτε να ενημερώσετε τη γλώσσα σε Ρυθμίσεις > Γλώσσες.

Διαθέσιμοι κωδικοί γλωσσών:

am ar az be bg bn bs ca cs da de dv dz el en es et fa fi fil fo fr he hi hr ht hu hy id is it ja ka kk kl km ko ky la lb lo lt lv mg mk mn ms mt my ne nl no pl ps pt ro ru rw si sk sl sm so sq sr sv sw tg th ti tk to tr uk ur uz vi zh zh-TW





    onWebChat.set("language","es");

Ορισμός εμφάνισης widget

Μπορείτε να ελέγξετε τις κύριες ρυθμίσεις εμφάνισης του widget:

Χρησιμοποιήστε την παράμετρο max με 0 για ελαχιστοποίηση ή 1 για μεγιστοποίηση του widget.

Για απόκρυψη του widget, χρησιμοποιήστε τη συνάρτηση set με την παράμετρο show και τιμή 0. Χρησιμοποιήστε 1 για να το εμφανίσετε ξανά.





    onWebChat.set("max",1);

    onWebChat.set("show",0);

Ορισμός πληροφοριών σελίδας

Μπορείτε να αντικαταστήσετε το τρέχον URL και τίτλο σελίδας που στέλνονται στο onWebChat:

Χρησιμοποιήστε την παράμετρο pageUrl για να ορίσετε ένα προσαρμοσμένο URL που θα βλέπουν οι εκπρόσωποι στην κονσόλα του chat. Χρήσιμο για single-page εφαρμογές (SPA) ή προσαρμοσμένο routing.

Χρησιμοποιήστε την παράμετρο pageTitle για ορισμό προσαρμοσμένου τίτλου που θα βλέπουν οι agents αντί για τον τίτλο σελίδας του browser.





    onWebChat.set("pageUrl","https://onwebchat.com/newPage");

    onWebChat.set("pageTitle","New title");

Λήψη κατάστασης widget

Για λήψη της κατάστασης του widget onWebChat:

Η συνάρτηση επιστρέφει «online» ή «offline» με βάση την τρέχουσα διαθεσιμότητα του chat σας.

Καλέστε μετά τη φόρτωση του widget. Παράδειγμα:
onWebChat.set("onWebChatLoaded", function() { console.log("chat status: " + onWebChat.get("status")); });






    onWebChat.get("status");

Συναρτήσεις Callback

Μπορείτε να εκτελέσετε συναρτήσεις callback όταν συμβαίνουν συγκεκριμένα events chat:

onClick εκτελείται όταν ο επισκέπτης κάνει κλικ στο widget chat

onMaximize εκτελείται όταν το widget μεγιστοποιείται

onMinimize εκτελείται όταν το widget ελαχιστοποιείται

onTrigger εκτελείται όταν ενεργοποιείται ένα trigger

onStartWriting εκτελείται όταν ο επισκέπτης αρχίζει να πληκτρολογεί

onWebChatLoaded εκτελείται όταν το widget chat ολοκληρώσει τη φόρτωση




    onWebChat.set("onClick",function(){ alert('chat widget is clicked'); });

    onWebChat.set("onMaximize",function(){ alert('chat maximized'); });

    onWebChat.set("onMinimize",function(){ alert('chat maximized'); });

    onWebChat.set("onTrigger",function(){ alert('trigger activated'); });

    onWebChat.set("onStartWriting",function(){ alert('visitor is writing'); });

    onWebChat.set("onWebChatLoaded",function(){ alert('chat widget is loaded'); });

Επιστροφή στο Support