Cloudonix integráció

Áttekintés

A Cloudonix egy felhőalapú kommunikációs platform, amely lehetővé teszi az IntraCord Voice Agentek számára, hogy csatlakozzanak SIP-kommunikációhoz platformon, akár a helyszínen, akár a felhőben. Ezenkívül a Cloudonix a hang API-k teljes készletét teszi közzé, amelyek biztosítják a hívásvezérlési képességek teljes készlete és még sok más.

Előfeltételek

A Cloudonix integráció beállítása előtt a következőkre lesz szüksége:

• Egy Cloudonix-fiók
• Egy Cloudonix domain UUID (vagy a domain név)
• Egy Cloudonix domain API-kulcs (hordozó token)
• Egy Cloudonix Hangalkalmazás az adott tartományban (opcionális – hagyja üresen a mezőt az IntraCordban, és mentéskor automatikusan létrehozunk egyet a url alkalmazás előre beállított használatával)
• Cloudonix kimenő hangtörzs-szolgáltatói kapcsolat
• IntraCord AI példány fut és elérhető

Oktatóvideó

Tekintse meg ezt a lépésről lépésre szóló útmutatót a Cloudonix IntraCord AI-val történő beállításához:

Konfiguráció

1. lépés: Szerezze be a Cloudonix Credentials adatait

