VICIdial integráció

Áttekintés

Használja ezt az integrációt, ha a VICIdial birtokolja az ügyfélhívást, és csatlakoztatja az IntraCordhoz hozzá az Asterisken keresztül. Az IntraCord az Asterisk ARI-t használja a hanghoz és a VICIdial API-kat ehhez műveletek, amelyeknek ki kell hatniuk az eredeti vásárlói lábra:

• Amikor az ügyintéző befejezi a beszélgetést, tegye le az ügyfélhívást
• Vigye át az ügyfelet egy VICIdial csoporton belülihez
• Frissítse a kiválasztott VICIdial lead mezőket az összegyűjtött workflow-kontextusból

A VICIdial vezérlők egy fejlett szervezési funkció. Felhasználók, akik nem engedélyezik a szolgáltatás nem látja a VICIdial konfigurációt, az átviteli leképezéseket vagy a lead mezőt leképezések a felhasználói felületen.

Előfeltételek

A VICIdial konfigurálása előtt győződjön meg a következőkről:

• A Asterisk ARI az IntraCordhoz csatlakozik, ahogy az a Asterisk ARI integráció
• A VICIdial az ügyfélhívást az Asterisk tárcsázási tervre küldi, amely belép a IntraCord Stasis alkalmazás
• Rendelkezik VICIdial ügynök API-hitelesítési adataival, amely engedéllyel leteszi a telefont és csoporton belüli transzfereket hajt végre
• Ha a workflow-k frissítik a potenciális ügyfeleket, akkor nem ügynöki API-hitelesítési adataival is rendelkezik engedélyt a update_lead hívására

Engedélyezze a szervezési funkciót

1. Nyissa meg a Platformbeállításokat a https://app.IntraCord.com/settings oldal megnyitásával
2. Engedélyezze a Külső alközponti integrációt.

Ez a kapcsoló megjeleníti az Asterisk telephony speciális beállításait konfigurációk, Transfer Call Toolok és workflow-konfigurációk. Letiltása elrejti és letiltja ezeket a vezérlőket anélkül, hogy törölné a mentett értékeket.

Konfigurálja a VICIdial Credentials adatait

1. Nyissa meg a Telefónia beállításai elemet.
2. Hozzon létre vagy szerkesszen egy Asterisk ARI konfigurációt.
3. A Külső alközpontban állítsa a Külső alközpont típusát VICIdial értékre.
4. Az ügynök API konfigurálása:
   • Az ügynök API URL-je: általában /agc/api.php-re végződik
   • Agent API felhasználó
   • Agent API jelszó
5. A potenciális ügyfelek frissítéséhez konfigurálja a nem ügynök API-t:
   • Nem ügynök API URL: általában /vicidial/non_agent_api.php-re végződik
   • Nem ügynök API-felhasználó
   • Nem ügynök API-jelszó
6. Mentse el a konfigurációt.

A nem ügynök API nem kötelező, ha nincs szükség potenciális ügyfelek frissítésére. Ha használják, URL-jének, felhasználójának és jelszavának egyaránt jelen kell lennie. A Credentials adatokat a telefóniai beállítást, és az IntraCord API maszkolva adja vissza.

A VICIdial hívásazonosító átadása az Asterisknek

Az IntraCordnak szüksége van a VICIdial call identity adataira az eredeti customer leg vezérléséhez. Konfigurálja a VICIdialt vagy a kapcsolódó dialplant úgy, hogy az IntraCord Stasis applicationbe érkező híváson megőrizze ezeket a SIP headereket:

Header	Cél
X-VICIDIAL-callerid	Az Agent API által használt call-control identifier
X-VICIDIAL-user	Az Agent API által használt remote-agent user
X-VICIDIAL-lead_id	Opcionális lead update-ekhez használt lead identifier
X-VICIDIAL-campaign_id	(Opcionális) A hívással megőrzött campaign context
X-VICIDIAL-ingroup_id	(Opcionális) Az eredeti in-group, amely transfer fallback routinghoz használható

A hangup és transfer műveletekhez call-control identifier és remote-agent user szükséges. Lead update-hez ezen felül lead ID kell. A source in-group header csak akkor szükséges, ha a transfer mapping source fallbacket használ.

Lead adatok átadása további headerekben

Konfigurálja a VICIdialt vagy a dialplant lead mezőket tartalmazó headerek hozzáadására, például: X-VICIDIAL-first_name, X-VICIDIAL-city, X-VICIDIAL-vendor_lead_code. Az üres értékű headereket a rendszer figyelmen kívül hagyja.

A call setup során minden lead mező külön olvasódik be, ezért az IntraCord csak a felsorolt mezőket rögzíti:

1. Nyissa meg a workflow General Settings részét.
2. Az External PBX Field Updates alatt keresse meg a Lead Fields To Capture mezőt.
3. Adjon hozzá minden fieldhez külön bejegyzést az X-VICIDIAL- prefix nélkül; például az X-VICIDIAL-first_name rögzítéséhez first_name értéket adjon meg.

