---
title: "Hamisha simu"
description: "Elekeza wapigaji simu kwa uhamisho wa moja kwa moja au mhakiki mpokeaji kwanza kwa uhamisho wa kushauriana."
---

Kila ejenti ya simu ina kitendo cha `transfer_call` kilichojengewa ndani. Iambie ejenti
katika prompt yake wakati wa kuhamisha, nambari ya kutumia, na kama makabidhiano
yanapaswa kuwa ya baridi au ya joto.

| Hali | Kinachotokea | Itumie wakati |
| --- | --- | --- |
| **Baridi** | Mpigaji hutumwa moja kwa moja kwenye lengwa. Ejenti haimtambulishi mpigaji wala kuthibitisha kuwa kuna mtu atakayejibu. | Uelekezaji wa haraka ni muhimu zaidi kuliko makabidhiano yaliyochujwa, au simu inatumia nambari iliyotolewa na ThunderPhone. |
| **Joto** | Mpigaji husubiri huku ejenti ikipiga simu kwa faragha na kuchunguza lengwa. Wahusika huunganishwa tu ikiwa lengwa linakubali. | Lengwa linahitaji muktadha kabla ya kukubali, au mpigaji anapaswa kurejea kwa ejenti wakati hakuna anayepatikana. |

Ikiwa ejenti haitaji hali, uhamisho huwa wa baridi.

## Sanidi uhamisho

Kwenye dashibodi:

1. Fungua **Ejenti za sauti**, chagua ejenti, kisha ufungue **Usanidi**.
2. Kwenye prompt, ongeza kila lengwa, sharti lake la uelekezaji, na kama utatumia
   hali ya `cold` au `warm`. Huhitaji kuwezesha kigeuzi tofauti cha uhamisho au
   kuunda zana maalum.
3. Ikihitajika, weka **Mipangilio ya kina → Muda wa kuita** kutoka sekunde 5 hadi 120.
4. Chagua **Tekeleza**.

