Shughulikia simu zinazoingia (API)

Hatua zote: sanidi ejenti, ipe nambari ya simu, pokea simu, na kagua nakala ya mazungumzo.

Mtiririko wa kawaida wa "kujibu simu kwa AI", kutoka kwenye terminal yako. Utafanya yafuatayo:

1. Unda ejenti yenye prompt na sauti.
2. Andaa (au leta) nambari ya simu na umpe ejenti jukumu la kushughulikia simu zinazoingia.
3. Piga nambari hiyo. Angalia kumbukumbu ya simu, nakala ya mazungumzo, na rekodi.

Jumla ya miito ya API: minne. Jumla ya muda: chini ya dakika tano.

1. Unda ejenti#

Ejenti hujumuisha prompt, sauti, na kiwango cha bidhaa vitakavyoendesha simu. Tazama Ejenti kwa kila uga wa usanidi; kiwango cha chini ni:

curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":    "Acme Support",
    "prompt":  "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
    "voice":   "john",
    "product": "spark"
  }'

Hifadhi id inayorejeshwa — utaihitaji katika hatua ya 2.

2. Pata nambari ya simu#

Ikiwa unahitaji tu kitu cha kupigia majaribio, pata nambari ya ThunderPhone kutoka kwenye mkusanyiko wa ThunderPhone:

curl -X POST https://api.thunderphone.com/v1/phone-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_code": "415"}'

Jibu linajumuisha id na number katika E.164. Nambari za ThunderPhone huanza katika status="provisioning" na kuwa active ndani ya sekunde chache — fanya poll kwa GET /v1/phone-numbers/{id} ili kufuatilia mabadiliko hayo ikiwa ni muhimu kwako.

3. Mpe ejenti jukumu#

Husisha ejenti kutoka hatua ya 1 na mwelekeo wa simu zinazoingia wa nambari:

curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'

Hiyo ndiyo — nambari iko hewani. Pia unaweza kuweka outbound_agent_id katika PATCH hiyo hiyo ili nambari iwe tayari kupiga simu zinazotoka pia.

4. Pokea simu#

Piga nambari hiyo kutoka kwenye simu yako. Ejenti hupokea simu, inajitambulisha kulingana na prompt yako, na mazungumzo huanza.

Wakati simu inaendelea, inaonekana katika GET /v1/calls ikiwa na status="in_progress". Inapoisha, rekodi husasishwa kwa end_reason, duration_seconds, billable_minutes, na (hatimaye) URL ya rekodi na tathmini ya AI.

5. Kagua matokeo#

Pata orodha ya simu za hivi karibuni:

curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Pata nakala ya mazungumzo:

curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Na URL ya rekodi (ya muda mfupi, iliyotiwa sahihi):

curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Ikiwa umejiandikisha kwa telephony.complete webhook utapokea data hiyo hiyo kama POST kwenye seva yako — tazama call.complete.

Hatua zinazofuata#