Ugrás a fő tartalomhoz

Vonage integráció

Áttekintés​

A Vonage (korábban Nexmo) egy felhőalapú kommunikációs platform, amely globális hang-, üzenet- és videóképességeket biztosít. Az IntraCord AI Vonage integrációja kiváló minőségű hang interakciót tesz lehetővé ügynökeivel a Vonage robusztus infrastruktúrájának használatával.

Előfeltételek​

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

  • A Vonage-fiók
  • Vonage alkalmazás a Voice funkcióval
  • Alkalmazásazonosító és privát kulcs a Vonage Dashboardjáról
  • API kulcs és API Secret a Vonage Dashboardról
  • Signature Secret a Vonage Dashboardról
  • Legalább egy Vonage telefonszám kapcsolódik az alkalmazáshoz
  • IntraCord AI példány fut és elérhető

Konfiguráció​

1. lépés: Hozzon létre Vonage alkalmazást​

  1. Jelentkezzen be Vonage Dashboard
  2. Keresse meg az Alkalmazások → Új alkalmazás létrehozása lehetőséget.
  3. Engedélyezze a Hang funkciót
  4. Privát kulcs létrehozása (mentse biztonságosan – szüksége lesz rá)
  5. Jegyezze fel Alkalmazásazonosítóját

2. lépés: Szerezze be az API Credentials adatait​

  1. Keresse meg API-kulcsát és API Secretjét a Dashboardon, az API-beállítások alatt.
  2. Másold ki a Aláírási titkodat ugyanabból a Vonage-fiókból. IntraCord használja a Vonage signed webhooks ellenőrzéséhez.
  3. Navigáljon a Számok → Az Ön számai elemhez
  4. Másolja ki telefonszámát/számait
  5. Kapcsolja össze az egyes bejövő számokat a Voice alkalmazással

3. 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. Válassza a Vonage lehetőséget szolgáltatóként
  3. Adja meg a Credentials adatait:
    • Alkalmazásazonosító
    • Privát kulcs (teljes kulcs, beleértve a BEGIN/END sorokat)
    • API kulcs
    • API Secret
    • Aláírás titka
  4. Kattintson a Konfiguráció mentése gombra
  5. Nyissa meg az imént létrehozott konfigurációt, és adjon hozzá legalább egy telefonszámot (+ előtag nélkül, pl. 14155551234). Az alapértelmezett hívóazonosítót a rendszer a kimenő hívásokhoz használja.

4. 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 Vonage a bejövő Voice API-hívásokat egy Voice alkalmazáson keresztül irányítja. Az alkalmazás birtokolja a válasz URL-címét és az esemény URL-címét, és a telefonszámot ehhez az alkalmazáshoz kell kapcsolni. Az IntraCord a hívott szám bejövő workflow-hozzárendelése alapján a megfelelő ügynökhöz irányítja a hívást.

Amikor ment egy bejövő workflow-t egy telefonszámon, az IntraCord frissíti a konfigurált Vonage alkalmazás Voice webhookjait, és engedélyezi az aláírt visszahívásokat, feltéve, hogy az API-kulcs, az API Secret és az alkalmazásazonosító helyes, és a Signature Secret be van állítva.

  1. Nyissa meg a Vonage Dashboard
  2. Ugrás a Számok → Az Ön számai elemre
  3. Nyissa meg a bejövő hívásokhoz használni kívánt számokat
  4. Állítsa be a szám Voice alkalmazását ugyanarra a Vonage alkalmazásra, amelynek azonosítóját az IntraCordban konfigurálta

A Vonage's Numbers API ezt a szám app_id-jeként írja le: az az alkalmazás, amely kezeli az adott számra érkező bejövő forgalmat. Lásd a Numbers API referenciát.

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

  1. Lépjen a /telephony-configurations oldalra, és nyissa meg a Vonage konfiguráció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

