VoxOne no Módulo de Integrações do Studio

Introdução

O VoxOne agora possui integração completa ao módulo de Integrações, permitindo que suas chamadas sejam acionadas automaticamente dentro de fluxos, rotinas e automações.

Essa melhoria amplia as possibilidades de uso do VoxOne, permitindo que ele se torne parte ativa do fluxo de negócios.

---

Para que serve essa nova funcionalidade

A integração do VoxOne ao fluxo permite:

• Acionar uma ligação automática dentro de uma automação.

• Registrar e acompanhar o status da ligação diretamente no histórico do agente.

• Passar contextos e dados ao agente antes da ligação, personalizando o atendimento.

• Conectar chamadas do VoxOne ao fluxo completo do Studio, criando automações completas e inteligentes.

---

Vídeo Demonstrativo

Para facilitar o entendimento da configuração do VoxOne no módulo de Integrações, disponibilizamos um vídeo que mostra todo o processo de forma prática, desde a localização da ferramenta VoxOneCall até o teste da chamada e visualização do histórico. Assista ao vídeo antes de iniciar a configuração para garantir que cada etapa seja seguida corretamente.

---

Como navegar até a nova funcionalidade

1. Acesse o Skyone Studio.

2. Vá até o menu Integrações.

3. Crie uma nova integração ou abra uma existente.

4. Adicione um gatilho (ex.: Webhook).

1. No gatilho, selecione "Ferramenta".

2. Dentro das ferramentas, escolha "VoxOneCall".

Essa é a nova opção que permite executar uma chamada de voz diretamente pelo fluxo.

1. Selecione um agente do VoxOne

No campo "Agente", escolha um agente que já tenha sido criado anteriormente.

1. Informe o número de telefone para realizar a ligação

Digite o número de celular contendo:

• Código do país

• Discagem direta à distância (DDD)

• Número

Exemplo: [phone]

1. Configure o contexto Inicial (Opcional)

O Contexto Inicial permite orientar o agente antes da chamada, definindo qual comportamento, instrução ou informação ele deve considerar logo no início da interação.

Você pode definir um contexto de sistema (instruções técnicas e regras gerais) ou um contexto de usuário (o que o "usuário" está dizendo antes da ligação acontecer).

• Flag ativada A tela exibirá os campos:

  • Regra → Define qual é o tipo de contexto (ex.: sistema, usuário).

  • Mensagem → Texto que será enviado ao agente antes da ligação.

  Você pode adicionar quantos blocos de contexto desejar utilizando o botão “+”.

  Exemplo:

  • Regra: Sistema

  • Mensagem: “Você deve ajudar o cliente a entender os planos disponíveis.”

• Flag desativada

É necessário enviar manualmente a estrutura de mensagens iniciais no formato JSON:

"initialMessages": [
  {
    "role": "MESSAGE_ROLE_USER",
    "text": "coloque um texto"
  }
]

Esse formato permite que a integração envie mensagens já estruturadas para o agente antes da ligação iniciar.

1. Teste a ligação Após configurar:

   1. Clique em "Próximo"

   2. Clique em "Testar"

O telefone informado irá tocar. Ao atender, o agente VoxOne iniciará a interação automaticamente.

1. Acompanhe o histórico

   1. No menu do VoxOne, clique no seu Agente.

   2. Abra a aba Histórico.

Lá você verá:

• Status

• Origem

• Última atualização

• Horário de início e fim

• Duração

Termos importantes dessa nova funcionalidade

Termo	Descrição
Vox One Call	A nova ferramenta dentro dos fluxos que permite executar ligações via VoxOne.
Gatilho	Evento que inicia o fluxo (ex.: webhook).
Contexto	Informações adicionais enviadas ao agente antes da ligação.
Histórico do Agente	Área onde ficam registradas todas as ligações realizadas via fluxo.

FAQ — Nova integração VoxOne

É possível programar chamadas automáticas para listas de números?

Sim, desde que a lógica da integração envie os números ao fluxo (via webhook, API ou tabela).

Consigo ver no histórico qual fluxo originou a ligação?

Sim. O histórico exibe a origem (ex.: “Teste Fluxo”).

Posso chamar o VoxOne várias vezes no mesmo fluxo?

Sim, o fluxo pode possuir várias etapas envolvendo chamadas.