Leta namba zako mwenyewe (VoIP, API)

Nambari za onyesho zinafaa kwa kutengeneza mfano wa awali, lakini trafiki ya uzalishaji inapaswa kutumia nambari unazomiliki kupitia mtoa huduma wako wa VoIP. Mwongozo huu unakuongoza katika mtiririko wa hatua tatu: jaribu vitambulisho → unda muunganisho → ingiza nambari → thibitisha.

Watoa huduma wanaotumika

1. Jaribu vitambulisho

Kabla ya kuunda muunganisho wa VoIP unaohifadhiwa, chunguza vitambulisho vya mtoa huduma ili kuthibitisha vinafanya kazi. Hii inarudisha verification_evidence_id unayopitisha kwenye hatua ya kuunda ili vitambulisho visitozwe mara mbili kwa ajili ya majaribio.

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
  }
}

Ikiwa ukaguzi wowote utashindwa, status ya jibu itakuwa fail na checks itaonyesha ni hatua gani ilishindwa. Rekebisha usanidi wa upande wa mtoa huduma (ugawaji wa tranki, orodha ya IP zinazoruhusiwa, uidhinishaji wa simu za kutoka) kisha jaribu tena.

2. Unda muunganisho

Pitisha verification_evidence_id uliyopata sasa hivi:

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

Jibu ni kitu cha VoipConnection chenye status="connected". Vitambulisho huhifadhiwa upande wa seva na havirudishwi kamwe kama maandishi wazi na GET zinazofuata — ili kuvibadilisha, endesha test mpya na PATCH yenye ushahidi mpya.

3. Orodhesha na ingiza nambari

Kagua nambari zinazoonekana kwa vitambulisho vyako ambazo bado hazipo katika org ya ThunderPhone:

curl https://api.thunderphone.com/v1/voip-connections/5/available-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Kisha ingiza unazotaka:

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

Kila uingizaji huwa rasilimali ya nambari ya simu katika org yako yenye source="voip" na status="provisioning".

4. Thibitisha kila nambari iliyoingizwa

Kuagiza husajili nambari kama inayopatikana; kuelekeza simu kupitia nambari hiyo kunahitaji uthibitishaji wa kwenda-na-kurudi (ukaguzi wa kupiga simu zinazoingia + jaribio la uidhinishaji wa simu zinazotoka).

curl -X POST https://api.thunderphone.com/v1/phone-numbers/{id}/verify-voip \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Ikifaulu, voip_verification_status hubadilika kuwa verified na nambari huingia katika status="active". Ikishindwa, jibu hueleza kilichoshindwa — rekebisha (mara nyingi ni ukosefu wa ugawaji wa trunk kwenye dashibodi ya mtoa huduma) kisha piga tena.

5. Wape ejenti na upokee simu

Nambari ikishathibitishwa, unawapa ejenti wa simu zinazoingia / zinazotoka kwa njia sawa na nambari ya onyesho. Tazama Shughulikia simu zinazoingia na Piga simu zinazotoka.

Kubadilisha vitambulisho

Ufunguo wa mtoa huduma unapobadilishwa, endesha tena mtiririko wa jaribu-kisha-sasisha:

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

Muunganisho unabaki mahali pake — hakuna haja ya kuagiza nambari tena.

Hatua zinazofuata