Τηλέφωνο
Επαγγελματικοί αριθμοί που χτυπούν στην ομάδα σας, με μεταφορά, δρομολόγηση και εγγραφή.
Το Τηλέφωνο έχει πενήντα δημόσιες μεθόδους, και η σελίδα Τηλέφωνο του Dashboard είναι χτισμένη πάνω τους. Σαράντα τέσσερις ενεργούν για τον λογαριασμό του οποίου το κλειδί API χρησιμοποιείτε. Έξι προορίζονται για τους δικούς του χειριστές του Xuda και χρειάζονται κλειδί διαχειριστή: ο έλεγχος των αρχείων συμμόρφωσης μιας χώρας και ο διακανονισμός χρήσης και εγγραφών, καθώς και το adopt_voice_number, που αναθέτει σε ένα προφίλ έναν αριθμό που ήδη ανήκει στο Xuda χωρίς αγορά.
Στείλτε ένα αίτημα σε μια μέθοδο με το κλειδί σας:
Ενοικίαση αριθμού
Αυτό κάνει η Ενοικίαση αριθμού, με την ίδια σειρά.
Δείτε πού μπορούν να νοικιαστούν αριθμοί
Το get_voice_country_catalog απαριθμεί τις χώρες και τους τύπους αριθμών που είναι ανοιχτοί. Το get_voice_compliance_status για μια country λέει τι χρειάζεται ακόμα από εσάς αυτή η χώρα πριν νοικιαστεί ένας αριθμός: τις πολιτικές της, την ταυτότητα πίσω από τον αριθμό και, σε ρυθμιζόμενη χώρα, την εγγραφή στον πάροχο τηλεφωνίας.
Περάστε τους ελέγχους της χώρας
Το accept_voice_terms καταγράφει τις πολιτικές, με κάθε id που αναφέρει η χώρα και το ακριβές policy_version. Το get_voice_identity_requirements επιστρέφει τα πεδία που ζητά η χώρα, το update_profile_business_identity τα αποθηκεύει και το submit_voice_compliance τα στέλνει για έλεγχο. Για μια ρυθμιζόμενη χώρα, το upload_voice_compliance_document στέλνει κάθε έγγραφο που ζητά ο πάροχος και το submit_voice_bundle στέλνει την εγγραφή.
Αναζήτηση και προσφορά τιμής
Το search_voice_numbers αναζητά τους ελεύθερους αριθμούς ανά country και type (local, mobile, tollFree ή national), περιορισμένους με area_code, ένα μοτίβο contains ή απαιτούμενα capabilities. Το get_voice_number_rates δείχνει τι μπορεί να κάνει ο αριθμός και πόσο κοστίζει η χρήση. Το quote_voice_number τιμολογεί έναν υποψήφιο και κρατά την τιμή για λίγο, ώστε να μην αλλάξει κατά τη διάρκεια μιας αγοράς σε εξέλιξη.
Αγορά
Το purchase_voice_number εξαργυρώνει την προσφορά (quote_id και το ίδιο phone_number) και χρεώνει την επαναλαμβανόμενη ενοικίαση. Περάστε payment_method_id για να επιλέξετε την κάρτα που πληρώνει.
Απελευθέρωση
Το release_voice_number επιστρέφει έναν αριθμό. Σταματά να χτυπά αμέσως και η μηνιαία ανανέωσή του ακυρώνεται.
Η αποστολή μηνυμάτων επιλέγεται όταν νοικιάζεται ένας αριθμός: μόνο ένας αριθμός που μπορεί να στέλνει μηνύματα μπορεί να στέλνει ή να λαμβάνει, και δεν μπορεί να προστεθεί αργότερα.
Ορίστε πώς απαντά μια γραμμή
Το list_voice_numbers απαριθμεί τους αριθμούς σας με το προφίλ στο οποίο είναι συνδεδεμένος καθένας. Με shared_only: true απαριθμεί αντίθετα τις γραμμές που μοιράστηκαν μαζί σας άλλα άτομα και δεχτήκατε, καθεμία με shared_from· δεν μετρούν ποτέ στο πλάνο σας. Το attach_voice_number δίνει έναν αριθμό σε ένα προφίλ (ένας αριθμός ανά προφίλ, και το κύριο προφίλ δεν μπορεί ποτέ να έχει) και το detach_voice_number τον αφαιρεί χωρίς να τον απελευθερώσει.
Το get_voice_number_setup διαβάζει με μία κλήση ό,τι καθορίζει πώς απαντά ένας αριθμός: το προφίλ, τι επιτρέπει το πλάνο σας, και τους κανόνες με τις λίστες επιλογών πίσω τους. Το update_voice_number_setup το αποθηκεύει. Κάθε ενότητα αγγίζεται μόνο όταν την στέλνετε, οπότε η αποθήκευση μιας δεν επαναφέρει ποτέ μια άλλη. Η ρύθμιση φέρει επίσης το auto_answer, τον Δημόσιο βοηθό που απαντά στη γραμμή και πότε (always, when_no_answer, when_closed, schedule), που αποθηκεύεται στέλνοντας μόνο ό,τι αλλάζει· μια επιλογή που δεν είναι ένας από τους ενεργούς Δημόσιους βοηθούς σας απορρίπτεται με assistant_not_public. Τα ring.contacts και ring.groups των κανόνων είναι επαφές και ομάδες επαφών του χώρου εργασίας της ίδιας της γραμμής που καλεί επίσης (μια που δεν υπάρχει πια απορρίπτεται με voice_answerer_not_found), και το shared_with απαριθμεί τα άτομα με τα οποία μοιράζεται η γραμμή, σε αναμονή ή αποδεκτά. Τα get_profile_answering_rules και update_profile_answering_rules διαβάζουν και αποθηκεύουν μόνο τους κανόνες: ώρες λειτουργίας, χρονικό όριο κουδουνίσματος, ποιος καλείται, προώθηση σε κινητό, τηλεφωνητής και ηχογράφηση.
Μια ρύθμιση που το πλάνο σας δεν περιλαμβάνει απορρίπτεται με voice_plan_upgrade_required, ποτέ δεν αγνοείται σιωπηλά. Μια υποβάθμιση ισχύει από την επόμενη κλήση, και ό,τι αποθηκεύσατε μένει στη θέση του ώστε μια αναβάθμιση να το επαναφέρει.
Τα list_voice_profile_members, share_voice_profile και revoke_voice_profile_member αποφασίζουν ποιος είναι σε ένα προφίλ, και άρα ποιον μπορεί να καλέσει μια γραμμή και σε ποιον μπορεί να μεταφερθεί μια κλήση. Μια ίδια η γραμμή μοιράζεται μέσω των κοινοποιήσεων ομάδας (create_share με τον τύπο κοινοποίησης voice_number)· μια αποδεκτή κοινοποίηση καλεί κι αυτό το άτομο. Το get_voice_browser_token με answering: true δίνει σε ένα πρόγραμμα περιήγησης ένα token για κάθε γραμμή κάποιου άλλου που καλεί αυτόν τον λογαριασμό, ώστε να χτυπά και εκεί· απαντούν μόνο.
Κλήσεις
- Το
list_voice_callsδιαβάζει το ιστορικό κλήσεων, για τον λογαριασμό, ένα προφίλ ή έναν αριθμό. - Το
get_voice_call_transcriptδιαβάζει το κείμενο μιας κλήσης, όταν υπάρχει. - Τα
get_voice_browser_tokenκαιcreate_voice_call_intentαφήνουν ένα softphone προγράμματος περιήγησης να κάνει κλήση: η πρόθεση εξουσιοδοτεί μία εξερχόμενη κλήση από έναν αριθμό που κατέχετε προς έναν αριθμόto. Η εφαρμογή Xuda για iPhone ζητά τα token της μεpush_env(sandboxήproduction): κάθε token τότε ονομάζει το διαπιστευτήριο push του Twilio του δικού του λογαριασμού Twilio, ώστε μια κλήση να χτυπά το τηλέφωνο ακόμα και με κλειστή την εφαρμογή, και η απάντηση λέειpush: true. - Τα
list_voice_transfer_targetsκαιtransfer_voice_callμετακινούν μια ζωντανή κλήση σε άλλο άτομο του προφίλ, και τοtakeover_voice_callμετακινεί μια κλήση από τη ρεσεψιονίστ AI στο πρόγραμμα περιήγησής σας. - Το
send_voice_announcementκάνει μια κλήση από έναν από τους αριθμούς σας και εκφωνεί ένα πληκτρολογημένο μήνυμα σε όποιον απαντήσει.
Μηνύματα
Το list_voice_message_threads απαριθμεί συζητήσεις με το τελευταίο μήνυμα, τον αριθμό των αδιάβαστων και αν η επαφή έχει αποχωρήσει. Το list_voice_messages διαβάζει μία συζήτηση. Το send_voice_message στέλνει ένα μήνυμα από έναν αριθμό που μπορεί να στέλνει μηνύματα· δώστε του ένα idempotency_key και μια επανάληψη χρεώνεται μία φορά. Μια επαφή που έχει στείλει STOP απορρίπτεται μέχρι να στείλει START. Το mark_voice_message_thread_read μηδενίζει τον αριθμό αδιάβαστων μιας συζήτησης.
Πλάνο, χρήση και υπηρεσία
Το get_voice_plans διαβάζει τη σκάλα των πλάνων και το πλάνο στο οποίο βρίσκεστε. Το set_voice_plan το ενεργοποιεί, το αναβαθμίζει ή το υποβαθμίζει, με tier ή με το id του πλάνου (profile_phone_phone)· χρειάζεται πληρωμένο λογαριασμό Xuda. Το get_voice_usage διαβάζει τις κλήσεις και τα μηνύματα του μήνα, με το όριο δαπανών που απομένει. Τα get_voice_service_status και activate_voice_service διαβάζουν και προετοιμάζουν την υπηρεσία τηλεφώνου του λογαριασμού.