VoxAide (Preview)
Hlasové hovory AI umístěte kontaktům z nakonfigurovaného důvodu a přečtěte si výsledek každého hovoru. Spáruje se službou VoxAide pro Dynamics 365 spravované řešení. Ověřování pomocí klíče rozhraní API VoxAide (integrace nastavení → → Dynamics 365)
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Všechny oblasti Power Automate kromě následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Logické aplikace | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure Government – Azure oblasti Čína - Ministerstvo obrany USA (DoD) |
| Power Apps | Premium | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Automatizace napájení | Premium | Všechny oblasti Power Automate kromě následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Název | Podpora VoxAide |
| URL | https://voxaide.co |
| support@voxaide.co |
| Metadata konektoru | |
|---|---|
| Vydavatel | Omezená suverénní IT řešení |
| Internetová stránka | https://voxaide.co |
| Zásady ochrany osobních údajů | https://voxaide.co/privacy |
| Kategorie | Komunikace; Sales and CRM |
VoxAide
VoxAide umístí hlasové hovory AI kontaktům z důvodu, který zvolíte, položí otázky, které nastavíte, a vrátí výsledek každého hovoru – souhrn, jestli došlo k problému, doba trvání a stav. Slouží k vytváření Power Automate toků, které volají lidi automaticky (vrácení se změnami, potvrzení, připomenutí, kontroly odkazů) a napsat výsledek zpět do vašich systémů.
Vydavatel
VoxAide (Suverénní IT Solutions Ltd)
Předpoklady
- Účet VoxAide (zaregistrujte se na https://voxaide.coadrese ). Volání na váš plán VoxAide nebo průběžné platby.
- Funkce volání je povolená ve vaší organizaci VoxAide.
- Plán Power Automate, Power Apps nebo Logic Apps, který podporuje prémiové nebo vlastní konektory.
Jak získat přihlašovací údaje
VoxAide se ověřuje pomocí klíče rozhraní API.
- Přihlaste se k VoxAide na adrese https://voxaide.co.
- Přejděte na Nastavení → Integrace.
- V části konektoru zvolte Vygenerovat klíč a zkopírujte klíč (začíná
vox_live_na ). Zobrazí se jednou. - Když v Power Automate vytvoříte připojení VoxAide, vložte klíč do pole Klíč rozhraní API.
Klíč můžete kdykoli odvolat ze stejné obrazovky.
Podporované operace
| Operation | Description |
|---|---|
| Zahájit hovor | Hlasová volání umělé inteligence teď umístíte na kontakt z daného důvodu. |
| Výpis volání | Seznam posledních volání, nejnovější jako první; hlasování s informacemi o since aktualizacích |
| Získání hovoru | Po dokončení jednoho volání získáte jeden hovor a jeho výsledek. |
| Seznam důvodů volání | Uveďte důvody volání nakonfigurované pro vaši organizaci. |
| Vytvoření důvodu volání | Vytvořte nový důvod s názvem a otázkami, které se mají položit. |
| Získání důvodu volání | Získejte jeden důvod podle jeho identifikátoru. |
| Aktualizace důvodu volání | Aktualizujte název, plán nebo otázky důvodu. |
| Test připojení | Ověřte klíč rozhraní API (používaný testem připojení). |
Typický tok: Volání s odůvodněním a telefonním číslem kontaktu → hlasování Získat hovor (nebo vypsat hovory), dokud status nebudefailed/declinedcompleted/→ použít vrácený summaryoutcome hovor a issueRaised ve vašem toku.
Pokyny k nasazení
Soubory konektoru jsou apiDefinition.swagger.jsona apiProperties.jsonicon.png. Vytvoření konektoru ve vlastním prostředí pomocí rozhraní příkazového řádku konektorů Power Platform:
pip install paconn
paconn login
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png
Známé problémy a omezení
- Telefonní čísla musí být ve formátu E.164 (například
+14155550123). - Volání spotřebovávají příspěvek na plán nebo kredit s průběžným platbami; Volání se účtuje při jeho umístění, ne po jeho dokončení.
- Volání jsou umístěna asynchronně: Volání se vrátí okamžitě se stavem
callIda stavempending. Poll Get a call for the final outcome. - Pole
activityIdje určené pro pokročilý zápis do existující aktivity CRM (například aktivitu Dynamics 365 telefonního hovoru) a u většiny toků je možné ignorovat.
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| Default | Parametry pro vytvoření připojení | Všechny oblasti | Nesdílitelné |
Výchozí
Použitelné: Všechny oblasti
Parametry pro vytvoření připojení
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
| Název | Typ | Description | Povinné |
|---|---|---|---|
| Klíč API | Securestring | Klíč rozhraní API pro toto rozhraní API | Pravdivé |
Akce
| Aktualizace důvodu volání |
Aktualizujte důvod volání. |
| Seznam důvodů volání |
Vrátí nakonfigurované důvody volání (automatizace) pro organizaci. |
| test připojení |
Ověří klíč rozhraní API a vrátí organizaci, na které se mapuje. |
| Vytvoření důvodu volání |
Vytvořte důvod volání. |
| Výpis volání |
Zobrazí seznam posledních volání, nejnovější jako první. K dotazování na aktualizace použijte od. |
| Zahájit hovor |
Umístí hlasový hovor AI na kontakt z daného důvodu. Předejte ID kontaktu Dataverse jako contact.externalId, aby se výsledek zapisoval zpět jako nová aktivita telefonního hovoru na časové ose kontaktu. Pokud chcete místo toho dokončit existující aktivitu telefonního hovoru (režim distribuce kampaně), předejte jeho ID aktivity. Použijte obsah.* k řízení vloženého skriptu volání (řízený kampaní), přepsání uloženého obsahu důvodu. |
| Získání důvodu volání |
Získejte důvod volání. |
| Získání hovoru |
Zavolejte. |
Aktualizace důvodu volání
Aktualizujte důvod volání.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
identifikační číslo
|
id | True | string |
identifikační číslo |
|
název
|
name | True | string | |
|
description
|
description | string | ||
|
Dayofweek
|
dayOfWeek | integer | ||
|
otázky
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
stav
|
status | string |
aktivní | Pozastaveno |
Seznam důvodů volání
Vrátí nakonfigurované důvody volání (automatizace) pro organizaci.
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
důvody
|
reasons | array of Reason |
test připojení
Vytvoření důvodu volání
Vytvořte důvod volání.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
název
|
name | True | string | |
|
description
|
description | string | ||
|
Dayofweek
|
dayOfWeek | integer | ||
|
otázky
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
stav
|
status | string |
aktivní | Pozastaveno |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
id
|
id | string |
Výpis volání
Zobrazí seznam posledních volání, nejnovější jako první. K dotazování na aktualizace použijte od.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Jelikož
|
since | string |
časové razítko ISO-8601; pouze volání vytvořená v/po tomto. |
|
|
Status
|
status | string |
Filtrovat podle stavu (čekající, in_progress, dokončeno, neúspěšné, odmítnuto). |
|
|
ReasonId
|
reasonId | string |
ReasonId |
|
|
Omezení
|
limit | integer |
Omezení |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
hovory
|
calls | array of Call |
Zahájit hovor
Umístí hlasový hovor AI na kontakt z daného důvodu. Předejte ID kontaktu Dataverse jako contact.externalId, aby se výsledek zapisoval zpět jako nová aktivita telefonního hovoru na časové ose kontaktu. Pokud chcete místo toho dokončit existující aktivitu telefonního hovoru (režim distribuce kampaně), předejte jeho ID aktivity. Použijte obsah.* k řízení vloženého skriptu volání (řízený kampaní), přepsání uloženého obsahu důvodu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
reasonId
|
reasonId | True | string | |
|
název
|
name | string | ||
|
phone
|
phone | True | string |
E.164 telefonní číslo. |
|
e-mail
|
string | |||
|
externalId
|
externalId | string |
Identifikátor GUID kontaktního id služby Dataverse – svázaný jako nová aktivita telefonního hovoru Týkající se (vytvoření cesty). |
|
|
ID aktivity
|
activityId | string |
Existující identifikátor GUID telefonního volání (activityid) dataverse k dokončení s výsledkem. Vynecháte vytvoření nové aktivity telefonního hovoru. |
|
|
purpose
|
purpose | string | ||
|
pozdrav
|
greeting | string | ||
|
Nashledanou
|
goodbye | string | ||
|
otázky
|
questions | array of string |
Návraty
- Tělo
- PlaceCallResponse
Získání důvodu volání
Získejte důvod volání.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
identifikační číslo
|
id | True | string |
identifikační číslo |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
reason
|
reason | Reason |
Získání hovoru
Zavolejte.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
identifikační číslo
|
id | True | string |
identifikační číslo |
Návraty
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
volání
|
call | Call |
Definice
Pingnout
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Ok
|
ok | boolean | |
|
ID organizace
|
orgId | string | |
|
organizace
|
org | string |
Reason
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
id
|
id | string | |
|
název
|
name | string | |
|
description
|
description | string |
Účel prostého jazyka, který AI předává kontaktu. |
|
stav
|
status | string |
aktivní | Pozastaveno |
|
Dayofweek
|
dayOfWeek | integer |
Týdenní rozvrhový den (1=Po ... 5=Pá). |
|
otázky
|
questions | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | |
|
smsMessage
|
smsMessage | string | |
|
contactCount
|
contactCount | integer |
PlaceCallResponse
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID volání
|
callId | string | |
|
stav
|
status | string |
Call
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID volání
|
callId | string | |
|
reasonId
|
reasonId | string | |
|
stav
|
status | string |
čeká na vyřízení | kontakt | in_progress | dokončeno | Nezdařilo se | odmítnuto |
|
výsledek
|
outcome | string |
dokončeno | no_answer | odmítnuto | in_progress |
|
název
|
contact.name | string | |
|
phone
|
contact.phone | string | |
|
externalId
|
contact.externalId | string | |
|
souhrn
|
summary | string | |
|
issueRaised
|
issueRaised | boolean | |
|
poznámky
|
notes | string | |
|
durationSec
|
durationSec | integer | |
|
completedAt
|
completedAt | string | |
|
createdAt
|
createdAt | string |