Συνδέστε αριθμό ή το δικό σας SIP trunk

Συνδέστε το δικό σας SIP trunk

Αν οι αριθμοί σας ανήκουν σε πάροχο VoIP ή στο δικό σας τηλεφωνικό σύστημα, συνδέστε το μόνοι σας: ανοίξτε τους Αριθμούς & SIP στην κονσόλα και επιλέξτε «Σύνδεση trunk». Δεν χρειάζεται πάροχος από το WeTalk. Η πύλη του παρόχου σας δείχνει τα στοιχεία, συνήθως σε σελίδα SIP trunk, SIP account ή ρυθμίσεων σύνδεσης.

Ο πάροχός σας χρεώνει τα δικά του λεπτά για κλήσεις μέσω του trunk σας· το WeTalk χρεώνει χρόνο ομιλίας ως συνήθως. Ο ήχος περνά από τους διακομιστές του WeTalk στην Italy North.

• Host και θύρα — ο διακομιστής SIP του παρόχου σας, όπως sip.provider.com, και η θύρα του (συνήθως 5060 ή 5061 για TLS).
• Transport — UDP, TCP ή TLS, σύμφωνα με τον πάροχό σας.
• Όνομα χρήστη και κωδικός — τα στοιχεία με τα οποία το WeTalk συνδέεται στον πάροχό σας. Ο κωδικός φυλάσσεται στο vault του WeTalk και δεν εμφανίζεται ξανά, εδώ ή αλλού· αντικαταστήστε τον όποτε θέλετε.
• Οι αριθμοί σας (τα DID που σας έδωσε ο πάροχός σας), σε διεθνή μορφή με +, και ποιοι χρησιμοποιούνται ως αναγνώριση καλούντος για εξερχόμενες κλήσεις των βοηθών σας.
• Πώς γράφει αριθμούς ο πάροχός σας (με +, χωρίς +, με 00 ή εθνική μορφή) και πώς εμφανίζεται η αναγνώριση καλούντος. Το παράθυρο δείχνει τον πρώτο αριθμό σας σε κάθε μορφή.
• Οι χώρες που μπορεί να καλέσει το trunk. Κατά την κυκλοφορία μόνο η Ελλάδα. Αριθμοί έκτακτης ανάγκης, σύντομοι και αυξημένης χρέωσης δεν καλούνται ποτέ.

Ελέγξτε τη σύνδεση και κάντε δοκιμαστική κλήση

Ένα νέο trunk δείχνει «Δεν έχει επαληθευτεί ακόμη». Ο «Έλεγχος σύνδεσης» στην κάρτα του ζητά απάντηση από τον διακομιστή SIP του παρόχου σας, από τη διεύθυνση του WeTalk, και αναφέρει απλά τι συνέβη: αν βρέθηκε το host, αν απάντησε διακομιστής SIP, αν έγιναν δεκτά το όνομα χρήστη και ο κωδικός και αν επαληθεύτηκε το πιστοποιητικό TLS. Ο έλεγχος είναι δωρεάν και δεν καλεί κανέναν. Μπορεί να επαναληφθεί μετά από σύντομη αναμονή και ο λογαριασμός έχει ημερήσιο όριο ελέγχων· η άρνηση λέει πόσο να περιμένετε.

Αν ο πάροχός σας επιτρέπει συγκεκριμένες διευθύνσεις, προσθέστε τη διεύθυνση SIP του WeTalk που εμφανίζεται στους Αριθμούς & SIP κάτω από το «Πού να κατευθύνετε τον πάροχό σας», για σηματοδοσία και ήχο. Αν δεν απαντά καθόλου σε άγνωστες διευθύνσεις, κάντε δοκιμαστική κλήση: το «Ο βοηθός με καλεί» καλεί το τηλέφωνό σας από αριθμό αναγνώρισης καλούντος του trunk και το «Καλώ τον βοηθό» περιμένει δύο λεπτά να καλέσετε έναν από τους αριθμούς του. Η δοκιμαστική κλήση χρεώνεται ως χρόνος ομιλίας όπως κάθε άλλη.

