Hlasové hovory

Nainstalujte voice-bot v Nastavení → Dostupné pluginy, pak nastavte jeho službu volání a povolte přístup účtům, které mají volat. Plugin uskutečňuje skutečné odchozí hovory; telefon člověka může zazvonit během několika sekund a uskutečněný hovor nelze zrušit ani vrátit.

Nastavení hlasové služby

1. Otevřete Nastavení → Přístupy a rozbalte voice-bot.
2. Zadejte:
   • Adresa služby: úplná URL vaší hlasové služby. Přijímá se HTTP i HTTPS.
   • Token API: bearer token služby. Posílá se v hlavičce Authorization: Bearer, nikdy se nezapisuje do protokolu a nikdy se nevrací agentovi, ani v chybě.
3. Uložte. Obě pole musí být vyplněná, aby agent dostal nástroj VoiceCall.

Plugin vyžaduje Elowen 0.30.4 nebo novější. Uložení nastavení pluginu restartuje Elowen, takže upravená konfigurace platí po restartu. Elowen zobrazí zprávu „Změna je uložená. Elowen se teď restartuje, aby ji načetla.“

Vaše služba musí přijmout požadavek POST a držet ho otevřený, dokud hovor neskončí. Má vrátit výsledek JSON s answered (zda byl hovor zvednut) a podle dostupnosti dobu trvání v sekundách (elapsed_seconds), status nebo result služby a transcript. Výsledek může nést i timed_out, když služba hovor ukončila podle vlastního časového limitu, a call_sid jako identifikátor hovoru ve službě. Pokud odpověď nelze přečíst, není JSON nebo neříká, zda byl hovor zvednut, výsledek zůstává neznámý: hovor mohl proběhnout, takže to Elowen řekne a ukáže začátek odpovědi, místo aby hovor označila jako nezvednutý.

Povolení hovorů pro účty

1. Otevřete Uživatelé a vyberte účet.
2. V Povolené pluginy zvolte voice-bot.

Plugin lze povolit jednotlivým uživatelům. Administrátor ho může povolit účtu v Uživatelé → Povolené pluginy; neexistuje administrátorská výjimka, takže administrátor potřebuje stejné povolení. Oprávnění nástrojů účtu mohou přístup dál omezit.

Neexistuje potvrzení pro jednotlivý hovor ani seznam povolených telefonních čísel. Nastavený hodinový limit je jediná automatická brzda opakovaných hovorů. Před použitím nástroje ověřte, že uživatel číslo zadal nebo výslovně požádal Elowen, aby ho vyhledala. Pokud máte jakoukoli pochybnost, zeptejte se a číslo zopakujte. Nikdy číslo nehádejte a po nejistém výsledku automaticky nevolte znovu.

Uskutečnění hovoru

Požádejte Elowen v chatu, aby zavolala, a řekněte, čeho má dosáhnout. Elowen pak za vás vyplní údaje hovoru:

• Číslo: číslo, na které se má volat. Musí být v mezinárodním formátu E.164: úvodní znaménko plus, kód země a jen číslice, celkem 8 až 15 číslic. Například české číslo může vypadat takto +420123456789. Neplatná čísla se odmítnou ještě před pokusem o hovor.
• Prompt: pokyny pro hlasového agenta napsané v jazyce, kterým člověk mluví. Vysvětlete, na co se zeptat nebo co sdělit a jak se má agent chovat. Například: Zeptejte se, zda dotyčnému vyhovuje termín v úterý ve 15 hodin, a poděkujte mu za jeho čas. Toto není věta, která se přečte nahlas. Prompt je omezen na 4 000 znaků.
• Úvodní věta: volitelná. Přečte se jako první, když člověk zvedne. Pokud chybí, plugin použije úvodní větu z nastavení (Výchozí úvodní věta), je-li nastavená. Pokud není nastavená žádná úvodní věta, hovor otevře hlasová služba.

Nástroj čeká, dokud služba hovor nevyřídí, obvykle desítky sekund, a pak vrátí výsledek a přepis, jsou-li dostupné. Nejde o rychlé potvrzení s následnou samostatnou kontrolou stavu.

Limity hovorů a selhání

V nastavení se Nejdelší hovor měří v sekundách. Skupiny nastavení se otevírají rozbalené a pamatují si, zda jste je sbalili. Skupina, která potřebuje vaši pozornost, se rozbalí sama. Krátké nápovědy zůstávají viditelné; podrobná nápověda je dostupná přes ikonu nápovědy, včetně významu neznámého výsledku hovoru. Nejvyšší počet hovorů za hodinu je označený jako Vysoké riziko.

Hodinový limit počítá hovory zahájené v libovolném klouzavém 60minutovém okně. Neúspěšné hovory se počítají také a počet přežije restart. Když je limit vyčerpaný, nástroj odmítne bez hovoru a uvede zhruba, kdy bude další hovor povolen.

Pokud služba požadavek odmítne nebo není dostupná, nástroj ohlásí selhání a sdělí, že žádný hovor neproběhl. Pokud požadavek vyprší, výsledek je neznámý: služba mohla požadavek přijmout a telefon už mohl zvonit. Neopakujte pokus automaticky; nejdřív se obraťte na dotyčného. Nastavení délky hovoru není jen časový limit připojení. Příliš nízká hodnota může nechat skutečný hovor s neznámým výsledkem.

Záznamy hovorů

Plugin zaznamená každý hovor před odesláním požadavku, včetně účtu, konverzace, čísla, pokynů a úvodní věty. Hovory odmítnuté před vytáčením, protože je chybný formát čísla, prompt je příliš dlouhý nebo je vyčerpaný hodinový limit, se nezaznamenají. Neúspěšné a nejisté hovory se zaznamenají, takže se počítají do hodinového limitu. Dokončené hovory si ponechají odpověď služby a přepis. Uložené odpovědi se zkracují na 8 000 znaků, včetně odpovědí neúspěšných hovorů. Smazání účtu, který hovor uskutečnil, smaže jeho záznamy hovorů.

Referencia pro vývojáře

Implementace a zobrazení chyb popisuje sdílenou hranici chyb.

Zpět na začátek