Genesys
Integre os Agents da ElevenLabs ao Genesys usando a integração nativa do Audio Connector.
Visão geral
Este guia explica como integrar os Agentes da ElevenLabs ao Genesys Cloud usando a integração Audio Connector. Essa integração oferece recursos de voz IA integrados à sua infraestrutura existente de central de contatos Genesys por WebSocket, sem exigir entroncamento SIP.
Como funciona a integração com o Genesys
A integração com o Genesys usa uma conexão WebSocket nativa por meio da integração Audio Connector:
- Conexão WebSocket: Conexão direta com a ElevenLabs usando a integração Audio Connector no Genesys Cloud
- Áudio em tempo real: Transmissão de áudio bidirecional entre o Genesys e os agentes da ElevenLabs
- Integração de fluxos: Integração simplificada aos seus fluxos do Genesys Architect usando ações de bot
- Variáveis dinâmicas: Suporte para transmitir contexto e dados entre o Genesys e a ElevenLabs
Requisitos
Antes de configurar a integração com o Genesys, verifique se você tem:
- Licença do Genesys Cloud CX com recursos de fluxo de bot
- Acesso de administrador à organização do Genesys Cloud
- Uma conta da ElevenLabs e um agente da ElevenLabs configurados
- Chave de API da ElevenLabs
Configurando a integração Audio Connector
Acessar o Admin do Genesys Cloud
Entre na sua organização do Genesys Cloud com privilégios de administrador.
Criar integração Audio Connector
-
Clique em “Add Integration”, procure por “Audio Connector” e clique em “Install”
-
Selecione o tipo de integração Audio Connector
-
Dê um nome descritivo à sua integração
Configurar autenticação
-
Acesse a seção Configuration da sua integração Audio Connector
-
Em Properties, no campo Base Connection URI, insira o URL apropriado para seu ambiente:
Se sua conta da ElevenLabs estiver em um ambiente isolado de residência, substitua
<region>pelo código da sua região. Usar o URL errado resultará em falhas de autenticação. Consulte residência de dados para ver a lista de regiões disponíveis e seus URLs. -
Em Credentials, insira a chave de API da ElevenLabs na configuração de autenticação
-
Salve a configuração da integração
Configurando seu fluxo do Genesys
Criar ou editar um fluxo
Abra um fluxo de chamadas recebidas, realizadas ou em fila existente, ou crie um novo no qual você queira usar o agente da ElevenLabs.
Adicionar ação de bot
-
No seu fluxo, adicione uma ação “Call Audio Connector” da categoria Bot
-
Selecione sua integração Audio Connector no menu suspenso de integração
-
No campo Connector ID, informe o ID do seu agente da ElevenLabs
Requisitos de configuração do agente
Seu agente do ElevenLabs Agents precisa ser configurado com ajustes específicos de áudio para ser compatível com o Genesys:
Requisitos de formato de áudio
- Formato de saída de TTS: Defina como μ-law 8000 Hz em Agent Settings → Voice
- Formato de áudio de entrada do usuário: Defina como μ-law 8000 Hz em Agent Settings → Advanced
Eventos de cliente compatíveis
A integração com o Genesys é compatível apenas com os seguintes eventos de cliente:
- Eventos de áudio: Para processar a entrada de voz de quem liga
- Eventos de interrupção: Para lidar com interrupções de quem liga durante a fala do agente
Outros tipos de eventos de cliente não são compatíveis com a integração do Genesys e serão ignorados silenciosamente se forem configurados.
Variáveis de sessão
Você pode transmitir contexto dinâmico do seu fluxo do Genesys ao seu agente da ElevenLabs usando variáveis de sessão de entrada e receber dados de volta por variáveis de sessão de saída. As variáveis de sessão também podem ser usadas para substituir configurações específicas do agente diretamente do seu fluxo do Genesys.
Variáveis de sessão de entrada
- No fluxo do Genesys: Defina variáveis de sessão de entrada na sua ação “Call Audio Connector”
- No agente da ElevenLabs: As variáveis ficam disponíveis como variáveis dinâmicas e/ou substituem configurações
- Uso: Faça referência a essas variáveis no fluxo de conversa ou nos prompts de sistema do seu agente
Saiba mais sobre variáveis dinâmicas.
Substituições de configuração
As seguintes variáveis de sessão podem modificar a configuração do agente em tempo de execução:
system__override_system_prompt: Substitui o prompt de sistema do agente.system__override_first_message: Substitui a primeira mensagem do agente para o usuário.system__override_language: Define o idioma do agente para esta sessão.system__override_voice_id: Define o ID de voz do agente para esta sessão.
Exemplo de uso
Variáveis de sessão de entrada do fluxo do Genesys:
customer_name = "John Smith"system__override_first_message = "Hello! Welcome to our support line."system__override_language = "en"
Prompt do agente da ElevenLabs: Olá, {{customer_name}}, como posso ajudar você hoje?
Variáveis de sessão de saída
Agora você pode receber dados do seu agente da ElevenLabs no seu fluxo do Genesys usando variáveis de sessão de saída.
Todos os dados coletados por meio da Coleta de dados no seu agente da ElevenLabs estarão disponíveis como variáveis de sessão de saída no seu fluxo do Genesys após o término da conversa.
Exemplo de uso
Depois que a conversa com seu agente da ElevenLabs for concluída, você poderá usar as variáveis de saída no seu fluxo do Genesys:
- Lógica de decisão: Use variáveis de saída em nós de decisão para direcionar chamadas
- Processamento de dados: Transmita dados da conversa para sistemas externos
- Relatórios: Inclua os resultados das conversas nas análises da sua central de contatos
Funcionalidade de transferência para número
A integração da ElevenLabs agora permite transferir chamadas de volta para o Genesys, a fim de direcioná-las a números ou filas específicos.
Configurando transferências
Configurar um item de coleta de dados
No seu agente da ElevenLabs, adicione um item de coleta de dados com um identificador e uma descrição detalhados para coletar para onde o usuário deve ser transferido.
Atualizar o prompt do agente
Adicione instruções ao prompt de sistema do seu agente para usar a ferramenta end_call quando uma transferência for solicitada. Por exemplo:
Configurar a lógica do fluxo do Genesys
No seu fluxo do Genesys Architect, adicione nós de decisão após a ação Audio Connector para verificar as variáveis de saída e direcionar a chamada adequadamente:
- Use variáveis de sessão de saída para determinar se uma transferência foi solicitada
- Configure a lógica de roteamento com base no tipo ou destino da transferência
- Use os recursos nativos de transferência do Genesys para concluir a transferência
Exemplo de fluxo de transferência
- Solicitação do cliente: “Preciso falar com o departamento financeiro”
- Resposta do agente: “Vou transferir você para nosso departamento financeiro”
- Ação do agente: Usa a ferramenta end_call
- Coleta de dados: O campo de coleta de dados é preenchido
- Fluxo do Genesys: Verifica a variável de saída e direciona para a fila do departamento financeiro
Limitações e recursos não compatíveis
As seguintes ferramentas e recursos não são compatíveis com a integração do Genesys:
Ferramentas não compatíveis
- Ferramenta de cliente: Não é compatível com a integração WebSocket do Genesys
Solução de problemas
Falha na conexão WebSocket
Verifique se sua chave de API está configurada corretamente na integração Audio Connector e se o ID do agente da ElevenLabs está configurado corretamente no campo Connector ID do seu fluxo do Architect. Se houver variáveis dinâmicas definidas no seu agente, elas precisam ser transmitidas como variáveis de sessão de entrada.
Variáveis de sessão não funcionam
Verifique se as variáveis de sessão de entrada estão definidas corretamente na ação “Call Audio Connector” do seu fluxo do Genesys e se são referenciadas corretamente no seu agente da ElevenLabs usando a sintaxe {{variable_name}}.