ThunderPhone v3 już działa.Uruchom samodzielnie, od 2¢/min.Przeczytaj komunikat

Contact centers

Połącz z Zoom Contact Center

Przekazuj połączenia Zoom Contact Center do agenta ThunderPhone za pomocą zewnętrznego łącznika voicebota, a następnie przekierowuj je z powrotem do agenta ludzkiego za pomocą SIP REFER.

Widżet Bot w przepływie Zoom Contact Center przekazuje rozmówcę do agenta wraz z identyfikatorem sid połączenia Zoom. Gdy rozmówca potrzebuje człowieka, agent wysyła SIP REFER na adres agenta ludzkiego Zoom, a przepływ pobiera przekazanie rozmowy według identyfikatora sid połączenia.

Przed rozpoczęciem

  • Agent ThunderPhone i organizacyjny klucz API.
  • Aplikacja ogólna Zoom Marketplace, zarządzana przez administratora i udostępniona dla Contact Center, z konektorem dla widżetu Bot (przewodnik Zoom dotyczący zewnętrznego voicebota).
  • Łącze SIP z Zoom do dostawcy bota. Zespół ISV Zoom tworzy je etapami (rozpoznanie, łącze testowe, a następnie produkcyjne), a nazwa firmy aplikacji musi dokładnie odpowiadać wpisowi łącza. Ta konfiguracja rozpoczyna się ze wsparciem ThunderPhone i Zoom, a nie wyłącznie na koncie Zoom.

1. Utwórz punkt końcowy SIP

Konektor Zoom wybiera 15-cyfrowy numer rozpoczynający się od 999, a nie adres SIP. Zapisanie konektora generuje ten numer. Łącze Zoom używa TLS 1.2 na porcie 5061 z SRTP dla dźwięku i jest dopuszczane na podstawie podsieci Zoom, a nie hasła. Dlatego utwórz punkt końcowy ip_allowlist z numerem konektora jako numerem dostępowym i wymaganym SRTP (zobacz Platformy wybierające numer telefonu):

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: podsieci sygnalizacji SIP Zoom, przekazane przez Zoom. Każda musi być publicznym zakresem IPv4 /16 lub węższym (IPv6 /48 lub węższym).
  • dial_in_numbers: numer konektora dokładnie w formacie wysyłanym przez Zoom, bez +.
  • srtp: required, ponieważ łącze Zoom zawsze używa SRTP.

Adresy Zoom są współdzielone przez wszystkich jego klientów, więc każdy inny klient Zoom, który wybierze ten numer, połączy się z Twoim agentem. Zoom przypisuje ten numer; nie publikuj go.

2. Wysyłaj połączenia z kontekstem

Dodaj widżet Bot do przepływu i powiąż go z konektorem. Poproś zespół ISV Zoom, aby skierował łącze do sip.thunderphone.com, z TLS na porcie 5061 oraz numerem konektora zarówno w URI żądania, jak i w nagłówku To. Punkt końcowy odrzuca UDP, dlatego upewnij się, że łącze nie przełącza się na ten protokół awaryjnie.

Zoom wysyła:

  • X-ZOOM-Call-Sid, zapisywany jako external_call_id połączenia. Strona Zoom dotycząca mapowania danych go nie wymienia; dokumentacja integracji Zoom innego dostawcy AI go opisuje, dlatego sprawdź go podczas pierwszego połączenia testowego.
  • X-ZOOM-DNIS, numer wybrany przez rozmówcę, jako {{sip_x_zoom_dnis}}.
  • X-ZOOM-WEBHOOK, statyczny adres URL konektora.

3. Odbierz połączenie zwrotne

Agent wysyła REFER na adres ludzkiego agenta w SBC Zoom. Dodaj ten numer przekierowania (zobacz Dodaj numer przekierowania), wraz z adresem SBC podanym przez Zoom:

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

Przewodnik Zoom opisuje dwa sposoby przekazywania kontekstu przez bota: POST do statycznego adresu URL konektora przed REFER (zdarzenia voicebot_metadata i podobne) oraz nagłówki SIP mapowane w sekcji Przychodzące od bota. ThunderPhone nie wysyła żądań do statycznego adresu URL. Przewodnik Zoom nie określa, czy odczytuje mapowane nagłówki z REFER; jeśli chcesz to sprawdzić, dodaj do wpisu headers, takie jak "X-Handoff-Id": "{{handoff_id}}", i sprawdź podczas połączenia testowego. Potwierdź też z Zoom, że akceptuje REFER bez poprzedzającego go POST z metadanymi.

Aby uzyskać przekazanie bez polegania na żadnym z tych sposobów, skonfiguruj przepływ tak, aby wyszukiwał je po widżecie Bot, używając widżetu Wywołanie HTTP lub Skrypt:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= po którym następuje SID połączenia.
  • Nagłówek Authorization: Bearer sk_live_….
  • Użyj handoff.summary i handoff.intent, aby skierować rozmówcę i przekazać informacje osobie odbierającej połączenie.

Zoom nie publikuje dokumentacji na poziomie pól dla tych widżetów, dlatego potwierdź na swoim koncie, że widżet może wysłać nagłówek Authorization. Zobacz Wyszukaj przekazane połączenie.

Przetestuj

Zadzwoń na numer, który prowadzi do widżetu Bot, poproś agenta o połączenie z osobą i sprawdź, czy rozmówca trafia do ludzkiego agenta, a widżet zwraca przekazanie. Następnie otwórz połączenie za pomocą GET /v1/calls/{call_id}: sip_headers powinno zawierać x-zoom-call-sid, a external_call_id powinno odpowiadać SID połączenia używanemu przez przepływ.

Ograniczenia

  • ThunderPhone nie wysyła żądań do statycznego adresu URL konektora, więc Zoom otrzymuje przekazanie przez wyszukiwanie lub przez mapowane nagłówki, jeśli test wykaże, że Zoom odczytuje je z REFER.
  • Łącze trunk jest tworzone przez zespół ISV Zoom, więc nie możesz samodzielnie go skonfigurować ani przetestować.