VoxAide (versión preliminar)
Coloque llamadas de voz de IA a los contactos por un motivo configurado y lea el resultado de cada llamada. Empareja con VoxAide para Dynamics 365 solución administrada. Autentíquese con una clave de API de VoxAide (Configuración → Integrations → Dynamics 365).
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Compatibilidad con VoxAide |
| DIRECCIÓN URL | https://voxaide.co |
| support@voxaide.co |
| Metadatos del conector | |
|---|---|
| Publicador | Soluciones de TI soberanas limitadas |
| Sitio web | https://voxaide.co |
| Directiva de privacidad | https://voxaide.co/privacy |
| Categorías | Comunicación; Ventas y CRM |
VoxAide
VoxAide coloca llamadas de voz de IA a sus contactos por un motivo que elija, formula las preguntas que ha establecido y devuelve el resultado de cada llamada, un resumen, si se ha generado un problema, la duración y el estado. Úselo para crear flujos de Power Automate que llaman automáticamente a personas (comprobaciones de entrada, confirmaciones, recordatorios, comprobaciones de referencia) y escriben el resultado en los sistemas.
Publicador
VoxAide (Sovereign IT Solutions Ltd)
Prerequisites
- Una cuenta de VoxAide (regístrese en https://voxaide.co). Las llamadas se basan en el plan voxAide o el saldo de pago por uso.
- La funcionalidad de llamada habilitada en la organización de VoxAide.
- Un plan de Power Automate, Power Apps o Logic Apps que admita conectores premium o personalizados.
Obtención de credenciales
VoxAide se autentica con una clave de API.
- Inicie sesión en VoxAide en https://voxaide.co.
- Vaya a Configuración → Integraciones.
- En la sección conector, elija Generar clave y copie la clave (comienza por
vox_live_). Se muestra una vez. - En Power Automate, al crear la conexión de VoxAide, pegue la clave en el campo Clave de API.
Puede revocar una clave en cualquier momento desde la misma pantalla.
Operaciones soportadas
| Operation | Description |
|---|---|
| Realización de una llamada | Realice una llamada de voz de IA ahora a un contacto por un motivo determinado. |
| Enumerar llamadas | Enumerar las llamadas recientes, más recientes primero; sondee las since actualizaciones. |
| Obtener una llamada | Obtenga una sola llamada y su resultado una vez finalizado. |
| Enumerar los motivos de la llamada | Enumere los motivos de llamada configurados para su organización. |
| Creación de un motivo de llamada | Cree un nuevo motivo con un nombre y las preguntas que se van a formular. |
| Obtener un motivo de llamada | Obtenga un único motivo por su identificador. |
| Actualizar un motivo de llamada | Actualice el nombre, la programación o las preguntas de un motivo. |
| Probar conexión | Compruebe la clave de API (usada por la prueba de conexión). |
Un flujo típico: coloque una llamada con un motivo y el número de teléfono de un contacto → sondee obtener una llamada (o llamadas de lista) hasta status que se/completeddeclined/failed → use el devuelto summaryoutcome y issueRaised en el flujo.
Instrucciones de implementación
Los archivos del conector son apiDefinition.swagger.json, apiProperties.json y icon.png. Para crear el conector en su propio entorno con la CLI de Power Platform Connectors:
pip install paconn
paconn login
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png
Limitaciones y problemas conocidos
- Los números de teléfono deben estar en formato E.164 (por ejemplo
+14155550123). - La colocación de una llamada consume la asignación del plan o el crédito de pago por uso; Se factura una llamada cuando se realiza, no cuando se completa.
- Las llamadas se realizan de forma asincrónica: la devolución de una llamada se devuelve inmediatamente con un
callIdestado y .pendingSondee obtener una llamada para el resultado final. - El
activityIdcampo es para la reescritura avanzada en una actividad de CRM existente (por ejemplo, una actividad de llamada telefónica de Dynamics 365) y se puede omitir para la mayoría de los flujos.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Required |
|---|---|---|---|
| Clave de API | securestring | La clave de API de esta API | True |
Acciones
| Actualizar un motivo de llamada |
Actualice un motivo de llamada. |
| Creación de un motivo de llamada |
Cree un motivo de llamada. |
| Enumerar llamadas |
Enumera las llamadas recientes, más recientes primero. Use "since" para sondear las actualizaciones. |
| Enumerar los motivos de la llamada |
Devuelve los motivos de llamada configurados (automatizaciones) de la organización. |
| Obtener un motivo de llamada |
Obtenga un motivo de llamada. |
| Obtener una llamada |
Obtenga una llamada. |
| Probar conexión |
Comprueba la clave de API y devuelve la organización a la que se asigna. |
| Realización de una llamada |
Realiza una llamada de voz de IA ahora a un contacto por el motivo dado. Pase el contactid de Dataverse como contact.externalId para que el resultado se escriba como una nueva actividad de llamada telefónica en la escala de tiempo del contacto. Para completar una actividad de llamada telefónica existente en su lugar (modo de distribución de campaña), pase su activityId. Use content.* para controlar el script de llamada insertado (controlado por campañas), reemplazando el contenido almacenado del motivo. |
Actualizar un motivo de llamada
Actualice un motivo de llamada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id
|
id | True | string |
Id |
|
nombre
|
name | True | string | |
|
description
|
description | string | ||
|
díaDeLaSemana
|
dayOfWeek | integer | ||
|
preguntas
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
estado
|
status | string |
activo | pausado |
Creación de un motivo de llamada
Cree un motivo de llamada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
nombre
|
name | True | string | |
|
description
|
description | string | ||
|
díaDeLaSemana
|
dayOfWeek | integer | ||
|
preguntas
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
estado
|
status | string |
activo | pausado |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
Enumerar llamadas
Enumera las llamadas recientes, más recientes primero. Use "since" para sondear las actualizaciones.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Desde
|
since | string |
Marca de tiempo ISO-8601; solo llama a en/después de esto. |
|
|
Situación
|
status | string |
Filtre por estado (pendiente, in_progress, completado, erróneo, rechazado). |
|
|
ReasonId
|
reasonId | string |
ReasonId |
|
|
Limit
|
limit | integer |
Limit |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
llamadas
|
calls | array of Call |
Enumerar los motivos de la llamada
Devuelve los motivos de llamada configurados (automatizaciones) de la organización.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
razones
|
reasons | array of Reason |
Obtener un motivo de llamada
Obtenga un motivo de llamada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id
|
id | True | string |
Id |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
razón
|
reason | Reason |
Obtener una llamada
Obtenga una llamada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id
|
id | True | string |
Id |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
llamada
|
call | Call |
Probar conexión
Realización de una llamada
Realiza una llamada de voz de IA ahora a un contacto por el motivo dado. Pase el contactid de Dataverse como contact.externalId para que el resultado se escriba como una nueva actividad de llamada telefónica en la escala de tiempo del contacto. Para completar una actividad de llamada telefónica existente en su lugar (modo de distribución de campaña), pase su activityId. Use content.* para controlar el script de llamada insertado (controlado por campañas), reemplazando el contenido almacenado del motivo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
reasonId
|
reasonId | True | string | |
|
nombre
|
name | string | ||
|
phone
|
phone | True | string |
Número de teléfono E.164. |
|
email
|
string | |||
|
externalId
|
externalId | string |
GUID de contactid de Dataverse: enlazado como la nueva actividad de llamada telefónica con respecto a (crear ruta de acceso). |
|
|
activityId
|
activityId | string |
GUID de llamada telefónica de Dataverse (activityid) existente para COMPLETAR con el resultado. Omitir para crear una nueva actividad de llamada telefónica. |
|
|
propósito
|
purpose | string | ||
|
saludo
|
greeting | string | ||
|
adiós
|
goodbye | string | ||
|
preguntas
|
questions | array of string |
Devoluciones
- Body
- PlaceCallResponse
Definiciones
Ping
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
De acuerdo
|
ok | boolean | |
|
orgId
|
orgId | string | |
|
organización
|
org | string |
Reason
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
id | string | |
|
nombre
|
name | string | |
|
description
|
description | string |
Propósito de lenguaje sin formato que la inteligencia artificial retransmite al contacto. |
|
estado
|
status | string |
activo | pausado |
|
díaDeLaSemana
|
dayOfWeek | integer |
Día de programación semanal (1=Mon ... 5=Fri). |
|
preguntas
|
questions | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | |
|
smsMessage
|
smsMessage | string | |
|
contactCount
|
contactCount | integer |
PlaceCallResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
callId
|
callId | string | |
|
estado
|
status | string |
Call
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
callId
|
callId | string | |
|
reasonId
|
reasonId | string | |
|
estado
|
status | string |
pendiente | contacting | in_progress | completed | failed | rechazado |
|
resultado
|
outcome | string |
completed | no_answer | rechazado | in_progress |
|
nombre
|
contact.name | string | |
|
phone
|
contact.phone | string | |
|
externalId
|
contact.externalId | string | |
|
summary
|
summary | string | |
|
issueRaised
|
issueRaised | boolean | |
|
notas
|
notes | string | |
|
durationSec
|
durationSec | integer | |
|
completedAt
|
completedAt | string | |
|
createdAt
|
createdAt | string |