---
title: "Σύνδεση από το Zoom Contact Center"
description: "Στείλτε κλήσεις του Zoom Contact Center σε έναν πράκτορα ThunderPhone με έναν σύνδεσμο φωνητικού bot τρίτου μέρους και μεταφέρετέ τες ξανά σε ανθρώπινο πράκτορα με SIP REFER."
---

Ένα γραφικό στοιχείο ρομπότ στη ροή Zoom Contact Center στέλνει τον καλούντα στον πράκτορα με το αναγνωριστικό κλήσης του Zoom. Όταν ο καλών χρειάζεται άνθρωπο, ο πράκτορας στέλνει ένα SIP `REFER`
στη διεύθυνση ανθρώπινου πράκτορα του Zoom και η ροή σας ανακτά την προώθηση με το αναγνωριστικό κλήσης.

## Πριν ξεκινήσετε

- Έναν πράκτορα ThunderPhone και ένα [κλειδί API](/el/guides/api-keys) οργανισμού.
- Μια **Γενική εφαρμογή** του Zoom Marketplace, που διαχειρίζεται ο διαχειριστής σας και είναι διαθέσιμη
  στο Contact Center, με έναν σύνδεσμο για το γραφικό στοιχείο ρομπότ
  ([οδηγός φωνητικών bot τρίτων του Zoom](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- Έναν κορμό SIP από το Zoom προς τον πάροχο bot. Η ομάδα ISV του Zoom τον δημιουργεί
  σταδιακά (διερεύνηση, κορμός προετοιμασίας και έπειτα παραγωγή), και το Όνομα
  εταιρείας της εφαρμογής πρέπει να αντιστοιχεί ακριβώς στην εγγραφή του κορμού. Αυτή η ρύθμιση ξεκινά με την υποστήριξη του ThunderPhone
  και το Zoom, όχι μόνο στον λογαριασμό σας στο Zoom.

## 1. Δημιουργήστε το τελικό σημείο SIP

Ο σύνδεσμος του Zoom καλεί έναν 15ψήφιο αριθμό που αρχίζει με `999`, όχι μια διεύθυνση SIP. Η αποθήκευση του συνδέσμου δημιουργεί αυτόν τον αριθμό. Ο κορμός του Zoom χρησιμοποιεί TLS 1.2
στη θύρα 5061 με SRTP για ήχο και επιτρέπεται βάσει λίστας από τα υποδίκτυα του Zoom αντί για κωδικό πρόσβασης. Επομένως, δημιουργήστε ένα τελικό σημείο `ip_allowlist` με τον αριθμό του συνδέσμου ως αριθμό εισερχόμενης κλήσης και με υποχρεωτικό SRTP (βλ.
[Πλατφόρμες που καλούν έναν αριθμό τηλεφώνου](/el/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`: τα υποδίκτυα σηματοδότησης SIP του Zoom, τα οποία παρέχει το Zoom. Κάθε ένα πρέπει
  να είναι δημόσιο εύρος IPv4 `/16` ή στενότερο (IPv6 `/48` ή στενότερο).
- `dial_in_numbers`: ο αριθμός του συνδέσμου ακριβώς όπως τον στέλνει το Zoom, χωρίς
  `+`.
- `srtp`: `required`, επειδή ο κορμός του Zoom χρησιμοποιεί πάντα SRTP.

Οι διευθύνσεις του Zoom είναι κοινές για όλους τους πελάτες του, επομένως οποιοσδήποτε άλλος πελάτης του Zoom
που καλεί τον αριθμό φτάνει στον πράκτορά σας. Το Zoom εκχωρεί τον αριθμό· μην
τον δημοσιεύετε.

## 2. Στείλτε κλήσεις με περιβάλλον

Προσθέστε ένα γραφικό στοιχείο **ρομπότ** στη ροή σας και συσχετίστε το με τον σύνδεσμο. Ζητήστε από την ομάδα ISV του Zoom
να κατευθύνει τον κορμό στο `sip.thunderphone.com`, με TLS στη θύρα 5061 και με τον
αριθμό του συνδέσμου τόσο στο URI αιτήματος όσο και στην κεφαλίδα `To`. Το τελικό σημείο
αρνείται το UDP, επομένως βεβαιωθείτε ότι ο κορμός δεν επιστρέφει σε αυτό.

Το Zoom στέλνει:

- `X-ZOOM-Call-Sid`, που αποθηκεύεται ως το `external_call_id` της κλήσης. Η σελίδα αντιστοίχισης δεδομένων του ίδιου του Zoom
  δεν το παραθέτει· η ενσωμάτωση Zoom άλλου παρόχου AI το τεκμηριώνει,
  επομένως ελέγξτε το στην πρώτη δοκιμαστική κλήση σας.
- `X-ZOOM-DNIS`, τον αριθμό που κάλεσε ο καλών, ως `{{sip_x_zoom_dnis}}`.
- `X-ZOOM-WEBHOOK`, το Στατικό URL του συνδέσμου.

## 3. Επαναφέρετε την κλήση

Ο πράκτορας στέλνει ένα `REFER` στη διεύθυνση του ανθρώπινου πράκτορα στο SBC του Zoom. Προσθέστε αυτόν τον αριθμό μεταβίβασης (δείτε
[Προσθέστε τον αριθμό μεταβίβασης](/el/guides/contact-centers/overview)),
με τη διεύθυνση SBC που σας δίνει το Zoom:

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

Ο οδηγός του Zoom περιγράφει δύο τρόπους με τους οποίους ένα ρομπότ μεταβιβάζει το περιεχόμενο: ένα `POST` στο Στατικό URL του
συνδέσμου πριν από το `REFER` (το `voicebot_metadata` και παρόμοια
συμβάντα), και κεφαλίδες SIP που αντιστοιχίζονται στην ενότητα **Εισερχόμενα από ρομπότ**. Το ThunderPhone
δεν δημοσιεύει στο Στατικό URL. Ο οδηγός του Zoom δεν αναφέρει αν διαβάζει
αντιστοιχισμένες κεφαλίδες από ένα `REFER`; αν θέλετε να το δοκιμάσετε, προσθέστε `headers` όπως
`"X-Handoff-Id": "{{handoff_id}}"` στην καταχώριση και ελέγξτε σε μια δοκιμαστική κλήση. Επίσης,
επιβεβαιώστε με το Zoom ότι δέχεται ένα `REFER` χωρίς `POST` μεταδεδομένων πριν από αυτό.

Για να λάβετε τη μεταβίβαση χωρίς να βασίζεστε σε κανένα από τα δύο, ζητήστε από τη ροή σας να την αναζητήσει μετά
από το γραφικό στοιχείο Bot, με ένα γραφικό στοιχείο **Κλήση HTTP** ή **Δέσμη ενεργειών**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  ακολουθούμενο από το SID της κλήσης.
- Κεφαλίδα `Authorization: Bearer sk_live_…`.
- Χρησιμοποιήστε τα `handoff.summary` και `handoff.intent` για να δρομολογήσετε τον καλούντα και να ενημερώσετε
  το άτομο που αναλαμβάνει την κλήση.

Το Zoom δεν δημοσιεύει τεκμηρίωση σε επίπεδο πεδίων για αυτά τα γραφικά στοιχεία, επομένως επιβεβαιώστε στον
λογαριασμό σας ότι το γραφικό στοιχείο μπορεί να στείλει κεφαλίδα `Authorization`. Δείτε
[Αναζητήστε μια μεταβιβασμένη κλήση](/api-reference/calls#look-up-a-handed-off-call).

## Δοκιμάστε το

Καλέστε έναν αριθμό που φτάνει στο γραφικό στοιχείο Bot, ζητήστε από τον πράκτορα να σας συνδέσει με κάποιο άτομο και ελέγξτε
ότι ο καλών φτάνει σε ανθρώπινο πράκτορα και ότι το γραφικό στοιχείο επιστρέφει τη μεταβίβαση. Στη συνέχεια,
ανοίξτε την κλήση με `GET /v1/calls/{call_id}`: το `sip_headers` θα πρέπει να εμφανίζει
το `x-zoom-call-sid`, και το `external_call_id` θα πρέπει να αντιστοιχεί στο SID κλήσης που χρησιμοποιεί η ροή σας.

## Περιορισμοί

- Το ThunderPhone δεν δημοσιεύει στο Στατικό URL του συνδέσμου, επομένως το Zoom λαμβάνει τη
  μεταβίβαση μέσω της αναζήτησης ή μέσω αντιστοιχισμένων κεφαλίδων, αν η δοκιμή σας δείξει ότι το
  Zoom τις διαβάζει από το `REFER`.
- Η ζεύξη έχει δημιουργηθεί από την ομάδα ISV του Zoom, επομένως δεν μπορείτε να τη ρυθμίσετε ή να τη δοκιμάσετε
  μόνοι σας.
