ThunderPhone v3 sasa inapatikana.Anza mwenyewe, kuanzia 2¢/dakika.Soma tangazo

Developer cookbook

Tumia nambari zako mwenyewe (VoIP, API)

Unganisha Twilio, Telnyx, SignalWire, Vonage, Plivo na SIP trunk nyingine yoyote kupitia SIP, ingiza nambari za simu ambazo tayari unamiliki, na uruhusu ejenti za ThunderPhone kujibu na kupiga simu kwa kutumia nambari hizo.

Nambari za ThunderPhone zilizoidhinishwa zinaweza kupiga simu za kutoka na kuendesha kampeni. Ikiwa unapendelea kutumia nambari unazomiliki kupitia mtoa huduma wako wa VoIP, mwongozo huu unakuongoza kwenye mtiririko wa kuunganisha: jaribu vitambulisho → unda muunganisho → leta nambari → thibitisha.

Watoa huduma wanaotumika

Mtoa hudumaKitambulisho cha providerMaelezo
TwiliotwilioSID ya akaunti + Tokeni ya Uthibitishaji; muunganisho mmoja kwa kila akaunti au akaunti ndogo ya Twilio (tazama akaunti ndogo za Twilio)
TelnyxtelnyxUfunguo wa API; usanidi elekezi unapatikana (setup_method: guided_telnyx)
SignalWiresignalwireHakuna muunganisho asilia wa mtoa huduma; iunganishe kama manual kwa mpangilio awali wa SIP wa SignalWire
VonagevonageHakuna muunganisho asilia wa mtoa huduma; iunganishe kama manual kwa mpangilio awali wa SIP wa Vonage
SIP ya mwongozomanualTranki yoyote ya SIP, ikijumuisha SignalWire, Vonage na Plivo. Ukianzia kwenye kigae cha mmoja wa watoa huduma hao katika dashibodi, muunganisho bado ni manual na huhifadhi chaguo katika sip_config.preset (signalwire, vonage au plivo)

1. Jaribu vitambulisho

Kabla ya kuunda muunganisho wa VoIP uliohifadhiwa, jaribu vitambulisho vya mtoa huduma kuthibitisha kuwa vinafanya kazi. Hii hurejesha 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" }
  }'
Response
{
  "status": "pass",
  "verification_evidence_id": "b9a2...",
  "suggested_connection_name": "Telnyx: Acme Main (+15550001234)",
  "checks": {
    "credentials_valid": true,
    "inbound_reachable": true,
    "outbound_authorized": true
  }
}

Kama ukaguzi wowote utashindwa, status ya jibu itakuwa fail na checks itaonyesha ni hatua gani imeshindwa. Rekebisha usanidi wa upande wa mtoa huduma (ugawaji wa tranki, orodha ya IP zinazoruhusiwa, uidhinishaji wa simu za kutoka) na ujaribu 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 na thamani nyingine za siri za muunganisho huhifadhiwa upande wa seva na kamwe hazirudishwi kama maandishi wazi na GET zinazofuata — ili kubadilisha, endesha test mpya na PATCH ukitumia ushahidi mpya.

Akaunti ndogo za Twilio

Muunganisho wa Twilio hufungamanishwa na akaunti moja ya Twilio ambayo ina Account SID na Auth Token. Twilio huhifadhi nambari za simu na SIP trunks ndani ya kila subaccount, kwa hivyo muunganisho uliotengenezwa kwa akaunti kuu huona tu nambari za akaunti kuu yenyewe, na muunganisho uliopo hauwezi kubadilishwa hadi subaccount nyingine baadaye.

Ili kufikia namba zilizohifadhiwa katika akaunti ndogo, unda muunganisho mmoja kwa kila akaunti ndogo. Dashibodi hufanya hili kwa ajili yako: unapounganisha akaunti kuu yenye akaunti ndogo zinazotumika, kisanduku cha usanidi huziorodhesha, unachagua unazotaka, na ThunderPhone huunda muunganisho (na SIP trunk) katika kila moja. Mtiririko huu huu unapatikana pia kupitia 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": "..."}}'
Response
{
  "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..."]}'

Jibu lina safu moja kwa kila akaunti ndogo yenye status ya created, skipped (tayari imeunganishwa), au failed, pamoja na error unayoweza kufanyia kazi. Safu hizi zinajitegemea, kwa hivyo hitilafu katika akaunti ndogo moja haiwazuii nyingine, na discovery_id hubaki halali kwa dakika 30 ili safu iliyoshindwa iweze kujaribiwa tena kwa urahisi. Tokeni za akaunti ndogo husomwa kutoka Twilio wakati wa ugunduzi na kuhifadhiwa kwenye muunganisho mpya; hazirejeshwi kamwe na API. Kisha kila muunganisho mpya huingiza na kuthibitisha nambari sawasawa na muunganisho uliounda mwenyewe. Ongeza "enable_transfers": true ili pia kuwasha uhamishaji wa simu kwa SIP trunk ya kila muunganisho mpya; hitilafu hapo huripotiwa katika test_result.transfer_enable_error ya muunganisho huo na haisababishi safu ishindwe.

3. Orodhesha na uingize namba

Kagua namba 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 uagizaji huunda rasilimali ya nambari ya simu katika org yako yenye number_type="voip" na status="provisioning".

Hifadhi uelekezaji wako wa simu

