VoxAide (anteprima)

Inserire chiamate vocali di intelligenza artificiale ai contatti per un motivo configurato e leggere il risultato di ogni chiamata. Coppie con VoxAide per Dynamics 365 soluzione gestita. Eseguire l'autenticazione con una chiave API VoxAide (Impostazioni → Integrations → Dynamics 365).

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Service Class Regions
Copilot Studio Di alta qualità Tutte le aree Power Automate ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica Standard Tutte le aree di App per la logica , ad eccezione delle seguenti:
     - Aree di Azure per enti pubblici
     - Azure cina
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps Di alta qualità Tutte le aree Power Apps ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate Di alta qualità Tutte le aree Power Automate ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Contatto
Nome Supporto di VoxAide
URL https://voxaide.co
Posta elettronica support@voxaide.co
Metadati del connettore
Editore Soluzioni IT sovrane limitate
Sito web https://voxaide.co
Informativa sulla privacy https://voxaide.co/privacy
Categories Comunicazione; Vendite e CRM

VoxAide

VoxAide inserisce chiamate vocali di intelligenza artificiale ai contatti per un motivo scelto, pone le domande impostate e restituisce il risultato di ogni chiamata, ovvero un riepilogo, se è stato generato un problema, la durata e lo stato. Usarlo per creare flussi Power Automate che chiamano automaticamente le persone (check-in, conferme, promemoria, controlli di riferimento) e riscrivono il risultato nei sistemi.

Editore

VoxAide (Sovereign IT Solutions Ltd)

Prerequisiti

  • Un account VoxAide (iscriversi all'indirizzo https://voxaide.co). Le chiamate disegnano sul piano VoxAide o sul saldo con pagamento in base al consumo.
  • La funzionalità di chiamata abilitata nell'organizzazione VoxAide.
  • Piano Power Automate, Power Apps o App per la logica che supporta connettori premium/personalizzati.

Come ottenere le credenziali

VoxAide esegue l'autenticazione con una chiave API.

  1. Accedere a VoxAide all'indirizzo https://voxaide.co.
  2. Passare a Impostazioni → Integrazioni.
  3. Nella sezione connettore scegliere Genera chiave e copiare la chiave (inizia con vox_live_). Viene visualizzato una sola volta.
  4. In Power Automate, quando si crea la connessione VoxAide, incollare la chiave nel campo Chiave API.

È possibile revocare una chiave in qualsiasi momento dalla stessa schermata.

Operazioni supportate

Operation Descrzione
Effettuare una chiamata Inserire ora una chiamata vocale di intelligenza artificiale a un contatto per un determinato motivo.
Elencare le chiamate Elencare le chiamate recenti, più recenti prima; eseguire il polling con since per gli aggiornamenti.
Ottenere una chiamata Ottenere una singola chiamata e il relativo risultato una volta concluso.
Elencare i motivi delle chiamate Elencare i motivi di chiamata configurati per l'organizzazione.
Creare un motivo di chiamata Creare un nuovo motivo con un nome e le domande da porre.
Ottenere un motivo di chiamata Ottenere un singolo motivo in base al relativo identificatore.
Aggiornare un motivo di chiamata Aggiornare il nome, la pianificazione o le domande di un motivo.
Testare la connessione Verificare la chiave API (usata dal test della connessione).

Flusso tipico: effettuare una chiamata con un motivo e il numero di telefono di un contatto → eseguire il polling Ottenere una chiamata (o Elenca chiamate) fino a quando status non viene/completeddeclined/failed → usare il restituito summaryoutcome e issueRaised nel flusso.

Istruzioni per la distribuzione

I file del connettore sono apiDefinition.swagger.jsone apiProperties.jsonicon.png. Per creare il connettore nel proprio ambiente con l'interfaccia della riga di comando di Power Platform Connectors:

pip install paconn
paconn login
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png

Problemi noti e limitazioni

  • I numeri di telefono devono essere in formato E.164 (ad esempio +14155550123).
  • L'inserimento di una chiamata consuma l'indennità di piano o il credito con pagamento in base al consumo; una chiamata viene fatturata quando viene inserita, non al termine.
  • Le chiamate vengono inserite in modo asincrono: inserire una chiamata immediatamente con un callId e uno pending stato. Poll Ottenere una chiamata per il risultato finale.
  • Il activityId campo è destinato al writeback avanzato in un'attività CRM esistente (ad esempio un'attività di Dynamics 365 chiamata telefonica) e può essere ignorata per la maggior parte dei flussi.

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:
Predefinita Parametri per la creazione della connessione. Tutte le aree geografiche Non condivisibile

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa connessione non è condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome Tipo Descrzione Obbligatorio
Chiave API Securestring Chiave API per questa API True

Azioni

Aggiornare un motivo di chiamata

Aggiornare un motivo di chiamata.
Connessione di test

Verifica la chiave API e restituisce l'organizzazione a cui esegue il mapping.
Creare un motivo di chiamata

Creare un motivo di chiamata.
Effettuare una chiamata

Inserisce ora una chiamata vocale di intelligenza artificiale a un contatto per il motivo specificato. Passare dataverse contactid come contact.externalId in modo che il risultato venga riscritto come nuova attività chiamata telefonica nella sequenza temporale del contatto. Per COMPLETARE un'attività chiamata telefonica esistente (modalità di distribuzione campagna), passare il relativo activityId. Usare content.* per guidare lo script di chiamata inline (basato su campagna), ignorando il contenuto archiviato del motivo.
Elencare i motivi delle chiamate