i

Minden hozzáadott mező egy további Asterisk requestet jelent call setup közben, ami késlelteti a Voice Agent első válaszát. Csak a promptokban ténylegesen használt mezőket sorolja fel.

A PBX által küldött mezők felderítése

Minden bejövő hívás automatikusan logolja az elérhető fieldneveket:

[ARI org=7] Available vicidial lead fields on channel 1712...: ['callerid',
'city', 'first_name', 'lead_id', 'user'] — add the ones you need under the
workflow's Lead Fields To Capture setting

A nevek listázása a headerek számától függetlenül egyetlen requestet használ, mert csak neveket olvas, értékeket nem.

A rögzített mezők a header suffixéről elnevezett template variable-okon keresztül érhetők el a workflow promptjaiban:

Hello {{external_pbx_call.lead.first_name | there}}, I see you're calling
from {{external_pbx_call.lead.city}}.

Csoporton belüli átvitelek konfigurálása

A csoporton belüli leképezések kiválasztják a VICIdial célállomást a által gyűjtött információkból az ügynök hívás közben.

1. Nyissa meg vagy hozzon létre egy Hívásátadás Toolt.
2. Válassza a Context Mapping lehetőséget célforrásként.
3. Adjon meg egy kontextus elérési utat, például qualified vagy extracted_variables.qualified.
4. Adjon hozzá egy útvonalat minden várható értékhez és a cél csoporton belüli azonosítójához.
5. Opcionálisan konfigurálhat csoporton belüli tartalékot. Írja be a source kódot a visszaküldéshez a SIP-fejlécekből rögzített eredeti csoporton belüli hívóhoz.
6. Mentse el a Toolt, és csatolja a workflow-hoz.

A mérkőzés nem tesz különbséget a kis- és nagybetűk között. Az IntraCord ezt megelőzően végrehajtja a végső változó kinyerését a leképezés feloldása. Ha egyetlen útvonal vagy tartalék sem egyezik, az átvitel meghiúsul és az ügynök felépülhet ahelyett, hogy csendben letenné a telefont.

Konfigurálja a lead mező-leképezéseket

Lead-mező-leképezések másolják a kiválasztott értékeket az összegyűjtött kontextusból a VICIdial vezeték átvitel vagy bontás előtt.

1. Nyissa meg a workflow Konfigurációk párbeszédpanelt.
2. A Külső alközponti mezőfrissítések részben adjon hozzá hozzárendelést.
3. Adja meg az összegyűjtött kontextus elérési útját és a cél VICIdial lead mezőt.
4. Adjon hozzá további leképezéseket, és mentse el a workflow-konfigurációt.

Például leképezheti a extracted_variables.customer_state-t a state-re. Egy kontextus elérési út címezhet egy közvetlen összegyűjtött kontextusértéket vagy egy beágyazott értéket. Leképezések amelyek forrásértéke hiányzik, kihagyják.

A VICIdial adapter figyelmen kívül hagyja az API vezérlőparamétereket célzó leképezéseket source, user, pass, function és lead_id. A nem ügynök API konfiguráció szükséges a leképezések alkalmazásához. Hiba a felvezetés frissítésében nem akadályozza meg IntraCord-t abban, hogy megkísérelje a kért átvitelt vagy leállítást.

Runtime viselkedés

Amikor a workflow átadja a hívást, az IntraCord feloldja a konfigurált csoporton belüli, alkalmazza az elérhető potenciális frissítéseket, megkéri a VICIdialt az ügyfélláb átvitelére, és majd csak a helyi Asterisk médiaágat zárja be.

Amikor a beszélgetés átvitel nélkül ér véget, IntraCord továbbra is a végső összegyűjtést folytatja összefüggésben alkalmazza az elérhető potenciális frissítéseket, megkéri a VICIdialt, hogy tegye le az ügyfelet lábát, majd bezárja a helyi Asterisk lábát.

Hibaelhárítás

• A VICIdial beállításai nem láthatók: engedélyezze a Külső alközponti integrációkat a Platformbeállításokban.
• A helyi média szakasz véget ér, de az ügyfél kapcsolatban marad: erősítse meg ezt A X-VICIDIAL-callerid és a X-VICIDIAL-user eléri a csillagot, és az ügynök Az API Credentials vezérelhetik a hívást.
• Az átvitel nem oldja meg a célállomást: ellenőrizze a workflow végső állapotát összegyűjtött kontextus, a konfigurált kontextus elérési útja és a leképezési értékek.
• A source tartalék meghibásodik: Győződjön meg róla, hogy a X-VICIDIAL-ingroup_id jelen van a bejövő hívást.
• A potenciális ügyfelek mezői változatlanok: erősítse meg a X-VICIDIAL-lead_id, a nem ügynök API-t Credentials adatokat és a cél mezőneveket.