Kwenye Twilio, kuingiza nambari huiweka kwenye mkonga wa SIP wa ThunderPhone katika akaunti yako; kwenye Telnyx, huunganisha nambari kwenye muunganisho wa SIP wa ThunderPhone. Kwa vyovyote vile, kila simu huenda moja kwa moja kwa ejenti wako.

Ili kuelekeza simu mwenyewe badala yake (kwa mfano, kumpigia mtu kwanza na kutuma simu kwa ejenti tu ikiwa hatajibu), badilisha mipangilio ya sauti ya nambari kwa mtoa huduma wako baada ya kuiingiza, au iingize kupitia API kwa kutumia "call_routing": "customer" ili ThunderPhone isibadilishe mipangilio hiyo kabisa. ThunderPhone haibadilishi mipangilio hiyo kurudi kamwe. Ili ejenti ajibu, tuma simu kwenye anwani ya SIP ya nambari:

<Response>
  <Dial>
    <Sip>sip:+15550001234@sip.thunderphone.com</Sip>
  </Dial>
</Response>

Kutuma ujumbe kupitia nambari hufanya kazi vivyo hivyo kwa njia zote mbili. Jaribio la simu zinazoingia hupigia nambari, hivyo hufika kwa yeyote ambaye uelekezaji wako hutuma simu kwake kwanza.

Kuhamisha nambari kati ya miunganisho

Kuleta nambari ambayo tayari iko kwenye muunganisho wako mwingine huihamisha kwenye muunganisho mpya, pamoja na ejenti zake na historia yake. Nambari ambayo muunganisho wa Twilio au Telnyx hutuma kwa ThunderPhone lazima iondolewe kwenye muunganisho huo kwanza, kwa kuwa mtoa huduma wake angeendelea kutuma simu huko.

4. Thibitisha kila namba iliyoingizwa

Kuagiza kunasajili nambari kama inayopatikana; kuelekeza simu kupitia nambari hiyo kunahitaji uthibitishaji. Kwa miunganisho ya watoa huduma (Twilio, Telnyx), hilo hukagua tena stakabadhi za mtoa huduma na ufikiwaji wa SIP. Kwa muunganisho wa SIP wa mikono, kwanza hujaribu simu ya kujipigia ya mzunguko: ThunderPhone hupiga simu fupi ya majaribio kutoka kwenye nambari, kupitia trunk yako ya SIP, kurudi kwenye nambari hiyo hiyo. Ikiwa hilo halithibitishi njia ya simu zinazoingia, basi hutumia simu fupi ya majaribio kutoka kwenye nambari, kupitia trunk yako ya SIP, kwenda kwenye nambari ya ThunderPhone. Majaribio haya hukagua jina la mtumiaji la trunk, nenosiri, usafirishaji, uelekezaji wa simu zinazotoka, na uwasilishaji wa simu zinazoingia. Mtoa huduma wako hutoza simu hizi kama simu nyingine yoyote.

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

Ikifanikiwa, voip_verification_status hubadilika kuwa verified na nambari huingia katika status="active". Nambari iliyo katika akaunti yako mwenyewe ya Telnyx huendelea kupokea simu zinazoingia iwapo simu yake ya majaribio itashindwa au njia ya kutoka bado haijasanidiwa: huwa status="active" huku voip_verification_status ikiwekwa kuwa unverified, na jibu hueleza sababu. Ikishindwa, jibu hufafanua kilichoshindwa — kwa trunk ya SIP ya mkono, hiyo ni jibu la SIP la mtoa huduma, kwa mfano "ilikataa stakabadhi za ThunderPhone (SIP 401)" au "haikuweza kuelekeza simu (SIP 404)" — rekebisha tatizo hilo (stakabadhi, IP za chanzo zinazoruhusiwa, mgawo wa trunk unaokosekana katika dashibodi ya mtoa huduma) kisha piga simu tena.

Kwa muunganisho wa SIP wa mkono ulioorodheshwa kuruhusiwa, jaribio la simu inayoingia pia hushindwa ikiwa IP hizo za Chanzo Zinazoruhusiwa zingezuia simu halisi inayoingia. Ikiwa unatumia IP za relay za ThunderPhone katika orodha yako ya kuruhusu, jumuisha kila IP ya relay ambayo ThunderPhone inakupa kwa usanidi wako.

5. Wape ejenti na upokee simu

Baada ya namba kuthibitishwa, unaweza kuwapa ejenti wa simu zinazoingia / zinazotoka kwa njia ileile kama namba ya ThunderPhone. Angalia Shughulikia simu zinazoingia na Piga simu zinazotoka.

Simu kutoka nambari za ThunderPhone pia zinaweza kupiga nambari zilizo nje ya Marekani na Kanada wakati ThunderPhone ina bei ya nchi hiyo na aina hiyo ya laini. Simu hizo hutozwa kwa bei ya unakoenda.

Vitambulisho vinavyobadilishwa

Ufunguo wa mtoa huduma unapobadilishwa, endesha tena mtiririko wa kujaribu-kisha-kusasisha:

# 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 unasalia mahali pake — hakuna haja ya kuagiza upya nambari. Katika mtiririko wa kuunganisha tena kwenye dashibodi, unaweza kuingiza kwa usalama ufunguo mpya wa mtoa huduma bila kubadilisha objekti nzima ya vitambulisho vilivyohifadhiwa kwa maandishi wazi.


Hatua zinazofuata