VoxAide (préversion)
Placez des appels vocaux IA aux contacts pour une raison configurée et lisez le résultat de chaque appel. Paires avec VoxAide pour Dynamics 365 solution managée. Authentifiez-vous avec une clé API VoxAide (Paramètres → Integrations → Dynamics 365).
Ce connecteur est disponible dans les produits et régions suivants :
| Service | Classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Prise en charge de VoxAide |
| URL | https://voxaide.co |
| Messagerie électronique | support@voxaide.co |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Solutions informatiques souveraines limitées |
| Website | https://voxaide.co |
| Politique de confidentialité | https://voxaide.co/privacy |
| Catégories | Communication; Ventes et CRM |
VoxAide
VoxAide place les appels vocaux IA à vos contacts pour une raison que vous choisissez, pose les questions que vous définissez et retourne le résultat de chaque appel : un résumé, si un problème a été déclenché, la durée et l’état. Utilisez-la pour générer des flux Power Automate qui appellent automatiquement des personnes (archivages, confirmations, rappels, vérifications de référence) et réécrit le résultat dans vos systèmes.
Éditeur
VoxAide (Sovereign IT Solutions Ltd)
Prerequisites
- Un compte VoxAide (inscrivez-vous à https://voxaide.co). Les appels s’appuient sur votre plan VoxAide ou votre solde de paiement à l’utilisation.
- Fonctionnalité d’appel activée sur votre organisation VoxAide.
- Un plan Power Automate, Power Apps ou Logic Apps qui prend en charge les connecteurs premium/personnalisés.
Comment obtenir des informations d’identification
VoxAide s’authentifie avec une clé API.
- Connectez-vous à VoxAide à l’adresse https://voxaide.co.
- Accédez aux paramètres → Intégrations.
- Sous la section connecteur, choisissez Générer une clé et copiez la clé (elle commence par
vox_live_). Il est affiché une seule fois. - Dans Power Automate, lorsque vous créez la connexion VoxAide, collez la clé dans le champ Clé API.
Vous pouvez révoquer une clé à tout moment à partir du même écran.
Opérations prises en charge
| Operation | Description |
|---|---|
| Passer un appel | Placez un appel vocal IA maintenant à un contact pour une raison donnée. |
| Répertorier les appels | Répertorier les appels récents, le plus récent en premier ; interrogez les since mises à jour. |
| Obtenir un appel | Obtenez un seul appel et son résultat une fois terminé. |
| Répertorier les raisons de l’appel | Répertoriez les raisons d’appel configurées pour votre organisation. |
| Créer une raison d’appel | Créez une nouvelle raison avec un nom et les questions à poser. |
| Obtenir une raison d’appel | Obtenez une seule raison par son identificateur. |
| Mettre à jour une raison d’appel | Mettez à jour le nom, la planification ou les questions d’une raison. |
| Tester la connexion | Vérifiez la clé API (utilisée par le test de connexion). |
Flux classique : placez un appel avec une raison et le numéro de téléphone d’un contact → interrogez Obtenir un appel (ou répertorier les appels) jusqu’à ce qu’il status soitfailed/declined/completed → utiliser les appels retournés summaryet outcomeissueRaised dans votre flux.
Instructions de déploiement
Les fichiers du connecteur sont apiDefinition.swagger.json, apiProperties.json et icon.png. Pour créer le connecteur dans votre propre environnement avec l’interface CLI des connecteurs Power Platform :
pip install paconn
paconn login
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png
Problèmes connus et limitations
- Les numéros de téléphone doivent être au format E.164 (par exemple
+14155550123). - Le placement d’un appel consomme une allocation de plan ou un crédit de paiement à l’utilisation ; un appel est facturé lorsqu’il est placé, et non lorsqu’il est terminé.
- Les appels sont placés de façon asynchrone : placez un appel immédiatement avec un état et un
callIdpendingétat. Interrogez Obtenir un appel pour le résultat final. - Le
activityIdchamp est destiné à une écriture différée avancée dans une activité CRM existante (par exemple, une activité d’appel téléphonique Dynamics 365) et peut être ignoré pour la plupart des flux.
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Impossible à partager |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Ce n’est pas une connexion partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Catégorie | Description | Obligatoire |
|---|---|---|---|
| Clé API | Securestring | Clé API pour cette API | True |
Actions
| Créer une raison d’appel |
Créez une raison d’appel. |
| Mettre à jour une raison d’appel |
Mettez à jour une raison d’appel. |
| Obtenir un appel |
Obtenez un appel. |
| Obtenir une raison d’appel |
Obtenez une raison d’appel. |
| Passer un appel |
Place un appel vocal IA maintenant à un contact pour la raison donnée. Transmettez le contactid Dataverse en tant que contact.externalId afin que le résultat soit réécrit en tant que nouvelle activité d’appel téléphonique dans la chronologie de ce contact. Pour terminer une activité d’appel téléphonique existante à la place (mode de distribution de campagne), transmettez son id d’activité. Utilisez le contenu.* pour piloter le script d’appel inline (piloté par la campagne), en remplaçant le contenu stocké de la raison. |
| Répertorier les appels |
Répertorie les appels récents, le plus récent en premier. Utilisez « since » pour interroger les mises à jour. |
| Répertorier les raisons de l’appel |
Retourne les raisons d’appel configurées (automatisations) pour l’organisation. |
| Tester la connexion |
Vérifie la clé API et retourne l’organisation à laquelle elle est mappée. |
Créer une raison d’appel
Créez une raison d’appel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
nom
|
name | True | string | |
|
description
|
description | string | ||
|
dayOfWeek
|
dayOfWeek | integer | ||
|
Questions
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
status
|
status | string |
actif | Pause |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
id
|
id | string |
Mettre à jour une raison d’appel
Mettez à jour une raison d’appel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Id
|
id | True | string |
Id |
|
nom
|
name | True | string | |
|
description
|
description | string | ||
|
dayOfWeek
|
dayOfWeek | integer | ||
|
Questions
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
status
|
status | string |
actif | suspendu |
Obtenir un appel
Obtenez un appel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Id
|
id | True | string |
Id |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
call
|
call | Call |
Obtenir une raison d’appel
Obtenez une raison d’appel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Id
|
id | True | string |
Id |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
raison
|
reason | Reason |
Passer un appel
Place un appel vocal IA maintenant à un contact pour la raison donnée. Transmettez le contactid Dataverse en tant que contact.externalId afin que le résultat soit réécrit en tant que nouvelle activité d’appel téléphonique dans la chronologie de ce contact. Pour terminer une activité d’appel téléphonique existante à la place (mode de distribution de campagne), transmettez son id d’activité. Utilisez le contenu.* pour piloter le script d’appel inline (piloté par la campagne), en remplaçant le contenu stocké de la raison.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
reasonId
|
reasonId | True | string | |
|
nom
|
name | string | ||
|
phone
|
phone | True | string |
Numéro de téléphone E.164. |
|
email
|
string | |||
|
identifiant externe
|
externalId | string |
GUID de contactid Dataverse : lié en tant que nouvel activité d’appel téléphonique concernant (créer le chemin d’accès). |
|
|
ID d'activité
|
activityId | string |
GUID dataverse phonecall (activityid) existant à TERMINER avec le résultat. Omettez de créer une activité d’appel téléphonique. |
|
|
objectif
|
purpose | string | ||
|
Salutation
|
greeting | string | ||
|
Au revoir
|
goodbye | string | ||
|
Questions
|
questions | array of string |
Retours
- Corps
- PlaceCallResponse
Répertorier les appels
Répertorie les appels récents, le plus récent en premier. Utilisez « since » pour interroger les mises à jour.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Depuis
|
since | string |
Horodatage ISO-8601 ; seuls les appels créés à/après cela. |
|
|
Status
|
status | string |
Filtrer par état (en attente, in_progress, terminé, échoué, refusé). |
|
|
ReasonId
|
reasonId | string |
ReasonId |
|
|
Limit
|
limit | integer |
Limit |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
appels
|
calls | array of Call |
Répertorier les raisons de l’appel
Retourne les raisons d’appel configurées (automatisations) pour l’organisation.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Raisons
|
reasons | array of Reason |
Tester la connexion
Définitions
Ping
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
D'accord
|
ok | boolean | |
|
orgId
|
orgId | string | |
|
Org
|
org | string |
Reason
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
id
|
id | string | |
|
nom
|
name | string | |
|
description
|
description | string |
Usage en langage brut, l’IA relaie au contact. |
|
status
|
status | string |
actif | Pause |
|
dayOfWeek
|
dayOfWeek | integer |
Jour de planification hebdomadaire (1=Mon ... 5=Fri). |
|
Questions
|
questions | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | |
|
smsMessage
|
smsMessage | string | |
|
contactCount
|
contactCount | integer |
PlaceCallResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
callId
|
callId | string | |
|
status
|
status | string |
Call
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
callId
|
callId | string | |
|
reasonId
|
reasonId | string | |
|
status
|
status | string |
en attente | contact | in_progress | terminé | échec | Refusé |
|
résultat
|
outcome | string |
terminé | no_answer | refusé | in_progress |
|
nom
|
contact.name | string | |
|
phone
|
contact.phone | string | |
|
identifiant externe
|
contact.externalId | string | |
|
summary
|
summary | string | |
|
issueRaised
|
issueRaised | boolean | |
|
Remarques
|
notes | string | |
|
durationSec
|
durationSec | integer | |
|
completedAt
|
completedAt | string | |
|
createdAt
|
createdAt | string |