Το trunk δείχνει «Επαληθευμένο» όταν ένας έλεγχος επιβεβαιώσει ότι είναι προσβάσιμο και δέχεται τα στοιχεία σας (ή δεν ζητά σύνδεση), ή όταν συνδεθεί μια δοκιμαστική κλήση μέσω αυτού.

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

curl https://api.wetalk.io/v1/sip-trunk-settings \
  -H "Authorization: Bearer $WETALK_API_KEY"

curl https://api.wetalk.io/v1/sip-trunks/$TRUNK/check \
  -X POST \
  -H "Authorization: Bearer $WETALK_API_KEY"

Λήψη συνομιλιών μέσω του trunk σας

Για να στέλνει ο πάροχός σας κλήσεις στο WeTalk, προσθέστε τις διευθύνσεις σηματοδοσίας του στο trunk (Επεξεργασία → Επιτρεπόμενες διευθύνσεις) και επιλέξτε «Δημιουργία στοιχείων σύνδεσης» στη Λήψη. Το WeTalk δημιουργεί όνομα χρήστη και κωδικό για τον πάροχό σας και δείχνει τον κωδικό μία φορά. Επικολλήστε και τα δύο στις ρυθμίσεις κλήσεων προς το WeTalk (συχνά ονομάζονται προορισμός), με τη διεύθυνση SIP του WeTalk. Το WeTalk δέχεται κλήση μόνο από επιτρεπόμενη διεύθυνση με αυτά τα στοιχεία· νέα δημιουργία αντικαθιστά και τα δύο.

Μετά συνδέστε αριθμό με βοηθό: στην καρτέλα Κανάλια του βοηθού, κάτω από τη «Σύνδεση αριθμού trunk», επιλέξτε αριθμό και Σύνδεση, ή επιλέξτε τον βοηθό δίπλα στον αριθμό στην κάρτα του trunk. Η σύνδεση σε άλλον βοηθό αντικαθιστά τον πρώτο.

Μέχρι να είναι όλα έτοιμα, η κάρτα του trunk δείχνει τι λείπει: ενεργοποίηση λήψης μέσω δικού σας trunk στο WeTalk, ενεργό και επαληθευμένο trunk, διευθύνσεις παρόχου, στοιχεία σύνδεσης WeTalk και αριθμός συνδεδεμένος σε βοηθό.

Εξερχόμενες κλήσεις μέσω του trunk σας

Οι εξερχόμενες συνομιλίες περνούν από το δικό σας SIP trunk, από αριθμό αναγνώρισης καλούντος συνδεδεμένο στον βοηθό. Το trunk πρέπει να είναι επαληθευμένο και ενεργό. Στην καρτέλα Εξερχόμενα, η «Νέα εκστρατεία» ζητά από ποιον αριθμό καλεί, ενώ η «Κλήση αριθμού τώρα» καλεί αμέσως έναν αριθμό: προορισμός, αριθμός προέλευσης, διάρκεια κουδουνίσματος (30 δευτερόλεπτα αν δεν την αλλάξετε, έως 80) και προαιρετική αναφορά που εμφανίζεται στο Ιστορικό και δεν λέγεται στον καλούμενο. Χρεώνεται χρόνος ομιλίας από την απάντηση. Το κλείσιμο του παραθύρου δεν κλείνει την κλήση — χρησιμοποιήστε Τερματισμό.

Κατά την κυκλοφορία το WeTalk καλεί μόνο ελληνικούς αριθμούς και ποτέ αριθμούς έκτακτης ανάγκης, σύντομους κωδικούς, αριθμούς αυξημένης χρέωσης ή προσωπικούς αριθμούς (70). Αν μια συνομιλία απορριφθεί, εμφανίζεται η αιτία και δεν πραγματοποιείται κλήση.

