VoxAide (Pré-visualização)

Faça chamadas de voz com IA para contactos por uma razão configurada e leia o resultado de cada chamada. Emparelha-se com a solução gerida VoxAide for Dynamics 365. Autenticar com uma chave API VoxAide (Definições → Integrações → Dynamics 365).

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regions
Estúdio Copiloto Premium Todas as regiões Power Automate exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões Power Apps exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões Power Automate exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contact
Nome Suporte VoxAide
URL https://voxaide.co
Email support@voxaide.co
Metadados do conector
Editor Sovereign IT Solutions Limited
Sítio Web https://voxaide.co
Política de privacidade https://voxaide.co/privacy
Categorias Comunicação; Vendas e CRM

VoxAide

A VoxAide faz chamadas de voz por IA aos seus contactos por uma razão que escolhe, faz as perguntas que definiu e devolve o resultado de cada chamada — um resumo, se foi levantada uma questão, a duração e o estado. Use-o para construir fluxos de Power Automate que chamem as pessoas automaticamente (check-ins, confirmações, lembretes, verificações de referências) e escreva o resultado nos seus sistemas.

Editor

VoxAide (Sovereign IT Solutions Ltd)

Pré-requisitos

  • Uma conta VoxAide (inscreva-se em https://voxaide.co). As chamadas utilizam o seu plano VoxAide ou saldo pay-as-you-go.
  • A capacidade de chamadas está ativada na sua organização VoxAid.
  • Um plano Power Automate, Power Apps ou Logic Apps que suporta conectores premium/personalizados.

Como obter credenciais

O VoxAide autentica com uma chave API.

  1. Inicie sessão no VoxAide em https://voxaide.co.
  2. Vai a Definições → Integrações.
  3. Na secção do conector, escolha Gerar chave e copie a chave (começa por vox_live_). É mostrado uma vez.
  4. No Power Automate, ao criar a ligação VoxAide, cole a chave no campo da API Key.

Pode revogar uma chave a qualquer momento a partir do mesmo ecrã.

Operações suportadas

Operation Descrição
Fazer uma chamada Faça agora uma chamada de voz por IA a um contacto por um determinado motivo.
Chamadas de lista Lista chamadas recentes, as mais recentes primeiro; Consulta para since atualizações.
Recebe uma chamada Recebe uma única chamada e o seu desfecho depois de concluído.
Razões das chamadas de lista Liste as razões das chamadas configuradas para a sua organização.
Crie uma razão de chamada Crie uma nova razão com um nome e as perguntas a fazer.
Motivo da chamada Obtém uma única razão pelo seu identificador.
Atualizar a razão da chamada Atualize o nome do motivo, o horário ou as perguntas.
Teste de conexão Verifique a chave API (usada pelo teste de ligação).

Um fluxo típico: Faça uma chamada com um motivo e o número de telefone de um contacto → inquélta. Receba uma chamada (ou Liste chamadas) até status →failed/declinedcompleted/usar o retorno summarye outcomeissueRaised no seu fluxo.

Instruções de implantação

Os ficheiros conectores são apiDefinition.swagger.json, apiProperties.json e icon.png. Para criar o conector no seu próprio ambiente com a CLI dos Power Platform Connectors:

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

Problemas e limitações conhecidos

  • Os números de telefone devem estar no formato E.164 (por exemplo +14155550123).
  • Fazer uma chamada consome o subsídio do plano ou crédito pay-as-you-go; Uma chamada é faturada quando é realizada, não quando termina.
  • As chamadas são feitas de forma assíncrona: Coloque uma chamada retorna imediatamente com um callId e um pending estado. Inquérito Receba uma chamada para o resultado final.
  • O activityId campo destina-se à escrita avançada de uma atividade CRM existente (por exemplo, uma atividade chamada telefónica Dynamics 365) e pode ser ignorado na maioria dos fluxos.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:
Predefinição 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.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Descrição Obrigatório
Chave de API securestring A chave de API para esta api Verdade

Ações

Atualizar a razão da chamada

Atualize a razão da chamada.
Crie uma razão de chamada

Crie uma razão para chamada.
Fazer uma chamada

Faz agora uma chamada de voz por IA para um contacto pelo motivo dado. Passe o contactid do Dataverse como contact.externalId para que o resultado seja escrito como uma nova atividade de Chamada Telefónica na linha temporal desse Contacto. Para COMPLETAR uma atividade de Chamada Telefónica existente (modo de distribuição de campanha), passe o seu activityId. Use content.* para conduzir o script de chamada para dentro (orientado pela campanha), sobrepondo-se ao conteúdo armazenado pelo motivo.
Listar chamadas

Lista chamadas recentes, as mais recentes primeiro. Usa 'desde' para consultar atualizações.
Motivo da chamada

Obtém uma razão de chamada.
Razões das chamadas de lista

Devolve as razões de chamada configuradas (automações) para a organização.
Recebe uma chamada

Recebe uma chamada.
Testar ligação

Verifica a chave API e devolve a organização para a qual corresponde.

Atualizar a razão da chamada

ID da Operação:
UpdateReason

Atualize a razão da chamada.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Id
 id True string

Id
Nome
 name True string
description
 description string
dayOfWeek
 dayOfWeek integer
perguntas
 questions True array of string
smsOnNãoResposta
 smsOnNoAnswer boolean
smsMessage
 smsMessage string
estado
 status string

ativo | pausado

Crie uma razão de chamada

ID da Operação:
CreateReason

Crie uma razão para chamada.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Nome
 name True string
description
 description string
dayOfWeek
 dayOfWeek integer
perguntas
 questions True array of string
smsOnNãoResposta
 smsOnNoAnswer boolean
smsMessage
 smsMessage string
estado
 status string

ativo | pausado

Devoluções

Name Caminho Tipo Descrição
id
 id string

Fazer uma chamada

ID da Operação:
PlaceCall

Faz agora uma chamada de voz por IA para um contacto pelo motivo dado. Passe o contactid do Dataverse como contact.externalId para que o resultado seja escrito como uma nova atividade de Chamada Telefónica na linha temporal desse Contacto. Para COMPLETAR uma atividade de Chamada Telefónica existente (modo de distribuição de campanha), passe o seu activityId. Use content.* para conduzir o script de chamada para dentro (orientado pela campanha), sobrepondo-se ao conteúdo armazenado pelo motivo.

Parâmetros

Name Chave Obrigatório Tipo Descrição
reasonId
 reasonId True string
Nome
 name string
phone
 phone True string

Número de telefone E.164.
e-mail
 email string
externalId
 externalId string

Dataverse contactid GUID — atribuído como a nova atividade de Chamadas Telefónicas Sobre (criar caminho).
activityId
 activityId string

Dataverse existente para chamada telefónica (activityid) GUID para COMPLETE com o resultado. Omitir criar uma nova atividade de Chamada Telefónica.
purpose
 purpose string
Saudação
 greeting string
Adeus
 goodbye string
perguntas
 questions array of string

Devoluções

Corpo
PlaceCallResponse

Listar chamadas

ID da Operação:
ListCalls

Lista chamadas recentes, as mais recentes primeiro. Usa 'desde' para consultar atualizações.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Desde
 since string

carimbo temporal ISO-8601; Só as chamadas criadas até/depois disto.
Status
 status string

Filtrar por estado (pendente, in_progress, concluído, falhado, recusado).
RazãoId
 reasonId string

RazãoId
Limite
 limit integer

Limite

Devoluções

Name Caminho Tipo Descrição
Chamadas
 calls array of Call

Motivo da chamada

ID da Operação:
GetReason

Obtém uma razão de chamada.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Id
 id True string

Id

Devoluções

Name Caminho Tipo Descrição
reason
 reason Reason

Razões das chamadas de lista

ID da Operação:
ListReasons

Devolve as razões de chamada configuradas (automações) para a organização.

Devoluções

Name Caminho Tipo Descrição
Razões
 reasons array of Reason

Recebe uma chamada

ID da Operação:
GetCall

Recebe uma chamada.

Parâmetros

Name Chave Obrigatório Tipo Descrição
Id
 id True string

Id

Devoluções

Name Caminho Tipo Descrição
chamada
 call Call

Testar ligação

ID da Operação:
TestConnection

Verifica a chave API e devolve a organização para a qual corresponde.

Devoluções

Corpo
Ping

Definições

Ping

Name Caminho Tipo Descrição
Ok
 ok boolean
orgId
 orgId string
organização
 org string

Justificação

Name Caminho Tipo Descrição
id
 id string
Nome
 name string
description
 description string

Propósito em linguagem simples que a IA transmite ao contacto.
estado
 status string

ativo | pausado
dayOfWeek
 dayOfWeek integer

Dia semanal de calendário (1=Seg ... 5=Sex).
perguntas
 questions array of string
smsOnNãoResposta
 smsOnNoAnswer boolean
smsMessage
 smsMessage string
ContactCount
 contactCount integer

PlaceCallResponse

Name Caminho Tipo Descrição
callId
 callId string
estado
 status string

Call

Name Caminho Tipo Descrição
callId
 callId string
reasonId
 reasonId string
estado
 status string

pendente | contacto | in_progress | concluído | falhou | Recuso
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
Questão levantada
 issueRaised boolean
Observações
 notes string
duraçãoSec
 durationSec integer
concluídoAt
 completedAt string
createdAt
 createdAt string