VoxAide (Vorschau)
Tätigen Sie KI-Sprachanrufe an Kontakte aus einem konfigurierten Grund, und lesen Sie das Ergebnis jedes Anrufs. Paart mit der VoxAide für Dynamics 365 verwaltete Lösung. Authentifizieren mit einem VoxAide-API-Schlüssel (Einstellungen → Integrationen → Dynamics 365).
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Standard | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | VoxAide Support |
| URL | https://voxaide.co |
| E‑Mail | support@voxaide.co |
| Connectormetadaten | |
|---|---|
| Herausgeber | Sovereign IT Solutions Limited |
| Website | https://voxaide.co |
| Datenschutzrichtlinie | https://voxaide.co/privacy |
| Kategorien | Kommunikation; Vertrieb und CRM |
VoxAide
VoxAide platziert AI-Sprachanrufe aus einem von Ihnen ausgewählten Grund an Ihre Kontakte, stellt die von Ihnen festgelegten Fragen und gibt das Ergebnis jedes Anrufs zurück – eine Zusammenfassung, ob ein Problem ausgelöst wurde, die Dauer und den Status. Verwenden Sie sie, um Power Automate Flüsse zu erstellen, die Personen automatisch aufrufen (Einchecken, Bestätigungen, Erinnerungen, Referenzprüfungen) und das Ergebnis wieder in Ihre Systeme schreiben.
Herausgeber
VoxAide (Sovereign IT Solutions Ltd)
Voraussetzungen
- Ein VoxAide-Konto (registrieren Sie sich bei https://voxaide.co). Anrufe zeichnen auf Ihren VoxAide-Plan oder pay-as-you-go-Saldo.
- Die in Ihrer VoxAide-Organisation aktivierte Anruffunktion.
- Ein Power Automate-, Power Apps- oder Logic-Apps-Plan, der Premium-/benutzerdefinierte Connectors unterstützt.
So erhalten Sie Anmeldeinformationen
VoxAide authentifiziert sich mit einem API-Schlüssel.
- Melden Sie sich bei VoxAide bei https://voxaide.co.
- Wechseln Sie zu "Einstellungen" → Integrationen.
- Wählen Sie unter dem Abschnitt "Connector" die Option " Schlüssel generieren " aus, und kopieren Sie den Schlüssel (beginnt mit
vox_live_). Es wird einmal angezeigt. - Fügen Sie in Power Automate beim Erstellen der VoxAide-Verbindung den Schlüssel in das FELD "API-Schlüssel" ein.
Sie können eine Taste jederzeit auf demselben Bildschirm widerrufen.
Unterstützte Operationen
| Operation | Description |
|---|---|
| Einen Anruf tätigen | Tätigen Sie jetzt einen KI-Sprachanruf an einen Kontakt aus einem bestimmten Grund. |
| Auflisten von Anrufen | Zuletzt verwendete Anrufe auflisten, die am neuesten sind; Umfrage mit since Updates. |
| Rufen Sie einen Anruf ab | Rufen Sie einen einzelnen Anruf und dessen Ergebnis nach abschluss ab. |
| Anrufgründe auflisten | Listet die für Ihre Organisation konfigurierten Anrufgründe auf. |
| Erstellen eines Anrufgrunds | Erstellen Sie einen neuen Grund mit einem Namen und den Fragen, die Sie stellen möchten. |
| Rufen Sie einen Anrufgrund ab | Rufen Sie einen einzelnen Grund anhand des Bezeichners ab. |
| Aktualisieren eines Anrufgrunds | Aktualisieren Sie den Namen, den Zeitplan oder die Fragen eines Grunds. |
| Verbindung testen | Überprüfen Sie den API-Schlüssel (verwendet vom Verbindungstest). |
Ein typischer Ablauf: Tätigen Eines Anrufs mit einem Grund und der Telefonnummer eines Kontakts → Abrufen eines Anrufs (oder Listenanrufe) bis statusfailed/declinedcompleted/→ die zurückgegebene summaryoutcome Und issueRaised in Ihrem Flow verwenden.
Anweisungen zur Bereitstellung
Die Connectordateien sind apiDefinition.swagger.jsonund apiProperties.jsonicon.png. So erstellen Sie den Connector in Ihrer eigenen Umgebung mit der Power Platform Connectors CLI:
pip install paconn
paconn login
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png
Bekannte Probleme und Einschränkungen
- Telefonnummern müssen im E.164-Format vorliegen (z. B
+14155550123. ). - Das Tätigen eines Anrufs verbraucht die Planzulage oder die zahlung-as-you-go-Gutschrift; ein Anruf wird abgerechnet, wenn er platziert wird, nicht, wenn er abgeschlossen ist.
- Aufrufe werden asynchron platziert: Ein Aufruf wird sofort mit einem
callIdUnd einempendingStatus zurückgegeben. Abrufen eines Anrufs für das endgültige Ergebnis. - Das
activityIdFeld dient zum erweiterten Zurückschreiben auf eine vorhandene CRM-Aktivität (z. B. eine Dynamics 365 Telefonanrufaktivität) und kann für die meisten Flüsse ignoriert werden.
Eine Verbindung wird erstellt
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| API-Schlüssel | Securestring | Der API-Schlüssel für diese API | True |
Aktionen
| Aktualisieren eines Anrufgrunds |
Aktualisieren sie einen Anrufgrund. |
| Anrufgründe auflisten |
Gibt die konfigurierten Anrufgründe (Automatisierungen) für die Organisation zurück. |
| Auflisten von Anrufen |
Listet zuletzt aufgerufene Anrufe auf, die am neuesten sind. Verwenden Sie "Since", um Updates abzufragen. |
| Erstellen eines Anrufgrunds |
Erstellen Sie einen Anrufgrund. |
| Rufen Sie einen Anruf ab |
Rufen Sie einen Anruf ab. |
| Rufen Sie einen Anrufgrund ab |
Rufen Sie einen Anrufgrund ab. |
| Tätigen eines Anrufs |
Platziert jetzt einen KI-Sprachanruf an einen Kontakt aus dem angegebenen Grund. Übergeben Sie die Dataverse contactid als contact.externalId, sodass das Ergebnis als neue Telefonanrufaktivität auf der Zeitachse dieses Kontakts zurückgeschrieben wird. Um eine vorhandene Telefonanrufaktivität stattdessen abzuschließen (Kampagnenverteilungsmodus), übergeben Sie die Aktivitäts-ID. Verwenden Sie Content.* zum Steuern des Aufrufskripts inline (kampagnengesteuert), um den gespeicherten Inhalt des Grundes außer Kraft zu setzen. |
| Verbindung testen |
Überprüft den API-Schlüssel und gibt die Organisation zurück, der er zugeordnet ist. |
Aktualisieren eines Anrufgrunds
Aktualisieren sie einen Anrufgrund.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID |
|
Name
|
name | True | string | |
|
description
|
description | string | ||
|
TagDerWoche
|
dayOfWeek | integer | ||
|
Fragen
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
status
|
status | string |
aktiv | Angehalten |
Anrufgründe auflisten
Gibt die konfigurierten Anrufgründe (Automatisierungen) für die Organisation zurück.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Gründe
|
reasons | array of Reason |
Auflisten von Anrufen
Listet zuletzt aufgerufene Anrufe auf, die am neuesten sind. Verwenden Sie "Since", um Updates abzufragen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Seit
|
since | string |
ISO-8601-Zeitstempel; nur Anrufe, die zu/nach diesem Zeitpunkt erstellt wurden. |
|
|
Status
|
status | string |
Filtern nach Status (ausstehend, in_progress, abgeschlossen, fehlgeschlagen, abgelehnt). |
|
|
ReasonId
|
reasonId | string |
ReasonId |
|
|
Limit
|
limit | integer |
Limit |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anrufe
|
calls | array of Call |
Erstellen eines Anrufgrunds
Erstellen Sie einen Anrufgrund.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name
|
name | True | string | |
|
description
|
description | string | ||
|
TagDerWoche
|
dayOfWeek | integer | ||
|
Fragen
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
status
|
status | string |
aktiv | Angehalten |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
id
|
id | string |
Rufen Sie einen Anruf ab
Rufen Sie einen Anruf ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
call
|
call | Call |
Rufen Sie einen Anrufgrund ab
Rufen Sie einen Anrufgrund ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Grund
|
reason | Reason |
Tätigen eines Anrufs
Platziert jetzt einen KI-Sprachanruf an einen Kontakt aus dem angegebenen Grund. Übergeben Sie die Dataverse contactid als contact.externalId, sodass das Ergebnis als neue Telefonanrufaktivität auf der Zeitachse dieses Kontakts zurückgeschrieben wird. Um eine vorhandene Telefonanrufaktivität stattdessen abzuschließen (Kampagnenverteilungsmodus), übergeben Sie die Aktivitäts-ID. Verwenden Sie Content.* zum Steuern des Aufrufskripts inline (kampagnengesteuert), um den gespeicherten Inhalt des Grundes außer Kraft zu setzen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
reasonId
|
reasonId | True | string | |
|
Name
|
name | string | ||
|
phone
|
phone | True | string |
E.164-Telefonnummer. |
|
email
|
string | |||
|
externalId
|
externalId | string |
Dataverse contactid GUID – gebunden als die neue Anrufaktivität in Bezug (Create Path). |
|
|
activityId
|
activityId | string |
Vorhandene Dataverse phonecall (activityid) GUID to COMPLETE with the outcome. Lassen Sie dies aus, um eine neue Telefonanrufaktivität zu erstellen. |
|
|
Zweck
|
purpose | string | ||
|
Gruß
|
greeting | string | ||
|
verabschieden
|
goodbye | string | ||
|
Fragen
|
questions | array of string |
Gibt zurück
- Körper
- PlaceCallResponse
Verbindung testen
Überprüft den API-Schlüssel und gibt die Organisation zurück, der er zugeordnet ist.
Gibt zurück
- Körper
- Ping
Definitionen
Pingen
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Okay
|
ok | boolean | |
|
orgId
|
orgId | string | |
|
Org
|
org | string |
Grund
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
id
|
id | string | |
|
Name
|
name | string | |
|
description
|
description | string |
Nur-Sprache Zweck der KI leitet an den Kontakt weiter. |
|
status
|
status | string |
aktiv | Angehalten |
|
TagDerWoche
|
dayOfWeek | integer |
Wochenplantag (1=Mon ... 5=Fri). |
|
Fragen
|
questions | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | |
|
smsMessage
|
smsMessage | string | |
|
contactCount
|
contactCount | integer |
PlaceCallResponse
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
callId
|
callId | string | |
|
status
|
status | string |
Call
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
callId
|
callId | string | |
|
reasonId
|
reasonId | string | |
|
status
|
status | string |
Ausstehend | Kontakt | in_progress | abgeschlossen | fehlgeschlagen | Abgelehnt |
|
Ergebnis
|
outcome | string |
abgeschlossen | no_answer | abgelehnt | in_progress |
|
Name
|
contact.name | string | |
|
phone
|
contact.phone | string | |
|
externalId
|
contact.externalId | string | |
|
summary
|
summary | string | |
|
issueRaised
|
issueRaised | boolean | |
|
Notizen
|
notes | string | |
|
durationSec
|
durationSec | integer | |
|
completedAt
|
completedAt | string | |
|
createdAt
|
createdAt | string |