Open in
Zoom Contact Center
Zoom Contact Center çağrılarını üçüncü taraf sesli bot bağlayıcısıyla bir ThunderPhone yapay zeka ajanına yönlendirin ve SIP REFER ile yeniden bir insan ajana aktarın.
Zoom Contact Center akışınızdaki bir Bot bileşeni, arayanı Zoom'un çağrı sid'si ile sesli AI ajanına gönderir. Arayanın bir insana ihtiyacı olduğunda, ajan Zoom'un insan ajan adresine SIP REFER gönderir ve akışınız çağrı sid'si ile aktarmayı alır.
Başlamadan önce
- Bir ThunderPhone ajanı ve kuruluşunuz için bir API anahtarı.
- Yöneticiniz tarafından yönetilen ve Contact Center için kullanılabilir hale getirilen, Bot bileşeni için bir bağlayıcı içeren bir Zoom Marketplace Genel Uygulaması (Zoom'un üçüncü taraf ses botu kılavuzu).
- Zoom'dan bot sağlayıcısına bir SIP trunk'ı. Zoom'un ISV ekibi bunu aşamalı olarak oluşturur (keşif, hazırlık trunk'ı ve ardından üretim) ve uygulamanın Şirket Adı, trunk kaydıyla tam olarak eşleşmelidir. Bu kurulum yalnızca Zoom hesabınızda değil, ThunderPhone desteği ve Zoom ile başlar.
1. SIP uç noktasını oluşturun
Zoom'un bağlayıcısı, SIP adresi yerine 999 ile başlayan 15 haneli bir numarayı arar. Bağlayıcıyı kaydetmek bu numarayı oluşturur. Zoom'un trunk'ı, ses için SRTP ile 5061 numaralı bağlantı noktasında TLS 1.2 kullanır ve parola yerine Zoom'un alt ağları tarafından izin listesine alınır. Bu nedenle, bağlayıcının numarasını arama numarası olarak kullanarak ve SRTP'yi zorunlu tutarak bir ip_allowlist uç noktası oluşturun (bkz.
Telefon numarası arayan platformlar):
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: Zoom'dan alınan Zoom SIP sinyalleşme alt ağları. Her biri/16veya daha dar bir genel IPv4 aralığı (/48veya daha dar IPv6) olmalıdır.dial_in_numbers:+olmadan, Zoom'un gönderdiği biçimiyle bağlayıcının numarası.srtp: Zoom'un trunk'ı her zaman SRTP kullandığı içinrequired.
Zoom'un adresleri tüm müşterileri tarafından paylaşılır; bu nedenle numarayı arayan başka herhangi bir Zoom müşterisi ajanınıza ulaşır. Numarayı Zoom atar; yayımlamayın.
2. Aramaları bağlamla gönderin
Akışınıza bir Bot bileşeni ekleyin ve bunu bağlayıcıya bağlayın. Zoom'un ISV ekibinden trunk'ı, 5061 numaralı bağlantı noktasında TLS kullanarak sip.thunderphone.com adresine yönlendirmesini isteyin; bağlayıcının numarası hem istek URI'sinde hem de To başlığında bulunmalıdır. Uç nokta UDP'yi reddeder; bu nedenle trunk'ın UDP'ye geri dönmediğinden emin olun.
Zoom şunları gönderir:
- Çağrının
external_call_idalanı olarak depolananX-ZOOM-Call-Sid. Zoom'un kendi veri eşleme sayfasında bu listelenmez; başka bir AI sağlayıcısının Zoom entegrasyonu bunu belgeliyor, bu yüzden ilk test aramanızda kontrol edin. - Arayanın çevirdiği numara olan
X-ZOOM-DNIS,{{sip_x_zoom_dnis}}olarak. - Bağlayıcının Statik URL'si olan
X-ZOOM-WEBHOOK.
3. Aramayı geri alın
Sesli AI ajanı, Zoom'un SBC'sindeki insan operatörü adresine bir REFER gönderir. Zoom'un size verdiği SBC adresiyle bu aktarım numarasını ekleyin (bkz.
Aktarım numarasını ekleme):
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}Zoom'un kılavuzu, bir botun bağlamı iletmesinin iki yolunu açıklar: REFER öncesinde bağlayıcının Statik URL'sine yapılan bir POST (voicebot_metadata ve benzer
olaylar) ve Bottan Gelen altında eşlenen SIP üst bilgileri. ThunderPhone,
Statik URL'ye gönderim yapmaz. Zoom'un kılavuzu, bir REFER içindeki eşlenmiş
üst bilgileri okuyup okumadığını belirtmez; denemek isterseniz girdiye
"X-Handoff-Id": "{{handoff_id}}" gibi headers ekleyin ve bir test aramasında
kontrol edin. Ayrıca, Zoom'un öncesinde meta veri POST'u olmadan bir REFER
kabul ettiğini teyit edin.
Aktarımı bunların hiçbirine bağlı kalmadan almak için, akışınızın Bot bileşeninden sonra bir HTTP Çağrısı veya Komut Dosyası bileşeniyle sorgulama yapmasını sağlayın:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ve ardından arama sid'si.Authorization: Bearer sk_live_…üst bilgisi.- Arayanı yönlendirmek ve aramayı alan kişiye özet bilgi vermek için
handoff.summaryvehandoff.intentkullanın.
Zoom, bu bileşenler için alan düzeyinde dokümantasyon yayımlamaz; bu nedenle
bileşenin bir Authorization üst bilgisi gönderebildiğini hesabınızda teyit
edin. Bkz.
Aktarılan bir aramayı sorgulama.
Test edin
Bot bileşenine ulaşan bir numarayı arayın, sesli AI ajanından bir insana
aktarılmayı isteyin ve arayanın bir insana ulaştığını ve bileşenin aktarımı
döndürdüğünü kontrol edin. Ardından aramayı GET /v1/calls/{call_id} ile açın:
sip_headers, x-zoom-call-sid değerini listelemeli ve external_call_id,
akışınızın kullandığı arama sid'siyle eşleşmelidir.
Sınırlar
- ThunderPhone, bağlayıcının Statik URL'sine gönderim yapmaz; bu nedenle Zoom,
aktarımı sorgulama yoluyla veya testiniz Zoom'un bunları
REFERiçinden okuduğunu gösterirse eşlenmiş üst bilgileri aracılığıyla alır. - Trunk, Zoom'un ISV ekibi tarafından oluşturulur; bu nedenle onu kendiniz kuramaz veya test edemezsiniz.