---
title: "Opret forbindelse fra Zoom Contact Center"
description: "Send opkald fra Zoom Contact Center til en ThunderPhone-agent med et tredjeparts-stemmebotstik, og send dem tilbage til en menneskelig agent med en SIP REFER."
---

En Bot-widget i dit Zoom Contact Center-flow sender opkalderen til agenten med
Zooms opkalds-SID. Når opkalderen har brug for en person, sender agenten en SIP `REFER`
til Zooms adresse for menneskelige agenter, og dit flow henter overdragelsen efter opkalds-SID.

## Før du starter

- En ThunderPhone-agent og en organisations-[API-nøgle](/da/guides/api-keys).
- En Zoom Marketplace **Generel app**, administreret af din administrator og gjort tilgængelig
  for Contact Center, med en connector til Bot-widgetten
  ([Zooms vejledning til tredjeparts-voicebots](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- En SIP-trunk fra Zoom til botudbyderen. Zooms ISV-team opbygger den i
  faser (afdækning, en staging-trunk og derefter produktion), og appens
  virksomhedsnavn skal matche trunk-posten nøjagtigt. Denne opsætning starter med ThunderPhone
  support og Zoom, ikke kun i din Zoom-konto.

## 1. Opret SIP-slutpunktet

Zooms connector ringer til et 15-cifret nummer, der starter med `999`, ikke en SIP-
adresse. Når connectoren gemmes, genereres dette nummer. Zooms trunk bruger TLS 1.2
på port 5061 med SRTP til lyd og tillades via Zooms undernet frem for med en adgangskode.
Opret derfor et `ip_allowlist`-slutpunkt med connectorens
nummer som indgående opkaldsnummer og med SRTP påkrævet (se
[Platforme, der ringer til et telefonnummer](/da/guides/sip-addresses)):

```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": "Zoom Contact Center",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["999123456789012"],
    "srtp": "required"
  }'
```

- `allowed_source_cidrs`: Zooms SIP-signalunder net, fra Zoom. Hvert skal
  være et offentligt IPv4-interval på `/16` eller smallere (IPv6 `/48` eller smallere).
- `dial_in_numbers`: connectorens nummer præcis som Zoom sender det, uden et
  `+`.
- `srtp`: `required`, da Zooms trunk altid bruger SRTP.

Zooms adresser deles af alle deres kunder, så enhver anden Zoom-kunde,
der ringer til nummeret, når din agent. Zoom tildeler nummeret; offentliggør det ikke.

## 2. Send opkald med kontekst

Tilføj en **Bot**-widget til dit flow, og tilknyt den til connectoren. Bed Zooms ISV-
team om at pege trunken mod `sip.thunderphone.com`, TLS på port 5061, med
connectorens nummer i både anmodnings-URI'en og `To`-headeren. Slutpunktet
afviser UDP, så sørg for, at trunken ikke falder tilbage til det.

Zoom sender:

- `X-ZOOM-Call-Sid`, gemt som opkaldets `external_call_id`. Zooms egen data-
  mapping-side angiver den ikke; en anden AI-udbyders Zoom-integration dokumenterer
  den, så kontrollér den ved dit første testopkald.
- `X-ZOOM-DNIS`, nummeret opkalderen ringede til, som `{{sip_x_zoom_dnis}}`.
- `X-ZOOM-WEBHOOK`, connectorens statiske URL.

## 3. Få opkaldet tilbage

Agenten sender en `REFER` til adressen på den menneskelige agent på Zooms SBC. Tilføj dette
viderestillingsnummer (se
[Tilføj viderestillingsnummeret](/da/guides/contact-centers/overview)),
med den SBC-adresse, Zoom giver dig:

```json
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}
```

Zooms vejledning beskriver to måder, hvorpå en bot videregiver kontekst: en `POST` til
connectorens statiske URL før `REFER` (`voicebot_metadata` og lignende
hændelser) samt SIP-headere, der er knyttet under **Indgående fra bot**. ThunderPhone
sender ikke data til den statiske URL. Zooms vejledning angiver ikke, om den læser
tilknyttede headere fra en `REFER`; hvis du vil prøve det, skal du tilføje `headers` såsom
`"X-Handoff-Id": "{{handoff_id}}"` til posten og kontrollere det med et testopkald. Bekræft også
med Zoom, at den accepterer en `REFER` uden en metadata-`POST` før den.

For at få overdragelsen uden at være afhængig af nogen af delene skal dit flow
slå den op efter Bot-widgetten med en **HTTP-kald**- eller **Script**-widget:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  efterfulgt af opkaldets sid.
- Headeren `Authorization: Bearer sk_live_…`.
- Brug `handoff.summary` og `handoff.intent` til at dirigere opkalderen og orientere
  personen, der tager opkaldet.

Zoom offentliggør ikke dokumentation på feltniveau for disse widgets, så bekræft på
din konto, at widgetten kan sende en `Authorization`-header. Se
[Slå et overdraget opkald op](/api-reference/calls#look-up-a-handed-off-call).

## Test det

Ring til et nummer, der når Bot-widgetten, bed agenten om en person, og kontrollér
at opkalderen når en menneskelig agent, og at widgetten returnerer overdragelsen. Åbn derefter
opkaldet med `GET /v1/calls/{call_id}`: `sip_headers` skal vise
`x-zoom-call-sid`, og `external_call_id` skal matche det opkalds-sid, dit flow
bruger.

## Begrænsninger

- ThunderPhone sender ikke data til connectorens statiske URL, så Zoom får
  overdragelsen via opslaget eller via tilknyttede headere, hvis din test viser,
  at Zoom læser dem fra `REFER`.
- Trunken er opbygget af Zooms ISV-team, så du kan ikke selv opsætte eller teste den.
