Open in
Χρησιμοποιήστε τους δικούς σας αριθμούς (VoIP, API)
Συνδέστε το Twilio ή το Telnyx, ή το SignalWire, Vonage, Plivo και οποιοδήποτε άλλο SIP trunk μέσω SIP, εισαγάγετε τους τηλεφωνικούς αριθμούς που ήδη διαθέτετε και αφήστε τους πράκτορες του ThunderPhone να απαντούν και να πραγματοποιούν κλήσεις μέσω αυτών.
Οι εγκεκριμένοι αριθμοί ThunderPhone μπορούν να πραγματοποιούν εξερχόμενες κλήσεις και να εκτελούν καμπάνιες. Αν προτιμάτε να χρησιμοποιήσετε αριθμούς που σας ανήκουν μέσω του δικού σας παρόχου VoIP, αυτός ο οδηγός σας καθοδηγεί στη ροή σύνδεσης: δοκιμή διαπιστευτηρίων → δημιουργία σύνδεσης → εισαγωγή αριθμών → επαλήθευση.
Υποστηριζόμενοι πάροχοι
| Πάροχος | provider id | Σημειώσεις |
|---|---|---|
| Twilio | twilio | SID λογαριασμού + Auth Token· μία σύνδεση ανά λογαριασμό ή δευτερεύοντα λογαριασμό Twilio (δείτε τους δευτερεύοντες λογαριασμούς Twilio) |
| Telnyx | telnyx | Κλειδί API· διαθέσιμη καθοδηγούμενη ενσωμάτωση (setup_method: guided_telnyx) |
| SignalWire | signalwire | Δεν υπάρχει εγγενής σύνδεση παρόχου· συνδέστε το ως manual με την προεπιλογή SIP SignalWire |
| Vonage | vonage | Δεν υπάρχει εγγενής σύνδεση παρόχου· συνδέστε το ως manual με την προεπιλογή SIP Vonage |
| Μη αυτόματο SIP | manual | Οποιοδήποτε SIP trunk, συμπεριλαμβανομένων των SignalWire, Vonage και Plivo. Αν ξεκινήσετε από ένα από αυτά τα πλακίδια παρόχων στον πίνακα ελέγχου, η σύνδεση παραμένει manual και αποθηκεύει την επιλογή στο sip_config.preset (signalwire, vonage ή plivo) |
1. Δοκιμή διαπιστευτηρίων
Πριν δημιουργήσετε μια μόνιμη σύνδεση VoIP, ελέγξτε τα
διαπιστευτήρια του παρόχου για να επιβεβαιώσετε ότι λειτουργούν. Αυτό επιστρέφει ένα
verification_evidence_id, το οποίο μεταβιβάζετε στο βήμα δημιουργίας ώστε τα
διαπιστευτήρια να μη χρεωθούν δύο φορές για τη δοκιμή.
curl -X POST https://api.thunderphone.com/v1/voip-connections/test \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"provider": "telnyx",
"credentials": { "apiKey": "KEY...", "connectionId": "123456" },
"sip_config": { "domain": "acme.sip.telnyx.com" }
}'{
"status": "pass",
"verification_evidence_id": "b9a2...",
"suggested_connection_name": "Telnyx: Acme Main (+15550001234)",
"checks": {
"credentials_valid": true,
"inbound_reachable": true,
"outbound_authorized": true
}
}Αν αποτύχει οποιοσδήποτε έλεγχος, το status της απόκρισης θα είναι fail και το checks θα
δείξει ποιο βήμα απέτυχε. Διορθώστε τη διαμόρφωση στην πλευρά του παρόχου (ανάθεση
trunk, λίστα επιτρεπόμενων IP, εξουσιοδότηση εξερχόμενων κλήσεων) και δοκιμάστε ξανά.
2. Δημιουργήστε τη σύνδεση
Περάστε το verification_evidence_id που μόλις λάβατε:
curl -X POST https://api.thunderphone.com/v1/voip-connections \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Telnyx Main",
"provider": "telnyx",
"setup_method": "api_key",
"credentials": { "apiKey": "KEY...", "connectionId": "123456" },
"sip_config": { "domain": "acme.sip.telnyx.com" },
"verification_evidence_id": "b9a2..."
}'Η απόκριση είναι ένα αντικείμενο VoipConnection
με status="connected". Τα διαπιστευτήρια και άλλες μυστικές τιμές σύνδεσης αποθηκεύονται στον διακομιστή και δεν
επιστρέφονται ποτέ ως απλό κείμενο από επόμενα GET — για εναλλαγή, εκτελέστε νέο
test και PATCH με τα νέα αποδεικτικά στοιχεία.
Υπολογαριασμοί Twilio
Μια σύνδεση Twilio είναι συνδεδεμένη με τον μοναδικό λογαριασμό Twilio του οποίου διαθέτει το Account SID και το Auth Token. Το Twilio διατηρεί τους αριθμούς τηλεφώνου και τα SIP trunks μέσα σε κάθε δευτερεύοντα λογαριασμό, επομένως μια σύνδεση που δημιουργήθηκε με τον γονικό λογαριασμό βλέπει μόνο τους αριθμούς του ίδιου του γονικού λογαριασμού και μια υπάρχουσα σύνδεση δεν μπορεί αργότερα να μεταφερθεί σε διαφορετικό δευτερεύοντα λογαριασμό.
Για να αποκτήσετε πρόσβαση σε αριθμούς που βρίσκονται σε υπολογαριασμούς, δημιουργήστε μία σύνδεση ανά υπολογαριασμό. Ο πίνακας ελέγχου το κάνει για εσάς: όταν συνδέετε έναν γονικό λογαριασμό που έχει ενεργούς υπολογαριασμούς, το παράθυρο ρυθμίσεων τους εμφανίζει, επιλέγετε εκείνους που θέλετε και το ThunderPhone δημιουργεί μια σύνδεση (και ένα SIP trunk) σε καθέναν. Η ίδια ροή είναι διαθέσιμη μέσω του API:
# Discover active subaccounts visible to the parent credentials
curl -X POST https://api.thunderphone.com/v1/voip-connections/twilio/subaccounts \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"credentials": {"accountSid": "ACparent...", "authToken": "..."}}'{
"discovery_id": "7c1e...",
"parent": { "sid": "ACparent...", "friendly_name": "Acme" },
"subaccounts": [
{ "sid": "ACsupport...", "friendly_name": "Acme Support", "already_connected": false, "connection_id": null },
{ "sid": "ACsales...", "friendly_name": "Acme Sales", "already_connected": true, "connection_id": 5 }
]
}# Create a connection for each selected subaccount
curl -X POST https://api.thunderphone.com/v1/voip-connections/twilio/subaccounts/connect \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"discovery_id": "7c1e...", "subaccount_sids": ["ACsupport..."]}'Η απόκριση περιλαμβάνει μία γραμμή ανά δευτερεύοντα λογαριασμό με status
created, skipped (ήδη συνδεδεμένος) ή failed, καθώς και ένα error
στο οποίο μπορείτε να ενεργήσετε. Οι γραμμές είναι ανεξάρτητες, επομένως μια αποτυχία σε έναν δευτερεύοντα λογαριασμό
δεν αποκλείει ποτέ τους άλλους, και ένα discovery_id παραμένει έγκυρο για 30
λεπτά, ώστε μια αποτυχημένη γραμμή να μπορεί απλώς να επαναληφθεί. Τα διακριτικά δευτερευόντων λογαριασμών
ανακτώνται από το Twilio κατά τον χρόνο εντοπισμού και αποθηκεύονται στη νέα σύνδεση·
δεν επιστρέφονται ποτέ από το API. Στη συνέχεια, κάθε νέα σύνδεση εισάγει
και επαληθεύει αριθμούς ακριβώς όπως μια σύνδεση που δημιουργήσατε χειροκίνητα.
Προσθέστε "enable_transfers": true για να ενεργοποιήσετε επίσης τις μεταφορές κλήσεων για τον κορμό SIP
κάθε νέας σύνδεσης· μια αποτυχία εκεί αναφέρεται στο
test_result.transfer_enable_error αυτής της σύνδεσης και δεν αποτυγχάνει η
γραμμή.
3. Παραθέστε και εισαγάγετε αριθμούς
Ελέγξτε τους αριθμούς που είναι ορατοί στα διαπιστευτήριά σας και δεν βρίσκονται ήδη σε έναν οργανισμό ThunderPhone:
curl https://api.thunderphone.com/v1/voip-connections/5/available-numbers \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"Στη συνέχεια, εισαγάγετε εκείνους που θέλετε:
curl -X POST https://api.thunderphone.com/v1/voip-connections/5/import-numbers \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"numbers": ["+15550001234", "+15550009999"]}'Κάθε εισαγωγή δημιουργεί έναν πόρο αριθμού τηλεφώνου
στον οργανισμό σας με number_type="voip" και status="provisioning".
Διατηρήστε τη δική σας δρομολόγηση κλήσεων
Στο Twilio, η εισαγωγή τοποθετεί τον αριθμό στο SIP trunk του ThunderPhone στον λογαριασμό σας· στο Telnyx, αντιστοιχίζει τον αριθμό στη σύνδεση SIP του ThunderPhone. Σε κάθε περίπτωση, κάθε κλήση πηγαίνει έπειτα απευθείας στον πράκτορά σας.
Για να δρομολογείτε εσείς τις κλήσεις (για παράδειγμα, να καλείτε πρώτα ένα
άτομο και να στέλνετε την κλήση στον πράκτορα μόνο αν δεν απαντήσει), αλλάξτε
τις ρυθμίσεις φωνής του αριθμού στον πάροχό σας μετά την εισαγωγή ή κάντε
εισαγωγή μέσω του API με "call_routing": "customer", ώστε το ThunderPhone να
μην τις αλλάξει καθόλου. Το ThunderPhone δεν τις επαναφέρει ποτέ. Για να
απαντά ο πράκτορας, στείλτε την κλήση στη διεύθυνση SIP του αριθμού:
<Response>
<Dial>
<Sip>sip:+15550001234@sip.thunderphone.com</Sip>
</Dial>
</Response>Η αποστολή γραπτών μηνυμάτων μέσω του αριθμού λειτουργεί με τον ίδιο τρόπο σε κάθε περίπτωση. Η δοκιμή εισερχόμενης κλήσης καλεί τον αριθμό, επομένως φτάνει σε όποιον λαμβάνει πρώτος τις κλήσεις σύμφωνα με τη δρομολόγησή σας.
Μεταφορά αριθμού μεταξύ συνδέσεων
Η εισαγωγή ενός αριθμού που βρίσκεται ήδη σε άλλη από τις συνδέσεις σας τον μεταφέρει στη νέα, μαζί με τους πράκτορες και το ιστορικό του. Ένας αριθμός που μια σύνδεση Twilio ή Telnyx στέλνει στο ThunderPhone πρέπει πρώτα να αφαιρεθεί από εκείνη τη σύνδεση, καθώς ο πάροχός του θα συνέχιζε να στέλνει εκεί τις κλήσεις.
4. Επαληθεύστε κάθε εισαγόμενο αριθμό
Η εισαγωγή καταχωρίζει τον αριθμό ως διαθέσιμο· η πραγματική δρομολόγηση κλήσεων μέσω αυτού απαιτεί επαλήθευση. Για συνδέσεις παρόχων (Twilio, Telnyx), αυτό επανελέγχει τα διαπιστευτήρια του παρόχου και την προσβασιμότητα SIP. Για μια σύνδεση μη αυτόματου SIP, αρχικά επιχειρεί μια αυτοκλήση βρόχου: το ThunderPhone πραγματοποιεί μια σύντομη δοκιμαστική κλήση από τον αριθμό, μέσω του κορμού SIP σας, πίσω στον ίδιο αριθμό. Αν αυτό δεν επαληθεύσει την εισερχόμενη διαδρομή, χρησιμοποιεί μια σύντομη δοκιμαστική κλήση από τον αριθμό, μέσω του κορμού SIP σας, προς έναν αριθμό ThunderPhone. Αυτές οι δοκιμές ελέγχουν το όνομα χρήστη, τον κωδικό πρόσβασης, τη μεταφορά, την εξερχόμενη δρομολόγηση και την εισερχόμενη παράδοση του κορμού. Ο πάροχός σας χρεώνει αυτές τις κλήσεις όπως κάθε άλλη.
curl -X POST https://api.thunderphone.com/v1/phone-numbers/{id}/verify-voip \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"Με επιτυχία, το voip_verification_status αλλάζει σε verified και ο
αριθμός εισέρχεται σε status="active". Ένας αριθμός στον δικό σας λογαριασμό Telnyx
συνεχίζει να δέχεται εισερχόμενες κλήσεις όταν αποτυγχάνει η δοκιμαστική του κλήση ή όταν
δεν έχει ρυθμιστεί ακόμη η εξερχόμενη δρομολόγηση: γίνεται status="active" με το voip_verification_status
ορισμένο σε unverified, και η απόκριση αναφέρει τον λόγο. Σε περίπτωση αποτυχίας, η απόκριση διευκρινίζει
τι απέτυχε — για έναν μη αυτόματο κορμό, αυτή είναι η απάντηση SIP του παρόχου, για
παράδειγμα «απέρριψε τα διαπιστευτήρια του ThunderPhone (SIP 401)» ή «δεν ήταν δυνατή η δρομολόγηση μιας κλήσης (SIP 404)» — διορθώστε το (διαπιστευτήρια, επιτρεπόμενες IP πηγής, μια ελλιπή αντιστοίχιση κορμού στον πίνακα ελέγχου του παρόχου) και καλέστε ξανά.
Για μια χειροκίνητη σύνδεση SIP με λίστα επιτρεπόμενων διευθύνσεων, ο έλεγχος εισερχόμενης κλήσης αποτυγχάνει επίσης αν αυτές οι Επιτρεπόμενες IP προέλευσης θα εμπόδιζαν μια πραγματική εισερχόμενη κλήση. Αν χρησιμοποιείτε IP αναμετάδοσης του ThunderPhone στη λίστα επιτρεπόμενων διευθύνσεών σας, συμπεριλάβετε κάθε IP αναμετάδοσης που σας παρέχει το ThunderPhone για τη διαμόρφωσή σας.
5. Αναθέστε πράκτορες και πραγματοποιήστε μια κλήση
Με τον αριθμό επαληθευμένο, αναθέτετε εισερχόμενους / εξερχόμενους πράκτορες με τον ίδιο τρόπο όπως για έναν αριθμό ThunderPhone. Δείτε Διαχείριση εισερχόμενων κλήσεων και Πραγματοποίηση εξερχόμενων κλήσεων.
Οι κλήσεις από αριθμούς ThunderPhone μπορούν επίσης να καλούν προορισμούς εκτός ΗΠΑ και Καναδά όταν το ThunderPhone διαθέτει χρέωση για τη συγκεκριμένη χώρα και τον τύπο γραμμής. Οι κλήσεις αυτές χρεώνονται με την τιμή του προορισμού.
Εναλλαγή διαπιστευτηρίων
Όταν αλλάζει ένα κλειδί παρόχου, εκτελέστε ξανά τη ροή δοκιμής και έπειτα ενημέρωσης:
# 1. Test the new credentials
curl -X POST https://api.thunderphone.com/v1/voip-connections/test ...
# 2. PATCH the connection with the new evidence
curl -X PATCH https://api.thunderphone.com/v1/voip-connections/{id} \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"credentials": { "apiKey": "NEW_KEY..." },
"verification_evidence_id": "fresh-evidence-id"
}'Η σύνδεση παραμένει ενεργή — δεν χρειάζεται να εισαγάγετε ξανά αριθμούς. Στη ροή επανασύνδεσης του πίνακα ελέγχου, μπορείτε να εισαγάγετε με ασφάλεια το νέο κλειδί παρόχου χωρίς να αντικαταστήσετε ολόκληρο το αποθηκευμένο αντικείμενο διαπιστευτηρίων σε απλό κείμενο.
Επόμενα βήματα
Κάθε πεδίο στις αποκρίσεις σύνδεσης, αποδεικτικών στοιχείων και εισαγωγής.
Αναθέστε πράκτορες, μεταφέρετε μεταξύ οργανισμών, αποδεσμεύστε αριθμούς.
Τώρα που έχετε τον αριθμό, ξεκινήστε να πραγματοποιείτε εξερχόμενες κλήσεις.