Restituisce i motivi di chiamata configurati (automazione) per l'organizzazione.
Elencare le chiamate

Elenca le chiamate recenti, più recenti. Usare 'since' per eseguire il polling degli aggiornamenti.
Ottenere un motivo di chiamata

Ottenere un motivo di chiamata.
Ottenere una chiamata

Ottenere una chiamata.

Aggiornare un motivo di chiamata

ID operazione:
UpdateReason

Aggiornare un motivo di chiamata.

Parametri

Nome Chiave Necessario Tipo Descrizione
id
 id True string

id
nome
 name True string
description
 description string
Dayofweek
 dayOfWeek integer
Domande
 questions True array of string
smsOnNoAnswer
 smsOnNoAnswer boolean
smsMessage
 smsMessage string
stato
 status string

active | sospeso

Connessione di test

ID operazione:
TestConnection

Verifica la chiave API e restituisce l'organizzazione a cui esegue il mapping.

Valori restituiti

Corpo
Ping

Creare un motivo di chiamata

ID operazione:
CreateReason

Creare un motivo di chiamata.

Parametri

Nome Chiave Necessario Tipo Descrizione
nome
 name True string
description
 description string
Dayofweek
 dayOfWeek integer
Domande
 questions True array of string
smsOnNoAnswer
 smsOnNoAnswer boolean
smsMessage
 smsMessage string
stato
 status string

active | Pausa

Valori restituiti

Nome Percorso Tipo Descrizione
id
 id string

Effettuare una chiamata

ID operazione:
PlaceCall

Inserisce ora una chiamata vocale di intelligenza artificiale a un contatto per il motivo specificato. Passare dataverse contactid come contact.externalId in modo che il risultato venga riscritto come nuova attività chiamata telefonica nella sequenza temporale del contatto. Per COMPLETARE un'attività chiamata telefonica esistente (modalità di distribuzione campagna), passare il relativo activityId. Usare content.* per guidare lo script di chiamata inline (basato su campagna), ignorando il contenuto archiviato del motivo.

Parametri

Nome Chiave Necessario Tipo Descrizione
reasonId
 reasonId True string
nome
 name string
phone
 phone True string

Numero di telefono E.164.
email
 email string
externalId
 externalId string

GUID contactid dataverse, associato come attività di chiamata telefonica relativa (percorso di creazione).
activityId
 activityId string

GUID dataverse phonecall (activityid) esistente da completare con il risultato. Omettere di creare una nuova attività chiamata telefonica.
purpose
 purpose string
Saluto
 greeting string
Arrivederci
 goodbye string
Domande
 questions array of string

Valori restituiti

Corpo
PlaceCallResponse

Elencare i motivi delle chiamate

ID operazione:
ListReasons

Restituisce i motivi di chiamata configurati (automazione) per l'organizzazione.

Valori restituiti

Nome Percorso Tipo Descrizione
reasons
 reasons array of Reason

Elencare le chiamate

ID operazione:
ListCalls

Elenca le chiamate recenti, più recenti. Usare 'since' per eseguire il polling degli aggiornamenti.

Parametri

Nome Chiave Necessario Tipo Descrizione
Since
 since string

Timestamp ISO-8601; solo le chiamate create al/dopo.
Condizione
 status string

Filtra per stato (in sospeso, in_progress, completato, non riuscito, rifiutato).
ReasonId
 reasonId string

ReasonId
Limit
 limit integer

Limit

Valori restituiti

Nome Percorso Tipo Descrizione
chiamate
 calls array of Call

Ottenere un motivo di chiamata

ID operazione:
GetReason

Ottenere un motivo di chiamata.

Parametri

Nome Chiave Necessario Tipo Descrizione
id
 id True string

id

Valori restituiti

Nome Percorso Tipo Descrizione
reason
 reason Reason

Ottenere una chiamata

ID operazione:
GetCall

Ottenere una chiamata.

Parametri

Nome Chiave Necessario Tipo Descrizione
id
 id True string

id

Valori restituiti

Nome Percorso Tipo Descrizione
chiamata
 call Call

Definizioni

Ping

Nome Percorso Tipo Descrizione
Ok
 ok boolean
orgId
 orgId string
Org
 org string

Ragione

Nome Percorso Tipo Descrizione
id
 id string
nome
 name string
description
 description string

Scopo in linguaggio semplice, l'intelligenza artificiale inoltra al contatto.
stato
 status string

active | sospeso
Dayofweek
 dayOfWeek integer

Giorno di pianificazione settimanale (1=Lun ... 5=Fri).
Domande
 questions array of string
smsOnNoAnswer
 smsOnNoAnswer boolean
smsMessage
 smsMessage string
contactCount
 contactCount integer

PlaceCallResponse

Nome Percorso Tipo Descrizione
callId
 callId string
stato
 status string

Call

Nome Percorso Tipo Descrizione
callId
 callId string
reasonId
 reasonId string
stato
 status string

in sospeso | contatto | in_progress | completato | failed | Rifiutato
risultato
 outcome string

completato | no_answer | rifiutato | in_progress
nome
 contact.name string
phone
 contact.phone string
externalId
 contact.externalId string
summary
 summary string
problema generato
 issueRaised boolean
note
 notes string
durationSec
 durationSec integer
completedAt
 completedAt string
createdAt
 createdAt string