Ugrás a fő tartalomhoz

Plivo integráció

Áttekintés​

A Plivo egy felhőalapú kommunikációs platform, amely globális hang- és üzenetkezelési API-kat biztosít. Az IntraCord AI Plivo integrációja a Plivo XML és WebSocket streamingjét használja a Voice Agentek működéséhez.

Előfeltételek​

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

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

Konfiguráció​

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

  1. Jelentkezzen be [Plivo Console]-ba (https://console.plivo.com/)
  2. Keresse meg Auth ID-t és Auth Tokent a Dashboardon
  3. (Opcionális) Lépjen a Hang → Alkalmazások lehetőségre, és hozza létre (vagy nyissa meg) az IntraCord-val használni kívánt alkalmazást, majd másolja ki az Alkalmazásazonosítót (UUID). Hagyja ki ezt, ha azt szeretné, hogy az IntraCord automatikusan létrehozza az alkalmazást a mentéskor.
  4. Lépjen a Telefonszámok → Saját szá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 Plivo-t szolgáltatóként

  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 Plivo-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 Plivo-számok nem tartalmaznak közvetlenül answer_url-t – az URL egy Plivo Application-ben é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 Plivo-alkalmazás answer_url címére (feltéve, hogy a Credentials helyesek). 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 answer_url már be van állítva, és ez a push nem művelet.

  1. Nyissa meg a Telefonszámok → Az Ön számai lehetőséget a [Plivo Console]-ban (https://console.plivo.com/)
  2. Nyissa meg a bejövő hívásokhoz használni kívánt számot
  3. Állítsa be az Alkalmazást ugyanarra az alkalmazásra, amelynek azonosítóját az IntraCordban konfigurálta
  4. Mentés

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

  1. Nyissa meg a /telephony-configurations oldalt, és nyissa meg a Plivo 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 Plivo alkalmazásban​

  1. Nyissa meg Plivo alkalmazását a Plivo Console Hang → Alkalmazások alatt.

  2. 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 Plivo IP-tartományait

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

  1. Hívja fel konfigurált Plivo 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 Plivo Console-on

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 benne több szóköz Credentials – Győződjön meg arról, hogy a Credentials nem kerültek újragenerálásra a Plivo Console-ban
Webhook signature validation failing
  • Ellenőrizze, hogy az Auth Token pontosan egyezik – Ellenőrizze, hogy a webhook URL-je egyezik-e mit küld a Plivo – 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 a WebSocket kapcsolat létrejöttét - Ellenőrizze a tűzfalszabályokat WebSocket forgalom – 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 Plivo-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 Plivo Console-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 Plivo Console-t a használathoz és a számlázáshoz
  • Használjon dedikált Plivo alkalmazást az IntraCord számára, hogy a megosztott answer_url ne ütközzön más rendszerekkel