Από το δικό σας σύστημα αρκεί ένα αίτημα με δικαίωμα `conversation:dial` και υποχρεωτικό `Idempotency-Key`, ώστε το ίδιο κλειδί να μην καλέσει ποτέ αριθμό δύο φορές. Έως 10 συνομιλίες το λεπτό ανά λογαριασμό και 3 ανά κλειδί· η άρνηση περιέχει `Retry-After`. Η απάντηση έρχεται μόλις αρχίσει να χτυπά το τηλέφωνο.

curl https://api.wetalk.io/v1/agents/$AGENT/outbound-conversations \
  -X POST \
  -H "Authorization: Bearer $WETALK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 0199f1c2-6b47-7c69-a3aa-8f6a1b92d487" \
  -d '{ "party_number": "+302101234567", "caller_id_phone_number_id": "0199f1c2-6b48-7d7a-b4bb-906b2ca3e598", "ring_second": 30, "reference": "Order 1042" }'

{
  "data": {
    "conversation_id": "0199f1c2-6b49-7e8b-85cc-a17c3db4f6a9",
    "state": "dialing"
  }
}

curl https://api.wetalk.io/v1/outbound-conversations/$CONVERSATION \
  -H "Authorization: Bearer $WETALK_API_KEY"

curl https://api.wetalk.io/v1/outbound-conversations/$CONVERSATION/end \
  -X POST \
  -H "Authorization: Bearer $WETALK_API_KEY"

Η ποιότητα HD, όπως πραγματικά είναι

Το WeTalk προσφέρει πρώτα ευρυζωνικό G.722 και κατόπιν G.711. Το «Πρώτα HD» προσφέρει G.722, μετά G.711 µ-law και A-law· το «HD, αλλιώς μόνο A-law» περιορίζει ένα ευρωπαϊκό A-law trunk σε G.722 και A-law. Η ποιότητα HD ακούγεται μόνο αν ο πάροχός σας και κάθε δίκτυο μέχρι το άλλο τηλέφωνο μεταφέρουν G.722.

Η φωνή HD εξαρτάται από τον πάροχό σας και την άλλη άκρη. Οι συνομιλίες με συνηθισμένους αριθμούς είναι συνήθως τυπικής ποιότητας (G.711, 8 kHz), όπως τα περισσότερα δίκτυα. Το WeTalk δείχνει τι χρησιμοποιήθηκε πραγματικά σε κάθε συνομιλία.

Το Ιστορικό δείχνει τον codec που χρησιμοποιήθηκε πραγματικά — «HD (G.722, 16 kHz)», «Τυπική ποιότητα (G.711 A-law, 8 kHz)» ή «Τυπική ποιότητα (G.711 µ-law, 8 kHz)» — και «Ο codec δεν αναφέρθηκε» όταν το άκρο SIP του WeTalk δεν τον ανέφερε, ποτέ εικασία. Τον δείχνει και η πρόσφατη δραστηριότητα του trunk.

Το Opus δεν προσφέρεται μέσω SIP. Το WeTalk χρησιμοποιεί Opus για φωνή στον browser — στη δοκιμή της κονσόλας και στο widget ιστοτόπου — η οποία δεν περνά ποτέ από το trunk σας.

Για κρυπτογράφηση, το «Αν το προσφέρει ο πάροχος» κρυπτογραφεί τον ήχο (SRTP) όταν το υποστηρίζει ο πάροχός σας, ενώ το «Πάντα — απαιτεί TLS» δεν τον στέλνει ποτέ χωρίς κρυπτογράφηση. Χρειάζεται TLS επειδή τα κλειδιά ήχου μεταφέρονται στη σηματοδοσία. Η κάρτα του trunk δείχνει τι χρησιμοποιήθηκε στην τελευταία συνομιλία.

Πρόσφατη δραστηριότητα SIP

