---
title: "Unganisha kutoka Amazon Connect"
description: "Tuma simu za Amazon Connect kwa ejenti wa ThunderPhone kupitia SIP pamoja na kitambulisho cha mawasiliano na UUI, kisha endelea na mtiririko wako kwa makabidhiano ya ejenti."
---

Mtiririko wako wa Amazon Connect humtuma mpigaji simu kwa ejenti pamoja na kitambulisho cha mawasiliano na UUI yoyote uliyoweka. Ejenti anapomaliza, hukata simu, mtiririko wako unaendelea, na Lambda huchukua uhamisho kwa kutumia kitambulisho cha mawasiliano.

## Kabla ya kuanza

- Ejenti wa ThunderPhone na [ufunguo wa API](/sw/guides/api-keys) wa shirika.
- Kiunganishi cha **Uhamisho wa sauti wa nje** cha Amazon Connect. Omba kwanza ongezeko la kikomo cha "Viunganishi vya uhamisho wa sauti wa nje kwa kila akaunti": menyu hubaki fiche hadi AWS iidhinishe. AWS hutoza kila kiunganishi kwa siku
  ([$100 kwa siku tangu Julai 21, 2025](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  pamoja na matumizi ya kila dakika.

<Warning>
  Mwongozo wa sasa wa msimamizi wa AWS hauna tena kurasa za uhamisho wa sauti wa nje.
  Kabla ya kuujenga, thibitisha na AWS kwamba kiunganishi kinapatikana kwa
  instansi na Mkoa wako.
</Warning>

## 1. Unda endpoint ya SIP

Kiunganishi hakiandiki uthibitishaji wa SIP digest, kwa hivyo unda endpoint
inayokubali simu kwa anwani chanzo:

```bash
curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": 12,
    "name": "Amazon Connect",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["CONNECT_SIGNALLING_RANGE_1", "CONNECT_SIGNALLING_RANGE_2"]
  }'
```

Pata masafa ya uashiriaji wa SIP ya kiunganishi kwa Mkoa wako kutoka AWS. Kila moja lazima liwe
masafa ya umma ya IPv4 ya `/16` au membamba zaidi (IPv6 `/48` au membamba zaidi). Angalia
[Majukwaa yanayothibitisha kwa IP chanzo](/sw/guides/sip-addresses)
kwa sheria na hatari ya anwani inayoshirikiwa na kila mteja wa
jukwaa. Hifadhi `sip_uri` ya jibu, kwa mfano
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Tuma simu pamoja na muktadha

1. Katika dashibodi ya Amazon Connect, fungua **Mifumo ya Sauti ya Nje → Miunganisho ya
   Uhamisho wa Sauti** kisha uchague **Unda**.
2. Chagua aina ya lengwa (SBC) na uongeze njia ya kutoka yenye host
   `sip.thunderphone.com`, porti `5061` na itifaki TLS. Endpoint inahitaji
   TLS au TCP (porti `5060`) na hukataa UDP. AWS haielezi ni itifaki zipi
   kiunganishi hutoa, kwa hivyo thibitisha na AWS kwamba kinaweza kutumia mojawapo
   yao.
3. Katika mtiririko wako, ongeza bloku ya **Hamisha kwa nambari ya simu** huku **Hamisha kwa**
   ikiwekwa kuwa **Mfumo wa sauti wa nje**, kisha weka:
   - **ARN ya lengwa:** kiunganishi.
   - **Kwa Mtumiaji:** sehemu ya mtumiaji ya `sip_uri` ya endpoint, kama
     `agent-12-jhxmginwjx`.
   - **UUI** (hiari): muktadha wa ejenti. Connect huituma ikiwa imesimbwa kwa hex.
   - **Endelea na mtiririko baada ya kukatwa:** Ndiyo, ili mtiririko uendelee ejenti
     anapokata simu.

Connect hutuma kitambulisho cha mawasiliano katika `X-Amzn-ConnectContactId`. ThunderPhone huhifadhi
hiki kama `external_call_id` ya simu, ambacho ndicho kinachowezesha mtiririko wako kupata simu
baadaye. UUI hufika kwenye prompt kama `{{sip_uui}}`. Miunganisho ya wahusika wengine
huandika header ya kitambulisho cha mawasiliano; nyaraka za AWS zenyewe hazifanyi hivyo, kwa hivyo ikague kwenye simu yako ya kwanza
ya majaribio.

## 3. Rejesha simu

AWS haijaweka wazi njia ya Connect kusoma header kwenye `BYE` au kukubali
`REFER` kutoka kwa ejenti. Kwa hivyo ejenti hurejesha simu: inaaga na
kukata simu, kisha mtiririko wako unaendelea baada ya blok ya uhamisho. Ongeza nambari hii ya uhamisho (tazama [Ongeza nambari ya uhamisho](/sw/guides/contact-centers/overview)):

```json
{"name": "Amazon Connect", "action": "return"}
```

Kisha leta uhamishaji kwa blok ya **Washa kipengele cha AWS Lambda** baada ya
uhamisho. Lambda huitafuta simu kwa kitambulisho cha mawasiliano:

```python
import json
import os
import urllib.error
import urllib.parse
import urllib.request


def lambda_handler(event, context):
    contact_id = event["Details"]["ContactData"]["ContactId"]
    url = "https://api.thunderphone.com/v1/calls/handoff?" + urllib.parse.urlencode(
        {"external_call_id": contact_id}
    )
    request = urllib.request.Request(
        url, headers={"Authorization": "Bearer " + os.environ["THUNDERPHONE_API_KEY"]}
    )
    try:
        with urllib.request.urlopen(request, timeout=5) as response:
            call = json.load(response)
    except (urllib.error.URLError, TimeoutError):
        return {"found": "false"}
    handoff = call.get("handoff") or {}
    return {
        "found": "true",
        "intent": handoff.get("intent") or "",
        "summary": handoff.get("summary") or "",
    }
```

Blok hurejesha ramani tambarare, kwa hivyo mtiririko unaweza kutenganisha kwa
msingi wa `intent` au kuweka `summary` kama sifa ya mawasiliano kwa mtu
anayepokea simu. Endesha blok kwa usawazishaji (hadi sekunde 8) na uhifadhi
ufunguo wa API ukiwa umesimbwa, kwa mfano katika AWS Secrets Manager. Sehemu za
jibu ziko katika
[Tafuta simu iliyohamishwa](/api-reference/calls#look-up-a-handed-off-call).

## Ijaribu

Piga nambari kwenye instansi yako ya Connect inayofikia blok ya uhamisho, omba
ejenti akuunganishe na mtu, na uhakikishe kwamba mtiririko unaendelea. Kisha
fungua simu kwa `GET /v1/calls/{call_id}`: `sip_headers` inapaswa kuorodhesha
`x-amzn-connectcontactid`, na `external_call_id` inapaswa kuwa sawa na `ContactId`
ambayo Lambda yako inapokea. Ikiwa uhamisho unashindwa kwa SIP `404`, ThunderPhone
haikupata sehemu ya mtumiaji ya endpoint: lazima iwe katika URI ya ombi na header
ya `To`.

## Vikomo

- AWS haijaweka wazi njia ya kusoma header kwenye `BYE`, ikijumuisha
  `X-TP-Handoff-Id`, kwa hivyo kitambulisho cha mawasiliano ndicho kiungo pekee
  cha kurejea kwenye simu.
- AWS haijaweka wazi urefu wa juu zaidi wa UUI kwa kiunganishi.
- Blok ya Lambda ya usawazishaji huisha muda baada ya sekunde 8.