Kwa API, tumia `PATCH /v1/agents/{agent_id}` kuweka prompt na
`ring_duration_seconds` ya hiari katika rasimu, kisha `POST /v1/agents/{agent_id}/deploy`. Tazama
[API ya Ejenti](/api-reference/agents#update-an-agent-writes-the-draft).

## Kinachotokea wakati wa uhamisho wa joto

1. Ejenti humwambia mpigaji kuwa inaanza uhamisho.
2. Mpigaji husikia muziki wa kusubiri. Mpigaji hawezi kusikia simu ya lengwa
   ikiita au mazungumzo ya faragha.
3. ThunderPhone hupigia lengwa kutoka nambari ya VoIP inayoshughulikia simu. Ejenti
   huwasilisha `screen_message` yake, ambayo inapaswa kumtambulisha ejenti, kutaja
   jina la mpigaji, kueleza sababu ya simu, na kuuliza kama lengwa linaweza
   kuipokea.
4. Lengwa linaweza kuuliza maswali kabla ya kuamua. Ejenti hujibu kwa kutumia
   mazungumzo ya awali na prompt yake huku mpigaji akiendelea kusubiri.
5. Lengwa likikubali, mpigaji huondolewa kwenye kusubiri na watu wote wawili husikia
   `introduction` fupi. Ejenti huondoka kiotomatiki. Watu hao wawili hubaki
   wameunganishwa.

Ikiwa lengwa linakataa, halijibu, au simu inaenda kwenye barua ya sauti, ThunderPhone
huondoa simu hiyo ya faragha na kumwondoa mpigaji kwenye kusubiri. Ejenti hupokea
matokeo na kuendelea na mazungumzo ya awali. Inaweza kupokea ujumbe, kupendekeza
njia nyingine, au kufanya uhamisho wa baridi ikiwa mpigaji bado anautaka. Uhamisho
wa joto hauachi ujumbe wa sauti. Ikiwa lengwa linaomba ejenti iwasilishe ujumbe,
matokeo ya zana huujumuisha kama `relay_message_for_caller`.

<Note>
  Ikiwa tangazo la idhini la ejenti limewezeshwa, lengwa la uhamisho husikia
  tangazo hilo kabla ya mazungumzo ya uchunguzi wa faragha kuanza. Mpigaji
  anayesubiri halisikii kwa mara ya pili.
</Note>

## Andika prompt ya ejenti ili kuhamisha simu vizuri

Weka sheria za uelekezaji katika prompt ya ejenti. Tumia muundo wa E.164: `+`, msimbo wa nchi,
na nambari kamili ya kitaifa, kama vile `+14155550123`. Bainisha hali ya uhamisho
kwa kila njia na mpe ejenti njia mbadala kwa uhamisho wa kushauriana unaoshindikana.

```text
Transfer policy

Confirm the caller's name and reason for calling before any transfer.

| Caller needs | Destination | Transfer mode |
| --- | --- | --- |
| A new purchase or plan change | +14155550123 | warm |
| Help with an existing order | +14155550124 | warm |
| The main office | +14155550125 | cold |

For a warm transfer:
- In the private screen message, identify yourself, give the caller's name and
  a one-sentence reason for the call, then ask whether the target can take it.
- Answer reasonable questions from the target using the conversation context.
- If the target accepts, introduce both people in one short sentence. Do not
  plan to speak after the introduction because you will be dropped.
- If the target declines, does not answer, or reaches voicemail, tell the
  caller what happened. Relay any message from the target, then offer to take
  a message or try another route. Do not cold-transfer unless the caller asks.
```

Ejenti hutoa sehemu hizi inapoitisha kitendo kilichojengwa ndani:

| Sehemu | Hutumika lini | Kusudi |
| --- | --- | --- |
| `phone_number` | Daima | Nambari lengwa katika muundo wa E.164. |
| `mode` | Hiari | `cold` au `warm`; chaguo-msingi ni `cold`. |
| `screen_message` | Inahitajika kwa warm | Ujumbe wa mwanzo unaosikika kwa faragha na mpokeaji. |
| `introduction` | Inahitajika kwa warm | Mstari mmoja mfupi unaosikika na pande zote baada ya mpokeaji kukubali. |

Huhitaji kufafanua au kuambatisha zana maalum inayoitwa `transfer_call`.

## Uhamisho wa kunong'ona

“Uhamisho wa kunong'ona” ni jina la kawaida katika tasnia kwa uhamisho wa kushauriana ambapo
mpokeaji husikia muktadha wa faragha kabla ya mpigaji kuunganishwa. Katika
ThunderPhone, `screen_message` ya uhamisho wa kushauriana hutoa maelezo hayo ya faragha. Mpokeaji anaweza kisha kumuuliza ejenti maswali ya ufuatiliaji kabla ya kukubali
au kukataa.

Hii ni tofauti na
[`POST /v1/calls/{id}/whisper`](/sw/guides/monitor-live-calls).
Endpoint hiyo humruhusu mfanyakazi au mmiliki kutuma mwongozo wa faragha kwa maandishi kwa ejenti ya AI
wakati wa simu inayoendelea. Haiiti au kumpa maelezo mpokeaji wa uhamisho.

## Mahitaji, vikomo, na majaribio

| Swali | Jibu |
| --- | --- |
| Ni nambari zipi zinatumia uhamisho wa awali? | Nambari iliyothibitishwa iliyoingizwa kupitia muunganisho wa VoIP unaoweza kupiga simu za kutoka. Nambari zinazotolewa na ThunderPhone zinatumia uhamisho wa moja kwa moja pekee. Ikiwa hali ya awali haipatikani, kitendo hurudi kwenye uhamisho wa moja kwa moja. [Unganisha mtoa huduma wa VoIP](/sw/guides/voip-providers). |
| Ni aina zipi za simu zinatumia hii? | Uhamisho wa moja kwa moja unapatikana kwenye simu za kawaida. Browser Talk, wijeti, uigaji, na simu za majaribio haziwezi kupima uhamishaji wa awali. Realtime ya ejenti iliyohifadhiwa haijumuishi `transfer_call`; Realtime ya ndani ya mstari yenye `call_events` inaweza kuomba uhamisho wa moja kwa moja. |
| Ninaijaribuje? | Kagua lugha ya uelekezaji katika Browser Talk au uigaji, kisha jaribu uhamishaji kamili kwenye simu halisi ukitumia nambari inayostahiki ya VoIP iliyoingizwa. |
| Nambari lengwa hulia kwa muda gani? | `ring_duration_seconds` inakubali sekunde 5–120. `null` hutumia sekunde 45 kwa uhamisho wa awali na chaguo-msingi la mtoa huduma kwa uhamisho wa moja kwa moja. Simu za kawaida za kutoka hutumia sekunde 60 kwa chaguo-msingi. Mpangilio huu haubadilishi mlio wa simu zinazoingia. |
| Daraja la mawasiliano kati ya watu linaweza kudumu kwa muda gani? | Hadi dakika 60 baada ya ejenti kuwaunganisha watu hao wawili. |
| Nini hutokea ikishindikana? | Ikiwa lengwa linakataa, halijibu, linafikia ujumbe wa sauti, au upande wa simu ya kutoka unashindwa, mpigaji hurudi kwa ejenti pamoja na matokeo. Prompt inapaswa kubainisha hatua inayofuata. |
| Gharama ni nini? | Hakuna ada ya zana ya uhamisho. Gharama za kawaida za simu zinajumuisha mtiririko wa uhamisho wa awali hadi utangulizi ukamilike, kisha upimaji wa ThunderPhone husimama ejenti wa AI anapoondoka. Mtoa huduma wako anaweza kuendelea kutoza upande wa uhamisho wa kutoka huku watu hao wawili wakiendelea kuunganishwa. |

## Webhook na sababu za kumaliza

Payload ya ukamilishaji hurekodi lengwa katika `transfer_number` na hutumia
moja ya sababu hizi za kumaliza:

| `end_reason` | Maana |
| --- | --- |
| `ai_transfer` | Ejenti ilianzisha uhamisho wa moja kwa moja. |
| `ai_warm_transfer` | Lengwa lilikubali uhamisho wa awali, wahusika waliunganishwa, na ejenti akaondoka baada ya utangulizi. |

Jaribio la awali lililokataliwa, lisilojibiwa, lililoshindwa, au lililofikia
ujumbe wa sauti si uhamisho uliokamilika. Mpigaji hurudi kwa ejenti, hivyo sababu
ya mwisho ya kumaliza huonyesha kinachomaliza simu ya awali.

Kwa uhamisho wa awali uliofaulu, tukio la ukamilishaji na sababu ya kumaliza ya
simu ya AI hurekodiwa utangulizi unapokamilika na AI inapoondoka. Ikiwa kurekodi
kumewezeshwa, sauti huendelea kupitia daraja la mawasiliano kati ya watu hadi
litakapomalizika; usemi baada ya uhamishaji hurekodiwa lakini hauandikwi. Tangazo
la idhini la ejenti linapowezeshwa, lengwa la uhamisho huliskia kabla ya uchujaji
kuanza.

<Accordion title="Webhook ya urithi ya ukamilishaji">
  Webhook ya urithi ya URL moja inaweza kuchelewesha uhamisho wa moja kwa moja kwa hadi dakika tano
  kwa kurudisha `{"transfer_ready": false}` na baadaye kusasisha hali ya
  utayari wa uhamisho wa simu. Uwasilishaji wa endpoint za webhook na uhamisho wa awali hautumii uratibu huu.
</Accordion>

Tazama [Webhook za ukamilishaji](/sw/webhooks/call-complete) kwa payload kamili na
tabia ya urithi.

## Utatuzi wa matatizo

### Ejenti hufanya uhamisho wa moja kwa moja badala ya wa kushauriana

Hakikisha simu inatumia nambari ya VoIP iliyoidhinishwa na kuingizwa, yenye uelekezaji wa simu za kutoka unaofanya kazi. Hali ya kushauriana huondolewa kwenye chaguo za zana kwa nambari za ThunderPhone na vipindi visivyo vya simu. Pia bainisha hali hiyo wazi kwenye jedwali la uelekezaji la prompt.

### Lengwa halijibu kamwe

Thibitisha kwamba trunk yako ya VoIP inaweza kupiga simu za kutoka kwenda lengwa na kwamba sheria zake za uthibitishaji na uelekezaji zimesasishwa. Angalia umbizo la E.164 la lengwa. Ongeza `ring_duration_seconds` ikiwa sekunde 45 ni muda mfupi sana kwa uhamisho wa kushauriana.

### Lengwa linafikia ujumbe wa sauti

Uhamisho wa kushauriana hauachi ujumbe wa sauti. Mpigaji huondolewa kwenye kusubiri na ejenti hupokea matokeo ya `voicemail`. Elekeza ejenti kwenye prompt yake kama ichukue ujumbe, ijaribu lengwa lingine, au itoe uhamisho wa moja kwa moja.

### Mpigaji hapokei ujumbe wa lengwa

Elekeza ejenti kuwasilisha `relay_message_for_caller` kabla ya kutoa hatua zinazofuata. Sehemu hiyo hupatikana tu wakati lengwa linakataa na kuomba ejenti ipitishe ujumbe.

### Uhamisho wa moja kwa moja husubiri kabla ya kuunganishwa

Ikiwa unatumia webhook ya zamani ya URL moja, angalia kama ilirudisha
`{"transfer_ready": false}`. Mpigaji husikia muziki wa kusubiri huku ThunderPhone ikisubiri. Sasisha hali ya utayari wa uhamisho wa simu wakati lengwa limeandaliwa.

### Kunong'oneza kwa wafanyakazi hakuanzishi uhamisho

Kunong'oneza kwenye simu mubashara humwelekeza tu ejenti wa AI. Ongeza maelekezo ya uhamisho kwenye prompt ya ejenti na uiruhusu iite `transfer_call`. Tazama
[Fuatilia simu mubashara](/sw/guides/monitor-live-calls).