Ugrás a fő tartalomhoz

Twilio integráció

Áttekintés​

A Twilio egy felhőalapú kommunikációs platform, amely lehetővé teszi a hanghívást, az üzenetküldést és a videózást. Az IntraCord AI Twilio integrációja zökkenőmentes kapcsolatot biztosít Voice Agentjei számára.

Előfeltételek​

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

  • Egy Twilio-fiók
  • Fiók SID és Auth Token a Twilio Console-ról
  • Legalább egy Twilio telefonszám
  • IntraCord AI példány fut és elérhető

Konfiguráció​

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

  1. Jelentkezzen be [Twilio Console]-ba (https://console.twilio.com/)
  2. Keresse meg fiók SID-jét és Auth Tokent a Dashboardon
  3. Lépjen a Telefonszámok → Kezelés → Aktív számok elemre.
  4. Másolja ki telefonszámát/számait

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 Twilio-t szolgáltatóként
  3. Adja meg a Credentials adatait:
    • Fiók SID
    • Auth Token
  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 bejövő forgalomirányítást maga a telefonszám irányítja – egy egyetlen webhook URL van a teljes szervezet számára, és az IntraCord eldönti, hogy melyik ügynököt futtassa a hívott számhoz rendelt bejövő workflow-ból. Amikor ment egy bejövő workflow-t egy telefonszámon, az IntraCord automatikusan elküldi a webhook URL-t a szám VoiceUrl címére a Twilio-fiókjában (feltéve, hogy a Credentials helyesek, és a szám az adott fiókhoz tartozik).

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

  1. Lépjen a /telephony-configurations oldalra, és nyissa meg a Twilio 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

2. lépés: Ellenőrizze a Webhook URL-címét a Twilio Console-ban​

  1. Nyissa meg a Telefonszámok → Kezelés → Aktív számok menüpontot a Twilio Console-ban.

  2. Kattintson arra a telefonszámra, amelyhez az 1. lépésben bejövő workflow-t rendelt

  3. A Hangkonfiguráció részben erősítse meg:

    • A Webhook a következőre van állítva: https://api.IntraCord.com/api/v1/telephony/inbound/run
    • A HTTP-módszer a POST
Twilio telefonszám hangkonfigurációja, amely a webhook URL beállítását mutatja bejövő hívásokhoz

3. 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 Twilio IP-tartományait

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

  1. Hívja fel a beállított Twilio 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 Twilio 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 a fiók SID é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 Twilio 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 Twilio – 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
  • Ellenőrizze, hogy a Twilio-szám webhookja a következőre van állítva https://api.IntraCord.com/api/v1/telephony/inbound/run – Biztosítsa a webhook-ot Az URL nyilvánosan elérhető az internetről – Erősítse meg a hívott számot létezik az IntraCord telefóniai beállításában, és Bejövő workflow hozzárendelve – Ellenőrizze, hogy az IntraCord AI-példány fut-e és válaszol-e
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 Twilio konzollal) - 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 Twilio Console-t a használathoz és a számlázáshoz