VoxAide (preview)
Plaats AI-spraakoproepen voor contactpersonen om een geconfigureerde reden en lees het resultaat van elke oproep. Paren met de VoxAide voor Dynamics 365 beheerde oplossing. Verifiëren met een VoxAide-API-sleutel (Instellingen → Integrations → Dynamics 365).
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Naam | VoxAide-ondersteuning |
| URL | https://voxaide.co |
| E-mailen | support@voxaide.co |
| Connectormetagegevens | |
|---|---|
| Uitgever | Soevereine IT-oplossingen beperkt |
| Website | https://voxaide.co |
| Privacybeleid | https://voxaide.co/privacy |
| Categorieën | Communicatie; Verkoop en CRM |
VoxAide
VoxAide plaatst AI-spraakoproepen om een reden die u kiest voor uw contactpersonen, stelt de vragen die u hebt ingesteld en retourneert het resultaat van elke oproep: een samenvatting, of er een probleem is gegenereerd, de duur en status. Gebruik deze om Power Automate stromen te bouwen die personen automatisch aanroepen (check-ins, bevestigingen, herinneringen, referentiecontroles) en het resultaat terugschrijven naar uw systemen.
Uitgever
VoxAide (Sovereign IT Solutions Ltd)
Prerequisites
- Een VoxAide-account (meld u aan bij https://voxaide.co). Gesprekken worden getekend op uw VoxAide-abonnement of saldo voor betalen per gebruik.
- De belmogelijkheid is ingeschakeld voor uw VoxAide-organisatie.
- Een Power Automate-, Power Apps- of Logic Apps-abonnement dat premium/aangepaste connectors ondersteunt.
Referenties ophalen
VoxAide wordt geverifieerd met een API-sleutel.
- Meld u aan bij VoxAide op https://voxaide.co.
- Ga naar Instellingen → Integraties.
- Kies Onder de sectie Connector de optie Sleutel genereren en kopieert u de sleutel (deze begint met
vox_live_). Het wordt één keer weergegeven. - Wanneer u in Power Automate de VoxAide-verbinding maakt, plakt u de sleutel in het veld API-sleutel.
U kunt een sleutel op elk gewenst moment intrekken vanuit hetzelfde scherm.
Ondersteunde bewerkingen
| Operation | Description |
|---|---|
| Een oproep doen | Plaats nu om een bepaalde reden een AI-spraakoproep naar een contactpersoon. |
| Oproepen weergeven | Lijst met recente oproepen, nieuwste eerst; poll met since voor updates. |
| Een gesprek krijgen | Haal één aanroep en het resultaat ervan eenmaal af. |
| Oproepredenen vermelden | Vermeld de aanroepredenen die zijn geconfigureerd voor uw organisatie. |
| Een oproepreden maken | Maak een nieuwe reden met een naam en de vragen die u moet stellen. |
| Reden van gesprek ophalen | Haal één reden op met de id. |
| Een oproepreden bijwerken | Werk de naam, planning of vragen van een reden bij. |
| Verbinding testen | Controleer de API-sleutel (gebruikt door de verbindingstest). |
Een typische stroom: plaats een gesprek met een reden en het telefoonnummer van een contactpersoon → poll Een gesprek (of lijstoproepen) ontvangen totdat status →/faileddeclined/completed het geretourneerde summaryoutcome gesprek en issueRaised in uw stroom gebruikt.
Implementatie-instructies
De connectorbestanden zijn apiDefinition.swagger.json, apiProperties.json en icon.png. De connector maken in uw eigen omgeving met de CLI van Power Platform-connectors:
pip install paconn
paconn login
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png
Bekende problemen en beperkingen
- Telefoonnummers moeten de indeling E.164 hebben (bijvoorbeeld
+14155550123). - Het plaatsen van een oproep verbruikt een abonnementsvergoeding of tegoed voor betalen per gebruik; een oproep wordt gefactureerd wanneer deze wordt geplaatst, niet wanneer deze is voltooid.
- Oproepen worden asynchroon geplaatst: Een oproep direct met een
callIden eenpendingstatus retourneren. Poll Get a call for the final outcome. - Het
activityIdveld is bedoeld voor geavanceerde write-back naar een bestaande CRM-activiteit (bijvoorbeeld een Dynamics 365 telefoongespreksactiviteit) en kan worden genegeerd voor de meeste stromen.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| Standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typ | Description | Required |
|---|---|---|---|
| API-sleutel | beveiligde string | De API-sleutel voor deze API | True |
Acties
| Een gesprek krijgen |
Bel eens. |
| Een oproep doen |
Plaatst nu een AI-spraakoproep voor een contactpersoon om de opgegeven reden. Geef de Dataverse-contact-id door als contact.externalId, zodat het resultaat wordt teruggeschreven als een nieuwe telefoongespreksactiviteit op de tijdlijn van die contactpersoon. Als u in plaats daarvan een bestaande activiteit voor telefoongesprekken wilt voltooien (campagnedistributiemodus), geeft u de activityId door. Gebruik inhoud.* om het aanroepscript inline aan te sturen (campagnegestuurd), waarbij de opgeslagen inhoud van de reden wordt overschreven. |
| Een oproepreden bijwerken |
Werk een aanroepreden bij. |
| Een oproepreden maken |
Een oproepreden maken. |
| Oproepen weergeven |
Geeft een lijst van recente oproepen, nieuwste eerst. Gebruik 'sinds' om updates te peilen. |
| Oproepredenen vermelden |
Retourneert de geconfigureerde aanroepredenen (automatiseringen) voor de organisatie. |
| Reden van gesprek ophalen |
Vraag een oproepreden. |
| Verbinding testen |
Controleert de API-sleutel en retourneert de organisatie waaraan deze is toegewezen. |
Een gesprek krijgen
Bel eens.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Id
|
id | True | string |
Id |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
call
|
call | Call |
Een oproep doen
Plaatst nu een AI-spraakoproep voor een contactpersoon om de opgegeven reden. Geef de Dataverse-contact-id door als contact.externalId, zodat het resultaat wordt teruggeschreven als een nieuwe telefoongespreksactiviteit op de tijdlijn van die contactpersoon. Als u in plaats daarvan een bestaande activiteit voor telefoongesprekken wilt voltooien (campagnedistributiemodus), geeft u de activityId door. Gebruik inhoud.* om het aanroepscript inline aan te sturen (campagnegestuurd), waarbij de opgeslagen inhoud van de reden wordt overschreven.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
reasonId
|
reasonId | True | string | |
|
naam
|
name | string | ||
|
phone
|
phone | True | string |
E.164 telefoonnummer. |
|
e-mail
|
string | |||
|
externalId
|
externalId | string |
Dataverse contactid GUID : afhankelijk van de nieuwe activiteit Telefoongesprek met betrekking tot (pad maken). |
|
|
activiteit-ID
|
activityId | string |
Bestaande Dataverse phonecall-GUID (activityid) om TE VOLTOOIEN met het resultaat. Laat weg om een nieuwe telefoongespreksactiviteit te maken. |
|
|
purpose
|
purpose | string | ||
|
Groet
|
greeting | string | ||
|
Goodbye
|
goodbye | string | ||
|
Vragen
|
questions | array of string |
Retouren
- Body
- PlaceCallResponse
Een oproepreden bijwerken
Werk een aanroepreden bij.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Id
|
id | True | string |
Id |
|
naam
|
name | True | string | |
|
beschrijving
|
description | string | ||
|
dayOfWeek
|
dayOfWeek | integer | ||
|
Vragen
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
status
|
status | string |
actief | Onderbroken |
Een oproepreden maken
Een oproepreden maken.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
naam
|
name | True | string | |
|
beschrijving
|
description | string | ||
|
dayOfWeek
|
dayOfWeek | integer | ||
|
Vragen
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
status
|
status | string |
actief | Onderbroken |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
id
|
id | string |
Oproepen weergeven
Geeft een lijst van recente oproepen, nieuwste eerst. Gebruik 'sinds' om updates te peilen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Sinds
|
since | string |
ISO-8601-tijdstempel; alleen aanroepen die na deze aanroepen zijn gemaakt. |
|
|
Status
|
status | string |
Filteren op status (in behandeling, in_progress, voltooid, mislukt, geweigerd). |
|
|
ReasonId
|
reasonId | string |
ReasonId |
|
|
Limit
|
limit | integer |
Limit |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Oproepen
|
calls | array of Call |
Oproepredenen vermelden
Retourneert de geconfigureerde aanroepredenen (automatiseringen) voor de organisatie.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
redenen
|
reasons | array of Reason |
Reden van gesprek ophalen
Vraag een oproepreden.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Id
|
id | True | string |
Id |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
reason
|
reason | Reason |
Verbinding testen
Controleert de API-sleutel en retourneert de organisatie waaraan deze is toegewezen.
Retouren
- Body
- Ping
Definities
Ping
| Name | Pad | Type | Description |
|---|---|---|---|
|
OK
|
ok | boolean | |
|
orgId
|
orgId | string | |
|
Org
|
org | string |
Reason
| Name | Pad | Type | Description |
|---|---|---|---|
|
id
|
id | string | |
|
naam
|
name | string | |
|
beschrijving
|
description | string |
Eenvoudig taalgebruik: de AI-relays naar de contactpersoon. |
|
status
|
status | string |
actief | Onderbroken |
|
dayOfWeek
|
dayOfWeek | integer |
Wekelijkse planningsdag (1=mon... 5=Vr). |
|
Vragen
|
questions | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | |
|
smsMessage
|
smsMessage | string | |
|
contactCount
|
contactCount | integer |
PlaceCallResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
callId
|
callId | string | |
|
status
|
status | string |
Call
| Name | Pad | Type | Description |
|---|---|---|---|
|
callId
|
callId | string | |
|
reasonId
|
reasonId | string | |
|
status
|
status | string |
in behandeling | contact opnemen met | in_progress | voltooid | mislukt | Daalde |
|
resultaat
|
outcome | string |
voltooid | no_answer | geweigerd | in_progress |
|
naam
|
contact.name | string | |
|
phone
|
contact.phone | string | |
|
externalId
|
contact.externalId | string | |
|
samenvatting
|
summary | string | |
|
issueRaised
|
issueRaised | boolean | |
|
Notities
|
notes | string | |
|
durationSec
|
durationSec | integer | |
|
completedAt
|
completedAt | string | |
|
gemaaktOp
|
createdAt | string |