Shughulikia simu zinazoingia (API)

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

1. Unda ejenti yenye prompt na sauti.
2. Toa (au leta) nambari ya simu na umteue ejenti kama kishughulikiaji chake cha 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 huunganisha prompt, sauti, na kiwango cha bidhaa vitakavyoendesha simu. Tazama Ejenti kwa kila sehemu ya 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 simu, toa nambari ya majaribio kutoka kwenye hazina ya 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 majaribio huanza katika status="provisioning" na kuwa active ndani ya sekunde chache — tuma ombi mara kwa mara kwa GET /v1/phone-numbers/{id} ili kufuatilia mabadiliko hayo ikiwa unahitaji.

3. Mteue ejenti

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 tu — nambari iko hewani. Unaweza pia kuweka outbound_agent_id katika PATCH hiyo hiyo ili nambari iwe tayari kupiga simu za kutoka pia.

4. Pokea simu

Piga nambari hiyo kutoka kwenye simu yako. Ejenti anapokea, anajitambulisha kulingana na prompt yako, na mazungumzo yanaanza.

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 umejisajili kwa webhook ya telephony.complete utapokea data hiyo hiyo kama POST kwenye seva yako — tazama call.complete.

Hatua zinazofuata