Κανάλια

Κανάλια μηνυμάτων

Η φωνή και η διαδικτυακή συνομιλία μεταφέρουν συνομιλίες σήμερα. Το WhatsApp και το Viber περιλαμβάνονται στο σχέδιο αλλά όχι στην πρώτη κυκλοφορία· το API δηλώνει τη διαφορά αντί να τη διαπιστώσετε δοκιμάζοντας.

Οι διαδρομές, τα ονόματα πεδίων, οι τιμές enum, οι κεφαλίδες και οι κωδικοί σφαλμάτων στα παραδείγματα είναι οι πραγματικοί, ελεγμένοι με την προδιαγραφή του API κατά τη δημιουργία της σελίδας. Τα αναγνωριστικά, ποσά και ονόματα είναι ενδεικτικά. Τα `$WETALK_API_KEY` και `$AGENT` είναι μεταβλητές shell που ορίζετε εσείς.

Τέσσερα μέσα, δύο στοιχεία για το καθένα

Το `availability` αφορά το WeTalk: `open` σημαίνει ότι το μέσο μπορεί να ενεργοποιηθεί, `waitlisted` ότι δεν μπορεί και `waitlist_reason` εξηγεί γιατί. Το `state` αφορά τον χώρο εργασίας σας — αν το έχετε συνδέσει. Η ανάγνωσή τους ως μία τιμή οδηγεί την κονσόλα να προσφέρει κουμπί που δεν λειτουργεί.

voice — διαθέσιμο. Συνδέεται στους Αριθμούς & SIP ή στην καρτέλα Κανάλια του βοηθού, όχι εδώ.
web_chat — διαθέσιμο. Μία ετικέτα script στη δική σας σελίδα.
whatsapp — σε αναμονή διαθεσιμότητας.
viber — σε αναμονή διαθεσιμότητας.

GET /v1/messaging/media

curl https://api.wetalk.io/v1/messaging/media \
  -H "Authorization: Bearer $WETALK_API_KEY"

Σύνδεση μέσου

Η σύνδεση μέσου με βοηθό γίνεται με ένα αίτημα. Απορρίπτεται με `409` για μέσο σε αναμονή και για `voice` — οι αριθμοί και τα SIP trunk ανήκουν στους Αριθμούς & SIP και η σύνδεση αριθμού σε δύο σημεία οδηγεί σε λάθος. Η άρνηση λέει ποια από τις δύο περιπτώσεις ισχύει.

Για διαδικτυακή συνομιλία το αναγνωριστικό σύνδεσης **είναι** το κλειδί του widget. Επικολλάται στη δική σας σελίδα, δεν έχει δικαιώματα και δεν είναι μυστικό — η μόνη ασφαλής μορφή ενός δημόσιου αναγνωριστικού.

POST /v1/messaging/media/{medium_code}/connection

curl https://api.wetalk.io/v1/messaging/media/web_chat/connection \
  -X POST \
  -H "Authorization: Bearer $WETALK_API_KEY"
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 0199f1c2-6b46-7b58-9299-7e5f0a81c376" \
  -d '{
    "voice_agent_id": "0199f1c2-6b40-7a11-9d3e-6c1b5f0a2e77"
  }'

201 Created

{
  "data": {
    "channel_binding_id": "0199f1c2-6b47-7c69-83aa-8f601b92d487",
    "medium": "web_chat",
    "voice_agent_name": "Roma orders",
    "widget": {
      "widget_key": "0199f1c2-6b47-7c69-83aa-8f601b92d487",
      "script_path": "/v1/widget/chat.js"
    }
  }
}

Απενεργοποίηση μέσου

Η αποσύνδεση σταματά τις απαντήσεις του βοηθού σε αυτό το μέσο και κρατά το ιστορικό. Οι συνομιλίες σε εξέλιξη δεν διακόπτονται, για τον ίδιο λόγο που η δημοσίευση έκδοσης δεν διακόπτει κλήση.

POST /v1/messaging/media/{medium_code}/disconnection

curl https://api.wetalk.io/v1/messaging/media/web_chat/disconnection \
  -X POST \
  -H "Authorization: Bearer $WETALK_API_KEY"

Όλα όσα δεν είναι τηλεφωνική κλήση

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

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

GET /v1/messaging/conversations

curl -G https://api.wetalk.io/v1/messaging/conversations \
  -H "Authorization: Bearer $WETALK_API_KEY"
  --data-urlencode "limit=25"