Χρησιμοποιήστε τους δικούς σας αριθμούς (VoIP, API)

Οι δοκιμαστικοί αριθμοί είναι κατάλληλοι για πρωτοτυποποίηση, αλλά η κίνηση παραγωγής θα πρέπει να χρησιμοποιεί αριθμούς που σας ανήκουν μέσω του δικού σας παρόχου VoIP. Αυτός ο οδηγός σας καθοδηγεί στη ροή τριών βημάτων: δοκιμή διαπιστευτηρίων → δημιουργία σύνδεσης → εισαγωγή αριθμών → επαλήθευση.

Υποστηριζόμενοι πάροχοι

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 με το νέο αποδεικτικό.

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"]}'

Κάθε εισαγωγή γίνεται ένας πόρος τηλεφωνικού αριθμού στον οργανισμό σας με source="voip" και status="provisioning".

4. Επαληθεύστε κάθε εισαγόμενο αριθμό

Η εισαγωγή καταχωρεί τον αριθμό ως διαθέσιμο· η πραγματική δρομολόγηση κλήσεων μέσω αυτού απαιτεί επαλήθευση μετ’ επιστροφής (έλεγχος εισερχόμενης κλήσης + έλεγχος εξουσιοδότησης εξερχόμενης κλήσης).

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". Σε περίπτωση αποτυχίας, η απόκριση αναφέρει τι απέτυχε — διορθώστε το (συχνά πρόκειται για εκχώρηση trunk που λείπει στον πίνακα ελέγχου του παρόχου) και καλέστε ξανά.

5. Εκχωρήστε πράκτορες και δεχτείτε μια κλήση

Αφού επαληθευτεί ο αριθμός, εκχωρείτε πράκτορες εισερχόμενων / εξερχόμενων κλήσεων με τον ίδιο τρόπο όπως για έναν αριθμό επίδειξης. Δείτε Διαχείριση εισερχόμενων κλήσεων και Πραγματοποίηση εξερχόμενων κλήσεων.

Ανανέωση διαπιστευτηρίων

Όταν ανανεώνεται ένα κλειδί παρόχου, εκτελέστε ξανά τη ροή δοκιμής και έπειτα ενημέρωσης:

# 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"
  }'

Η σύνδεση παραμένει στη θέση της — δεν χρειάζεται να εισαγάγετε ξανά αριθμούς.

Επόμενα βήματα