VoxAide (versão prévia)
Faça chamadas de voz de IA para contatos por um motivo configurado e leia o resultado de cada chamada. Emparelha com o VoxAide para Dynamics 365 solução gerenciada. Autenticar com uma chave de API VoxAide (configurações → integrações → Dynamics 365).
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte ao VoxAide |
| URL | https://voxaide.co |
| support@voxaide.co |
| Metadados do conector | |
|---|---|
| Publicador | Soluções soberanas de TI limitadas |
| Site | https://voxaide.co |
| Política de privacidade | https://voxaide.co/privacy |
| Categories | Comunicação; Vendas e CRM |
VoxAide
O VoxAide coloca chamadas de voz de IA para seus contatos por um motivo que você escolher, faz as perguntas definidas e retorna o resultado de cada chamada – um resumo, se um problema foi gerado, a duração e o status. Use-o para criar Power Automate fluxos que chamam as pessoas automaticamente (check-ins, confirmações, lembretes, verificações de referência) e gravar o resultado de volta em seus sistemas.
Publicador
VoxAide (Sovereign IT Solutions Ltd)
Pré-requisitos
- Uma conta VoxAide (inscreva-se em https://voxaide.co). As chamadas são desenhadas em seu plano VoxAide ou saldo pago conforme o uso.
- O recurso de chamada habilitado em sua organização VoxAide.
- Um plano de Power Automate, Power Apps ou Aplicativos Lógicos que dá suporte a conectores premium/personalizados.
Como obter credenciais
VoxAide autentica com uma chave de API.
- Entre no VoxAide em https://voxaide.co.
- Vá para Configurações → Integrações.
- Na seção do conector, escolha Gerar chave e copie a chave (ela começa com
vox_live_). É mostrado uma vez. - Em Power Automate, ao criar a conexão VoxAide, cole a chave no campo Chave de API.
Você pode revogar uma chave a qualquer momento da mesma tela.
Operações com suporte
| Operation | Description |
|---|---|
| Fazer uma chamada | Faça uma chamada de voz de IA agora para um contato por um determinado motivo. |
| Listar chamadas | Listar chamadas recentes, as mais recentes primeiro; sondagem com since para atualizações. |
| Obter uma chamada | Obtenha uma única chamada e seu resultado após a conclusão. |
| Listar motivos de chamada | Liste os motivos de chamada configurados para sua organização. |
| Criar um motivo de chamada | Crie um novo motivo com um nome e as perguntas a serem feitas. |
| Obter um motivo de chamada | Obtenha um único motivo pelo identificador. |
| Atualizar um motivo de chamada | Atualize o nome, a agenda ou as perguntas de um motivo. |
| Conexão de teste | Verifique a chave de API (usada pelo teste de conexão). |
Um fluxo típico: faça uma chamada com um motivo e o número de telefone de um contato → sondar Obter uma chamada (ou listar chamadas) até status/completeddeclined/failed→ usar o retornado summaryoutcome e issueRaised em seu fluxo.
Instruções de implementação
Os arquivos do conector são apiDefinition.swagger.jsone icon.pngapiProperties.json . Para criar o conector em seu próprio ambiente com a CLI dos Conectores do Power Platform:
pip install paconn
paconn login
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png
Limitações e problemas conhecidos
- Os números de telefone devem estar no formato E.164 (por exemplo
+14155550123). - Fazer uma chamada consome o subsídio de plano ou o crédito pago conforme o uso; uma chamada é cobrada quando é feita, não quando é concluída.
- As chamadas são feitas de forma assíncrona: faça uma chamada retorna imediatamente com um status e um
callIdpendingstatus. Votação Obtenha uma chamada para o resultado final. - O
activityIdcampo é para write-back avançado para uma atividade de CRM existente (por exemplo, uma atividade de chamada telefônica Dynamics 365) e pode ser ignorado para a maioria dos fluxos.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API | Securestring | A chave de API para esta api | Verdade |
Ações
| Atualizar um motivo de chamada |
Atualize um motivo de chamada. |
| Criar um motivo de chamada |
Crie um motivo de chamada. |
| Fazer uma chamada |
Coloca uma chamada de voz de IA agora para um contato pelo motivo determinado. Passe a contactid do Dataverse como contact.externalId para que o resultado seja gravado novamente como uma nova atividade de Chamada Telefônica na linha do tempo do Contato. Para concluir uma atividade de chamada telefônica existente em vez disso (modo de distribuição de campanha), passe sua activityId. Use content.* para conduzir o script de chamada embutido (controlado por campanha), substituindo o conteúdo armazenado do motivo. |
| Listar chamadas |
Lista as chamadas recentes, a mais recente primeiro. Use 'since' para sondar atualizações. |
| Listar motivos de chamada |
Retorna os motivos de chamada configurados (automações) para a organização. |
| Obter um motivo de chamada |
Obtenha um motivo de chamada. |
| Obter uma chamada |
Receber uma chamada. |
| Testar conectividade |
Verifica a chave de API e retorna a organização para a qual ela é mapeada. |
Atualizar um motivo de chamada
Atualize um motivo de chamada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID |
|
nome
|
name | True | string | |
|
description
|
description | string | ||
|
dayOfWeek
|
dayOfWeek | integer | ||
|
perguntas
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
status
|
status | string |
ativo | Pausado |
Criar um motivo de chamada
Crie um motivo de chamada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
nome
|
name | True | string | |
|
description
|
description | string | ||
|
dayOfWeek
|
dayOfWeek | integer | ||
|
perguntas
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
status
|
status | string |
ativo | Pausado |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
Fazer uma chamada
Coloca uma chamada de voz de IA agora para um contato pelo motivo determinado. Passe a contactid do Dataverse como contact.externalId para que o resultado seja gravado novamente como uma nova atividade de Chamada Telefônica na linha do tempo do Contato. Para concluir uma atividade de chamada telefônica existente em vez disso (modo de distribuição de campanha), passe sua activityId. Use content.* para conduzir o script de chamada embutido (controlado por campanha), substituindo o conteúdo armazenado do motivo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
reasonId
|
reasonId | True | string | |
|
nome
|
name | string | ||
|
phone
|
phone | True | string |
Número de telefone E.164. |
|
email
|
string | |||
|
externalId
|
externalId | string |
GUID contactid do Dataverse – associado como a nova atividade de Chamada Telefônica em Relação (criar caminho). |
|
|
activityId
|
activityId | string |
GUID de chamada telefônica do Dataverse (activityid) existente para COMPLETE com o resultado. Omita para criar uma nova atividade de Chamada Telefônica. |
|
|
objetivo
|
purpose | string | ||
|
Saudação
|
greeting | string | ||
|
Adeus
|
goodbye | string | ||
|
perguntas
|
questions | array of string |
Retornos
- Body
- PlaceCallResponse
Listar chamadas
Lista as chamadas recentes, a mais recente primeiro. Use 'since' para sondar atualizações.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Desde
|
since | string |
Carimbo de data/hora ISO-8601; somente chamadas criadas em/depois disso. |
|
|
Status
|
status | string |
Filtrar por status (pendente, in_progress, concluída, com falha, recusada). |
|
|
ReasonId
|
reasonId | string |
ReasonId |
|
|
Limit
|
limit | integer |
Limit |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
chamadas
|
calls | array of Call |
Listar motivos de chamada
Retorna os motivos de chamada configurados (automações) para a organização.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
motivos
|
reasons | array of Reason |
Obter um motivo de chamada
Obtenha um motivo de chamada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
reason
|
reason | Reason |
Obter uma chamada
Receber uma chamada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
chamada
|
call | Call |
Testar conectividade
Definições
Ping
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ok
|
ok | boolean | |
|
orgId
|
orgId | string | |
|
org
|
org | string |
Reason
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string | |
|
nome
|
name | string | |
|
description
|
description | string |
Finalidade em linguagem simples que a IA retransmite para o contato. |
|
status
|
status | string |
ativo | Pausado |
|
dayOfWeek
|
dayOfWeek | integer |
Dia da agenda semanal (1=Seg... 5=Sex). |
|
perguntas
|
questions | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | |
|
smsMessage
|
smsMessage | string | |
|
contactCount
|
contactCount | integer |
PlaceCallResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
callId
|
callId | string | |
|
status
|
status | string |
Call
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
callId
|
callId | string | |
|
reasonId
|
reasonId | string | |
|
status
|
status | string |
pendente | entrando em contato | in_progress | concluído | falha | Recusou |
|
resultado
|
outcome | string |
concluído | no_answer | recusado | in_progress |
|
nome
|
contact.name | string | |
|
phone
|
contact.phone | string | |
|
externalId
|
contact.externalId | string | |
|
resumo
|
summary | string | |
|
issueRaised
|
issueRaised | boolean | |
|
notas
|
notes | string | |
|
durationSec
|
durationSec | integer | |
|
completedAt
|
completedAt | string | |
|
createdAt
|
createdAt | string |