Κάθε κάρτα trunk δείχνει την πρόσφατη δραστηριότητα SIP: εισερχόμενες και εξερχόμενες κλήσεις, τελικές απαντήσεις, απαντήσεις κλήσεων, τερματισμούς, ελέγχους σύνδεσης, απορρίψεις σύνδεσης και κλήσεις σε αριθμούς εκτός trunk, με ώρα, απάντηση SIP και codec. Ο αριθμός του άλλου μέρους είναι καλυμμένος. Μια εγγραφή που κατέγραψε το WeTalk αντί να παρατηρήσει από τον πάροχό σας επισημαίνεται ως «καταγράφηκε από το WeTalk».

curl https://api.wetalk.io/v1/sip-trunks/$TRUNK/events \
  -H "Authorization: Bearer $WETALK_API_KEY"

Ζητήστε αριθμό από το WeTalk

Αν δεν έχετε δικό σας πάροχο, ορίστε τον βοηθό που θα απαντά, τη χώρα και όσα πρέπει να γνωρίζουμε — για παράδειγμα έναν αριθμό που έχετε ήδη και θέλετε να κρατήσετε. Το αίτημα καταγράφεται στο αρχείο ελέγχου σας. Το `state` υπολογίζεται στην ανάγνωση: `connected` όταν ένας αριθμός δεσμευτεί στον βοηθό κατά ή μετά το αίτημα, με τον αριθμό στο `connected_e164`· `pending` μέχρι τότε.

curl https://api.wetalk.io/v1/numbers/requests \
  -X POST \
  -H "Authorization: Bearer $WETALK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "voice_agent_id": "'$AGENT'", "country": "GR", "note": "Keep our shop number if possible" }'

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

Αριθμοί που εκδίδουμε

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

Η περιοχή και η καθυστέρηση μετ’ επιστροφής μετρώνται από εμάς και αναφέρονται ανά περιοχή, ώστε το στοιχείο δίπλα σε έναν αριθμό να είναι μέτρηση και όχι διαφημιστικός ισχυρισμός.

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

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

curl https://api.wetalk.io/v1/numbers/region-latency \
  -H "Authorization: Bearer $WETALK_API_KEY"

Τα παλαιότερα στοιχεία SIP ανά βοηθό

Βοηθοί που ρυθμίστηκαν πριν από τα αυτοεξυπηρετούμενα trunk μπορεί να έχουν ακόμη δικά τους στοιχεία SIP, διαθέσιμα στο `GET /v1/agents/{voice_agent_id}/sip` και με αλλαγή στο `POST /v1/agents/{voice_agent_id}/sip/rotation`. Αυτές οι διαδρομές διατηρούνται για αυτούς και είναι παλαιές: τα στοιχεία αυτά δεν είναι δικό σας trunk και οι νέες συνδέσεις χρησιμοποιούν τη «Σύνδεση trunk» στους Αριθμούς & SIP.

Το webhook του δικού σας παρόχου

Δεν είναι ακόμη διαθέσιμο. Το hostname των hooks που θα καλούσε ο πάροχος δεν λειτουργεί, επομένως δεν υπάρχει διεύθυνση εισερχόμενου webhook να σας δώσουμε· οι κλήσεις φτάνουν στον βοηθό σας μέσω δικού σας SIP trunk ή αριθμού που δημιουργεί το WeTalk.

Κλήση από browser

Η φωνή στον browser λειτουργεί σε δύο σημεία: στη δοκιμή της κονσόλας και στο widget ιστοτόπου. Και τα δύο χρησιμοποιούν WebRTC με codec Opus.

Δεν υπάρχει ακόμη endpoint browser ή βιβλιοθήκη πελάτη για τη δική σας εφαρμογή, επομένως δεν υπάρχει απόσπασμα εδώ. Η φωνή από το σύστημά σας φτάνει μέσω αριθμού ή SIP trunk και η διαδικτυακή συνομιλία μέσω του μέσου web-chat.