1. Jelentkezzen be [Cloudonix Console]-ba (https://cockpit.cloudonix.io/onboarding?affiliate=IntraCord)
2. Keresse meg Domain ID-jét (UUID vagy domain név) és Bearer Tokent (Domain API Key) a Dashboardon
3. (Opcionális) Keresse meg a domain Alkalmazások részét, és hozza létre (vagy nyissa meg) az IntraCord-val használni kívánt alkalmazást, majd másolja ki az Alkalmazás nevét. Hagyja ki ezt, ha azt szeretné, hogy az IntraCord automatikusan létrehozza a Hangalkalmazást a mentéskor.

2. lépés: Konfigurálja az IntraCord AI-ben

1. Lépjen a /telephony-configurations oldalra, és kattintson a Konfiguráció hozzáadása lehetőségre.

2. Tekintse meg a fenti Cloudonix beállítási videót a részletes útmutatásért

3. Válassza a Cloudonix-ot szolgáltatóként

4. Adja meg a Credentials adatait:

   • Tartó zseton
   • Domain ID
   • Alkalmazás neve — nem kötelező. Hagyja üresen, és az IntraCord automatikusan létrehoz egy hangalkalmazást a mentéskor (a url alkalmazással és a CXML futási környezet már konfigurálva van), és eltárolja a nevét ebben a konfigurációban.

5. Kattintson a Konfiguráció mentése gombra

6. Nyissa meg az imént létrehozott konfigurációt, és adjon hozzá legalább egy telefonszámot (országkóddal, E.164 formátumban – +, majd országkód, majd szám, szóközök és kötőjelek nélkül, pl. +1234567890). Az alapértelmezett hívóazonosítót a rendszer a kimenő hívásokhoz használja.

   i

   Ha az IntraCord automatikusan létrehozta az Ön számára a Voice alkalmazást, akkor is meg kell tennie kösse össze DNID-jeit az adott alkalmazással a Cloudonix pilótafülkéjében (lásd A bejövő hívások beállításának 2. lépése). Az automatikusan létrehozott alkalmazás neve IntraCord-<random> – a neve látható a mentett konfiguráción.

3. lépés: Tesztelje a konfigurációt

1. Hozzon létre egy teszt workflow-t
2. Kattintson a "Hívás" gombra a kapcsolat ellenőrzéséhez
3. Ellenőrizze a hívásnaplókat a sikeres csatlakozás érdekében

Bejövő hívások beállítása

A Cloudonix a bejövő hívásokat Hangalkalmazásonként irányítja – a webhook URL-címe egyszer van beállítva az alkalmazáson, és minden hozzá kötött DNID-re vonatkozik. Amikor ment egy bejövő workflow-t egy telefonszámon, az IntraCord automatikusan elküldi a webhook URL-jét a Voice Application url címére (feltéve, hogy a Credentials helyesek), így nem kell kézzel beállítania a webhookot. Ha az IntraCord automatikusan létrehozta az alkalmazást a konfiguráció mentése során, akkor a url már be van állítva, és ez a push nem művelet – csak a DNID-ket kell kötni az automatikusan létrehozott alkalmazáshoz.

1. lépés: Állítsa be a bejövő fővonalat

1. Jelentkezzen be [Cloudonix Console]-ba (https://cockpit.cloudonix.io)
2. Lépjen a Fővonalak → Bejövő fővonal létrehozása elemre, és konfigurálja a bejövő fővonalat a hangszolgáltatóval.

2. lépés: Hozza létre a Hangalkalmazást és kapcsolja össze a DNID-ket

1. A Cloudonix pilótafülkéjében válassza ki a domainjét, és navigáljon az Alkalmazások részhez.

2. Hozzon létre egy új alkalmazást (vagy nyissa meg a meglévőt, amelynek a nevét beállította az IntraCordban) a következő beállításokkal:

   • Alkalmazás erőforrás típusa: Remote Application Resource
   • Alkalmazás futási ideje: Cloudonix (CXML)
   • Az alkalmazás URL-je: https://api.IntraCord.com/api/v1/telephony/inbound/run
   • HTTP-módszer: POST

3. A DNID-számok alatt adja meg az összes telefonszámot (DNID), amelyet át szeretne irányítani ezen az alkalmazáson

4. Mentés

   i

   Az alkalmazás URL-címe az, amit az IntraCord automatikusan frissít a 3. lépésben – Ön üresen hagyhatja a létrehozás során, és hagyhatja, hogy az automatikus push kitöltse, vagy illessze be a fenti URL-t, hogy az alkalmazás azonnal használható legyen. Bármelyik működik. A saját üzemeltetésű IntraCord-telepítések a háttértartományukat használják a api.IntraCord.com helyett.

3. lépés: Rendeljen bejövő workflow-t az IntraCord telefonszámához

1. Lépjen a /telephony-configurations oldalra, és nyissa meg a Cloudonix konfigurációját
2. A Telefonszámok részben módosítsa azt a számot, amelyre fogadni kell a bejövő hívásokat
3. Állítsa be a Bejövő workflow-t arra az ügynökre, akinek válaszolnia kell
4. Mentés

4. lépés: Ellenőrizze az URL-címet a Voice alkalmazásban

1. Nyissa meg a Cloudonix pilótafülkét, és navigáljon a domain Alkalmazások részéhez.

2. Nyissa meg azt az alkalmazást, amelynek a nevét beállította az IntraCordban

3. Erősítse meg:

   • Az URL a következőre van állítva: https://api.IntraCord.com/api/v1/telephony/inbound/run
   • A módszer a POST
   i

   Az IntraCord automatikusan leküldte ezt az URL-t, amikor mentette a bejövő workflow-t A 3. lépésben. Ugyanazt az URL-címet osztja meg minden ehhez kötött DNID között alkalmazás — Az IntraCord minden bejövő hívást a megfelelő ügynökhöz irányít a hívott szám bejövő workflow-hozzárendelésén. Ha a mező az üres, más URL-t mutat, vagy az IntraCord szinkronizálási figyelmeztetést jelentetett meg mentés, az automatikus push meghiúsult – leggyakrabban azért, mert a Bearer Token, Az IntraCord-ban megadott domainazonosító vagy alkalmazásnév helytelen. Illessze be az URL-t be a mezőbe, állítsa be a módszert POST értékre, és mentse. Be saját üzemeltetésű IntraCord, cserélje ki a api.IntraCord.com-t a háttértartományára.

5. lépés: Ellenőrizze a beállítást

• Győződjön meg arról, hogy IntraCord AI példánya nyilvánosan elérhető
• Ellenőrizze, hogy a tűzfalak engedélyezik-e a Cloudonix IP-tartományait
• Győződjön meg arról, hogy a bejövő fővonal aktív, és fogadja a hívásokat

Tesztelje a bejövő hívást

1. Hívja fel a beállított telefonszámát egy másik telefonról
2. Ellenőrizze, hogy IntraCord AI Voice Agentje válaszol és válaszol
3. Ellenőrizze a hívásnaplókat mind az IntraCord AI Dashboardon, mind a Cloudonix konzolon
4. Erősítse meg a tiszta kétirányú audiokommunikációt

Hibaelhárítás

Invalid phone number error

Győződjön meg arról, hogy a telefonszámok E.164 formátumú országkódot tartalmaznak: +1234567890

Authentication failed

• Ellenőrizze, hogy a tartományazonosító, a bearer token és az alkalmazásnév helyes-e
• Ellenőrizze, hogy nincs-e több szóköz a Credentials mezőkben
• Győződjön meg arról, hogy a Credentials nincsenek letiltva vagy törölve a Cloudonix Console-ban

No audio on calls

• Ellenőrizze, hogy létrejött-e a WebSocket kapcsolat
• Ellenőrizze a WebSocket forgalom tűzfalszabályait
• Győződjön meg arról, hogy az audio pipeline megfelelően van konfigurálva

Inbound calls not reaching voice agent

• Ellenőrizze, hogy a DNID ugyanahhoz a hangalkalmazáshoz van kötve, amelynek Ön a nevét IntraCordban konfigurálva – Győződjön meg arról, hogy a hívott szám létezik az IntraCordban telefóniai beállítás, és hozzá van rendelve egy Bejövő workflow - A bejövő workflow hozzárendelése után erősítse meg az IntraCord sikeres frissítését az alkalmazás url (a mentéskor nem jelenik meg figyelmeztetés) - Ellenőrizze a bejövőt fővonal aktív, és hívásokat fogad

Voice agent doesn't respond to inbound calls

• Győződjön meg arról, hogy a telefonszámhoz hozzá van rendelve egy Bejövő workflow /telephony-configurations - Ellenőrizze, hogy az IntraCord-ban lévő Bearer Token megegyezik-e a egyet a Cloudonix konzolon – Ellenőrizze, hogy létrejött-e a WebSocket kapcsolat sikeresen – Tekintse át a hívásnaplókat hibaüzenetekért

Legjobb gyakorlatok

• A kampányok futtatása előtt tesztelje konfigurációját egyetlen hívással
• Figyelje a Cloudonix Sessions használatát
• Használjon dedikált hangalkalmazást az IntraCord számára, hogy a megosztott url ne ütközzön más rendszerekkel