📋 Requisitos Prévios
Antes de iniciar a vinculação na plataforma, garanta o cumprimento estrito das seguintes condições no seu ambiente de trabalho:
Cliente OAuth (OAuth Client): Ter criado com êxito este cliente no console de administração do Genesys Cloud CX.
Credenciais prontas: Dispor das chaves de acesso geradas para a aplicação: Client ID e Client Secret.
Permissões concedidas: Garantir que a função OAuth no Genesys possui a totalidade das permissões obrigatórias habilitadas (ex. recebimento de mensagens, visualização de fluxos e classificações).
⚠️ Importante: Se o Cliente OAuth não possuir 100% das permissões obrigatórias requeridas pelo Atom, o sistema rejeitará a conexão automaticamente. Esta é uma medida de segurança para proteger a integridade operacional e evitar falhas de roteamento em produção.
⚙️ Guia Passo a Passo
Siga estes passos para estabelecer a conexão técnica com êxito:
Dirija-se a Configurações > Integrações no menu lateral do seu ambiente Atom.
Localize o cartão correspondente ao Genesys Cloud dentro do catálogo de integrações disponíveis.
Clique no botão Conectar. Esta ação inicializará a janela de configuração de credenciais.
Insira seu Client ID e seu Client Secret nos campos solicitados.
Clique no botão de confirmação. Neste momento, o sistema se comunicará com os servidores Genesys para validar as chaves de acesso.
Revise a tela de autorização exibida, que listará os escopos que o Atom solicitará ao Genesys:
Permissões obrigatórias: Estritamente necessárias para rotear tráfego e mapear classificações de encerramento.
Permissões opcionais: Funcionalidades estendidas (sujeitas ao seu tipo de licença CX) para a gestão de contatos externos.
Clique em Continuar para autorizar o vínculo, transferir o token de segurança e finalizar a vinculação técnica.
💡 Dica: Ao copiar e colar seu Client ID e Client Secret, verifique minuciosamente não incluir espaços em branco adicionais no início ou no final das credenciais, pois isso gerará um erro de validação.
📊 Estados da Integração e Resultados
Para auditar o estado de saúde e progresso da sua integração, monitore os indicadores visuais que o cartão do Genesys Cloud apresenta no Atom.
Estado no Cartão | Significado Operacional |
Conectar | Estado inicial: A integração está inativa e pronta para começar o processo de vinculação. |
Conectando... | Transição: O Atom está validando os tokens e processando as permissões contra a API do Genesys. |
Configuração pendente | Êxito técnico parcial: As credenciais e permissões estão corretas, mas é obrigatório configurar o roteamento inicial e a tipificação padrão para poder operar. |
Conectado | Êxito total: As credenciais são válidas e os mapeamentos operacionais estão prontos. Integração 100% ativa. |
Conexão falha | Interrupção: Você abandonou o processo de permissões ou seu OAuth carece de permissões obrigatórias. Você deve corrigi-lo no Genesys e clicar em Tentar novamente. |
Com erro | Estado crítico: Após uma conexão bem-sucedida, uma permissão foi revogada no Genesys, o secret expirou ou um fluxo mapeado foi alterado. Requer auditoria técnica imediata. |
Conectar suas plataformas é o passo mais importante para escalar sua estratégia de atendimento. Ao garantir uma autenticação correta e monitorar o estado de sua integração, você assegura que seus agentes recebam as conversas sem interrupções e com todo o contexto necessário para fornecer um serviço excepcional. ✅