---
title: "Shughulikia simu zinazoingia (API)"
description: "Hatua zote: sanidi ejenti, ipe nambari ya simu, pokea simu, na kagua nakala ya mazungumzo."
---

<Note>
  Unaunda ejenti yako ya kwanza mwenyewe? Dashibodi inaongoza mtiririko huu
  mahususi — unda ejenti, ongeza nambari, iga, kagua — kwa kutumia
  mwongozo elekezi. Anza kwenye
  [mwongozo wa haraka wa dashibodi](/sw/quickstart-dashboard).
</Note>

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](/api-reference/agents) kwa kila uga wa usanidi;
kiwango cha chini ni:

```bash
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.

<Tip>
  Chagua `spark` kwa maswali na majibu rahisi kwa gharama ya chini zaidi, na `bolt` pale kasi
  inapokuwa muhimu zaidi. Pandisha hadi `storm-base-with-ack` wakati prompt yako
  inahitaji uelekezaji wa kina zaidi na inaweza kuvumilia kijazo cha nusu sekunde
  huku modeli ikifikiri. Tazama
  [viwango vya bidhaa](/api-reference/agents#product-tiers-at-a-glance).
</Tip>

## 2. Pata nambari ya simu

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

```bash
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}`](/api-reference/phone-numbers#retrieve-a-phone-number)
ili kufuatilia mabadiliko hayo ikiwa ni muhimu kwako.

<Note>
  Nambari za ThunderPhone ni za simu zinazoingia pekee. Kwa simu zinazotoka,
  [leta nambari zako kupitia VoIP](/sw/guides/bring-your-own-numbers).
</Note>

## 3. Mpe ejenti jukumu

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

```bash
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`](/api-reference/calls#list-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:

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

Pata nakala ya mazungumzo:

```bash
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):

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

Ikiwa umejiandikisha kwa
[`telephony.complete` webhook](/sw/webhooks/events)
utapokea data hiyo hiyo kama POST kwenye seva yako — tazama
[call.complete](/sw/webhooks/call-complete).

---

## Hatua zinazofuata

<CardGroup cols={2}>
  <Card title="Usanidi thabiti kwa kila simu" icon="bolt" href="/sw/guides/dynamic-call-config">
    Chagua ejenti tofauti kwa kila mpigaji kulingana na nambari ya simu au
    mantiki maalum katika webhook.
  </Card>
  <Card title="Ongeza miunganisho ya zana" icon="screwdriver-wrench" href="/sw/guides/build-tool-integration">
    Ruhusu ejenti iite API zako katikati ya mazungumzo.
  </Card>
  <Card title="Hamisha simu" icon="phone-arrow-right" href="/sw/guides/call-transfers">
    Elekeza wapigaji moja kwa moja au hakiki mpokeaji kabla ya kuwaunganisha.
  </Card>
  <Card title="Pokea webhook za call.complete" icon="bolt" href="/sw/webhooks/call-complete">
    Tuma kila simu iliyokamilika kwenye mtiririko wako wa CRM / uchanganuzi.
  </Card>
  <Card title="Upangaji alama wa AI na ripoti za matatizo" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    Panga alama za kila simu kiotomatiki na elekeza zilizoalamishwa ili zikaguliwe.
  </Card>
</CardGroup>