Ugrás a fő tartalomhoz

Telnyx integráció

Áttekintés​

A Telnyx egy felhőalapú kommunikációs platform, amely programozható hangot biztosít a Call Control API-ján keresztül. Az IntraCord AI Telnyx integrációja a Call Control és a WebSocket media streaminget használja a Voice Agentek működéséhez.

Előfeltételek​

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

  • Egy Telnyx-fiók
  • Egy API-kulcs a Telnyx Mission Control Portalról
  • Egy Call Control Application (opcionális – hagyja üresen a mezőt az IntraCordban, és mentéskor automatikusan létrehozunk egyet, előre beállított bejövő webhook URL-lel)
  • Legalább egy, a Call Control Applicationhöz rendelt Telnyx telefonszám
  • IntraCord AI példány fut és elérhető

Konfiguráció​

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

  1. Jelentkezzen be a Telnyx Mission Control portálra
  2. Keresse meg az API-kulcsokat, és hozzon létre (vagy másoljon) egy API-kulcsot
  3. Szükség esetén lépjen a Call Control → Applications menübe, és hozza létre vagy nyissa meg az IntraCorddal használni kívánt alkalmazást, majd másolja ki a Call Control App ID értékét. Ezt a lépést kihagyhatja, ha az alkalmazást mentéskor az IntraCorddal hozatja létre.
  4. Lépjen a Numbers → My Numbers menübe, és rendelje hozzá telefonszámait az IntraCorddal használni kívánt Call Control Applicationhöz. Automatikus létrehozás esetén ezt a konfiguráció mentése után tegye meg.

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 Telnyx szolgáltatót

  3. Adja meg a Credentials adatait:

    • API kulcs
    • Call Control App ID – nem kötelező. Ha üresen hagyja, az IntraCord mentéskor automatikusan létrehoz egy Call Control Applicationt a bejövő webhook URL-lel, és eltárolja az azonosítóját a konfigurációban.

  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 Telnyx a bejövő webhookokat Call Control Application szinten kezeli: az alkalmazáson egyszer beállított webhook URL minden hozzárendelt számra érvényes. Amikor egy telefonszámhoz bejövő workflow-t ment, az IntraCord automatikusan beállítja a Call Control Application webhook_event_url értékét, ha a Credentials helyesek. Az IntraCord által létrehozott alkalmazásnál ez az URL már mentéskor beállításra kerül.

1. lépés: Rendeljen bejövő workflow-t a telefonszámhoz​

  1. Lépjen a /telephony-configurations oldalra, és nyissa meg a Telnyx beállítását.
  2. A Telefonszámok résznél szerkessze azt a számot, amelyen bejövő hívásokat szeretne fogadni.
  3. A Bejövő workflow mezőben válassza ki a hívást fogadó Voice Agentet.
  4. Mentse a módosítást.

2. lépés: Ellenőrizze a Webhook URL-t a Call Control Applicationben​

  1. Nyissa meg a Call Control → Applications menüt a Telnyx Portalon.

  2. Nyissa meg azt az alkalmazást, amelynek Call Control App ID értékét az IntraCordban beállította.

  3. A Webhook Settings résznél ellenőrizze:

    • a Webhook URL értéke https://api.IntraCord.com/api/v1/telephony/inbound/run;
    • a HTTP Method értéke POST.

  4. Ellenőrizze, hogy a bejövő hívásokhoz használt telefonszámok hozzá vannak-e rendelve az alkalmazáshoz.

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

  • Győződjön meg arról, hogy az IntraCord-példány nyilvánosan elérhető.
  • Ellenőrizze, hogy a tűzfal engedélyezi-e a Telnyx IP-tartományait.

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

  1. Hívja fel a beállított Telnyx telefonszámot egy másik telefonról.
  2. Ellenőrizze, hogy az IntraCord Voice Agent fogadja a hívást és válaszol.
  3. Ellenőrizze a hívásnaplókat az IntraCord Dashboardon és a Telnyx Portalon.

Hibaelhárítás​

Invalid phone number error

Győződjön meg arról, hogy a telefonszám országkóddal együtt, E.164 formátumban szerepel, például: +1234567890.

Authentication failed
  • Ellenőrizze, hogy az API Key helyes és aktív-e.
  • Távolítsa el az esetleges felesleges szóközöket.
  • Ellenőrizze a Telnyx Portalon, hogy a kulcsot nem vonták-e vissza.
Webhook signature validation failing
  • A Telnyx Ed25519 használatával írja alá a webhookokat; ellenőrizze, hogy az alkalmazás Public Key értéke nem változott-e.
  • Ellenőrizze, hogy a Webhook URL megegyezik-e a Telnyxben beállított értékkel.
  • Ellenőrizze, hogy nincs-e a kérés törzsét módosító proxy az endpoint előtt.
No audio on calls
  • Ellenőrizze, hogy létrejött-e a WebSocket-kapcsolat.
  • Ellenőrizze a WebSocket-forgalomra vonatkozó tűzfalszabályokat.
  • Győződjön meg arról, hogy az audio pipeline megfelelően van beállítva.
Inbound calls aren't answered
  • Ellenőrizze, hogy a Call Control Application Webhook URL-je https://api.IntraCord.com/api/v1/telephony/inbound/run, és nyilvánosan elérhető.
  • Ellenőrizze, hogy a hívott szám ahhoz a Call Control Applicationhöz tartozik-e, amelynek Call Control App ID értékét az IntraCordban beállította.
  • Ellenőrizze, hogy a szám szerepel-e az IntraCord telefóniai beállításában, és tartozik-e hozzá Bejövő workflow.
  • Ellenőrizze, hogy az IntraCord-példány fut és válaszol.
Voice agent doesn't respond to inbound calls
  • Ellenőrizze a /telephony-configurations oldalon, hogy a telefonszámhoz tartozik-e Bejövő workflow.
  • Ellenőrizze, hogy az API Key megegyezik-e az IntraCord telefóniai beállításában tárolt értékkel.
  • Ellenőrizze, hogy sikeresen létrejön-e a WebSocket-kapcsolat.
  • Tekintse át a hívásnaplókat és a hibaüzeneteket.

Legjobb gyakorlatok​

  • A kampányok indítása előtt tesztelje a konfigurációt egyetlen hívással.
  • Kövesse a használatot és a számlázást a Telnyx Portalon.
  • Használjon külön Call Control Applicationt az IntraCordhoz, hogy a webhook URL ne ütközzön más rendszerek beállításaival.