3. lépés: Ellenőrizze a válasz URL-címét a Vonage alkalmazásban​

  1. Nyissa meg Vonage alkalmazását a [Vonage Dashboard] oldalon (https://dashboard.nexmo.com/)

  2. A Lehetőségek → Hang alatt erősítse meg:

    • A válasz URL-je a következőre van állítva: https://<your-backend-domain>/api/v1/telephony/inbound/run
    • A HTTP-módszer a POST
    • Az esemény URL-je a következőre van állítva: https://<your-backend-domain>/api/v1/telephony/vonage/events
    • Eseménymód: POST
    • Aláírt visszahívások engedélyezve vannak

4. 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 nyilvános háttér-URL-je elérhető-e az internetről
  • A Vonage naplók vagy a Voice Inspector segítségével ellenőrizze, hogy Vonage elküldi-e a válasz webhookot IntraCordnak

Tesztelje a bejövő hívást​

  1. Hívja fel konfigurált Vonage 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 Vonage Dashboardon

Hangminőség optimalizálása​

A Vonage jobb minőségű hangot használ (16 kHz), amely a következőket nyújtja:

  • Tisztább hangvisszaadás
  • Jobb beszédfelismerési pontosság
  • Természetesebb hangzású TTS kimenet
  • Csökkentett átírási hibák

Hibaelhárítás​

Voice application capabilities error
  • Győződjön meg arról, hogy a „Voice” engedélyezve van a Vonage alkalmazásban
  • Ellenőrizze, hogy az alkalmazásazonosító megegyezik-e a konfigurációjával
  • Ellenőrizze, hogy telefonszámai össze vannak-e kapcsolva az alkalmazással
JWT authentication failed
  • Ellenőrizze, hogy privát kulcsa teljes-e (beleértve a BEGIN/END sorokat is)
  • Ellenőrizze, hogy az alkalmazásazonosító helyes-e
  • Győződjön meg arról, hogy a magánkulcsot nem generálta újra a Vonage Dashboardban
Signed webhook validation failed
  • Ellenőrizze, hogy az IntraCord-ban lévő Signature Secret megegyezik-e a Vonage-fiók Signature Secrettel
  • Győződjön meg arról, hogy az aláírt visszahívások engedélyezve vannak a Vonage Voice alkalmazásban
  • Ellenőrizze, hogy a webhook-kérés tartalmaz-e egy Authorization fejlécet
  • Győződjön meg arról, hogy az alkalmazás ugyanahhoz az API-kulcshoz tartozik, amelyet az IntraCordban mentett
Invalid phone number error
  • Távolítsa el a Vonage „+” előtagját (használja a 14155551234-t, ne a +14155551234-t)
  • Győződjön meg arról, hogy a számok E.164 formátumúak (országkód + szám, szóközök és kötőjelek nélkül) a „+” nélkül.
  • Ellenőrizze, hogy a számok aktívak-e a Vonage-fiókjában
No audio on calls
  • Ellenőrizze, hogy létrejött-e a WebSocket kapcsolat
  • Ellenőrizze, hogy a hangcsatorna 16 kHz-es PCM-hez van-e konfigurálva
  • A WebSocket figyelése bináris hangkockákhoz
  • Tekintse át a VAD (Voice Activity Detection) viselkedését – ez az, ami észleli, hogy a hívó mikor kezdi meg és hagyja abba a beszédet
Calls disconnecting early
  • Ellenőrizze a WebSocket szívverés/ping-pong kereteket
  • Ellenőrizze, hogy nincs időkorlát a terheléselosztóban/proxyban
  • Figyelje a hangvezeték-hibákat
  • Tekintse át a hívás maximális időtartamának beállításait
Inbound calls not reaching voice agent
  • Ellenőrizze, hogy a Vonage alkalmazás válasz URL-je https://<your-backend-domain>/api/v1/telephony/inbound/run
  • Győződjön meg arról, hogy a válasz URL-címe nyilvánosan elérhető
  • Ellenőrizze, hogy a hívott szám a megfelelő Vonage alkalmazáshoz van-e kapcsolva
  • Győződjön meg arról, hogy a hívott szám létezik az IntraCord telefóniai beállításában, és hozzá van rendelve egy Bejövő workflow
Inbound call gives busy tone and IntraCord shows no logs
  • Győződjön meg arról, hogy a Vonage-szám össze van kapcsolva az IntraCordban konfigurált Voice alkalmazással
  • Győződjön meg arról, hogy a Voice alkalmazásban az IntraCord Answer URL-címe POST metódussal van beállítva
  • Győződjön meg arról, hogy a háttértartománya nyilvános; A Vonage nem tudja hívni a localhost-t
  • Az IntraCord hibakeresése előtt ellenőrizze a Vonage naplókat a válasz URL kézbesítési hibáira
Voice agent doesn't respond to inbound calls
  • Győződjön meg arról, hogy a telefonszámhoz van egy Bejövő workflow hozzárendelve a /telephony-configurations alatt
  • Ellenőrizze, hogy az API-kulcs megegyezik-e az IntraCord telefóniai beállításában tárolt kóddal (a szervezet azonosítására szolgál a bejövő webhook-ból)
  • Ellenőrizze, hogy a WebSocket kapcsolat sikeresen létrejött-e
  • Tekintse át a hívásnaplókat hibaüzenetekért

Legjobb gyakorlatok​

  • Biztonság: A privát kulcsok biztonságosan tárolódnak az adatbázisban
  • Aláírt visszahívások: Tartsa engedélyezve a Vonage által aláírt visszahívásokat, és tartsa naprakészen az aláírás titkát az IntraCord-ban
  • Tesztelés: Használja a Vonage Voice Inspectort a hívási problémák hibakereséséhez
  • Számok: Több szám konfigurálása a redundanciához
  • Monitoring: riasztásokat állíthat be a Vonage Dashboardban a hibákra
  • Költségkezelés: Kövesse nyomon a felhasználást a költségek szabályozása érdekében

Költségmegfontolások​

A Vonage ár tartalmazza:

  • A hívások percdíjai
  • Telefonszám bérleti díjak
  • Választható funkciók (felvétel, átírás)

Ellenőrizze a Vonage pricing elemet az aktuális árakért.

Következő lépések​

  • Tesztelje Vonage integrációját egy egyszerű workflow-val
  • Tekintse át a VAD és megszakítási viselkedést a workflow Node-jaihoz
  • Állítsa be a figyelést és a riasztásokat
  • Fedezze fel a speciális funkciókat, például a hívásrögzítést