Ugrás a fő tartalomhoz

Vobiz integráció

Áttekintés​

A Vobiz felhőalapú telefonszolgáltató, amely versenyképes árakkal kínál globális elérést. Az IntraCord AI Vobiz integrációja megbízható hangkapcsolatot biztosít társalgási AI-ügynökei számára.

Előfeltételek​

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

  • Egy Vobiz-fiók
  • Auth ID és Auth Token a Vobiz Dashboardjáról
  • Egy Vobiz Alkalmazás (opcionális – hagyja üresen a mezőt az IntraCordban, és mentéskor automatikusan létrehozunk egyet a answer_url előre beállított értékével)
  • Legalább egy Vobiz telefonszám
  • IntraCord AI példány fut és elérhető

Konfiguráció​

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

  1. Jelentkezzen be Vobiz Dashboardjára
  2. Keresse meg Auth ID-jét, és hozzon létre egy Auth Tokent az API-hozzáféréshez
  3. (Opcionális) Navigáljon az Alkalmazások szakaszhoz, és hozza létre (vagy nyissa meg) az IntraCordhoz használni kívánt alkalmazást, majd másolja ki az Alkalmazásazonosítót. Hagyja ki ezt, ha azt szeretné, hogy az IntraCord automatikusan létrehozza az alkalmazást a mentéskor.
  4. Lépjen a Telefonszámok elemre, és másolja ki a használni kívánt számokat

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. Válassza ki a Vobiz szolgáltatót

  3. Adja meg a Credentials adatait:

    • Auth ID
    • Auth Token
    • Alkalmazásazonosító — nem kötelező. Hagyja üresen, és az IntraCord automatikusan létrehoz egy Vobiz-alkalmazást mentéskor (a answer_url már konfigurálva), és eltárolja az alkalmazásazonosítóját ezen a konfiguráción.

  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 (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.

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 Vobiz-számok nem tartalmaznak közvetlenül answer_url-t – az URL egy Vobiz Alkalmazás-ban él, és minden szám egy alkalmazáshoz kapcsolódik. Amikor ment egy bejövő workflow-t egy telefonszámon, az IntraCord automatikusan elküldi a webhook URL-címét a Vobiz-alkalmazás answer_url címére (feltéve, hogy a Credentials helyesek). Ha az IntraCord automatikusan létrehozta az alkalmazást a konfiguráció mentése során, akkor a answer_url már be van állítva, és ez a push nem művelet.

  1. Jelentkezzen be Vobiz konzoljába, és nyissa meg az Alkalmazások részt
  2. Szerkessze azt az alkalmazást, amelynek azonosítóját az IntraCordban konfigurálta
  3. Csatolja a bejövő hívásokhoz használni kívánt telefonszámot
  4. Mentés
Vobiz alkalmazás, amely a telefonszám csatolási felületét mutatja

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 Vobiz 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 Vobiz alkalmazásban​

  1. Nyissa meg Vobiz konzolját, és keresse meg az Alkalmazások

  2. Nyissa meg azt az alkalmazást, amelynek azonosítóját az IntraCordban konfigurálta

  3. Erősítse meg:

    • A válasz URL-je a következőre van állítva: https://api.IntraCord.com/api/v1/telephony/inbound/run
    • A válaszmód a POST

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 a tűzfalak engedélyezik-e a Vobiz webhook-kéréseit

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

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

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 az Auth ID és az Auth Token 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 nem kerültek újragenerálásra a Vobiz Dashboardon
Webhook requests failing
  • Ellenőrizze, hogy az Auth Token pontosan egyezik
  • Ellenőrizze, hogy a webhook URL elérhető-e a Vobiz szerverekről
  • Ellenőrizze, hogy nem áll-e olyan proxy mögött, amely módosítja a kéréseket
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 go to voicemail or aren't answered
  • Ellenőrizze, hogy a telefonszám ugyanahhoz a Vobiz-alkalmazáshoz van-e kapcsolva, amelynek Azonosító, amelyet az IntraCordban konfigurált – Győződjön meg arról, hogy a hívott szám létezik-e IntraCord 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-t sikeresen frissítette az alkalmazás answer_url-jét (mentéskor nem jelenik meg figyelmeztetés) - Ellenőrizze, hogy az IntraCord AI-példány fut, és válaszol
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 működik-e a webhook aláírás-ellenőrzése (Az IntraCord hitelesítési tokenje megegyezik a Vobiz Dashboardjával) - Ellenőrizze a WebSocket-kapcsolatot sikeresen létrejön - Tekintse át a hívásnaplókat a hibaüzenetekért

Legjobb gyakorlatok​

  • A kampányok futtatása előtt tesztelje konfigurációját egyetlen hívással
  • Figyelje a Vobiz Dashboardját a használathoz és a számlázáshoz
  • Tartsa biztonságban Auth Tokenjét, és időnként forgassa el
  • Használjon dedikált Vobiz alkalmazást az IntraCordhoz, hogy a megosztott answer_url ne ütközzön más rendszerekkel