📋 Requisitos Prévios
Antes de gerenciar os acessos e permissões da sua integração, certifique-se de cumprir com os seguintes pontos:
Acesso de Administrador: Você deve contar com privilégios administrativos no console do Genesys Cloud Admin para criar ou modificar as funções do Cliente OAuth.
Conhecimento de permissões: Compreender a diferença entre permissões obrigatórias (para roteamento base) e permissões opcionais (para sincronização avançada de contatos).
Conexão em andamento: Ter iniciado o processo de conexão a partir da plataforma Atom em Configurações > Integrações.
🛡️ Validação Rigorosa de Permissões Obrigatórias
A plataforma Atom conta com mecanismos de validação de alta segurança para garantir que nenhuma conversa se perca por falta de privilégios técnicos na API do Genesys.
Durante o processo de conexão inicial, Atom avalia automaticamente o token de acesso (Token) gerado pelo Genesys.
⚠️ Importante: Regra de negócio crítica. Se seu Cliente OAuth não possuir nem uma (1) permissão obrigatória (ex. architect:flow:view ou routing:message:manage), a conexão será rejeitada. O sistema bloqueará o avanço e exibirá uma tela detalhando exatamente qual permissão falta habilitar, ignorando se você possui ou não as permissões opcionais.
Se você possuir todas as permissões obrigatórias, a conexão será bem-sucedida e você será redirecionado para a configuração de fluxos e Tipificação.
📊 Impacto das Licenças CX em Funcionalidades Opcionais
Dependendo do nível de licença que você contratou no Genesys Cloud (ex. CX1, CX2, CX3), sua integração terá distintos alcances habilitados dentro do Atom.
Nível de Licença | Impacto na Plataforma | Visualização na Interface |
Licença Básica (ex. CX1) | As funcionalidades que requerem sincronização avançada ou edição de dados de contatos externos estarão desabilitadas. | Os módulos bloqueados exibirão um indicador visual de cadeado fechado. |
Licenças Superiores (ex. CX2/CX3) | Permite o uso total de funcionalidades opcionais (ex. | Módulos completamente interativos e sem bloqueios visíveis. |
🔄 Estratégia de Atualização: Atualizar Token
Se em algum momento você realizar um upgrade de sua licença no Genesys ou adicionar permissões faltantes ao seu Cliente OAuth, não é necessário eliminar a integração e começar do zero.
Siga estes passos para sincronizar seus novos privilégios:
Vá para Configurações > Integrações e abra o cartão do Genesys Cloud.
Navegue até a seção de conexão ou para o módulo que se encontra bloqueado.
Clique no botão Atualizar Token.
Complete a tela de autorização do Meta/Genesys que Atom exibirá para absorver as novas permissões.
💡 Dica: Usar "Atualizar Token" é completamente seguro. Atualizará a validação de permissões na API sem apagar, alterar ou perder sua configuração de roteamento, Tipificação ou mapeamento atual.
⚠️ Tratamento de Erros ao Atualizar
Existem cenários onde ao clicar em Atualizar Token, a plataforma pode lançar um erro. Isto ocorre se:
As permissões não foram salvas corretamente no console do Genesys.
A mudança de licença ou atribuição de função ainda não se propagou na API do Genesys.
Solução: Se você vir o modal de alerta de "Permissões insuficientes", dirija-se ao Genesys Cloud Admin, verifique que a função OAuth tenha os escopos corretos salvos, aguarde alguns minutos para que a mudança se propague nos servidores deles e tente novamente no Atom.
✅ Resultados Esperados e Verificação
Para auditar o estado atual de seu licenciamento e verificar que a atualização foi bem-sucedida:
Abra o cartão do Genesys Cloud no Atom e expanda a aba de Conexão.
Verifique o valor no campo Licença. Ali você visualizará o nível de plano detectado pelo Atom em tempo real (ex. CX1 ou CX2).
Navegue para as abas de configuração avançada (como o mapeamento de contatos). Se sua atualização foi bem-sucedida, os cadeados desaparecerão e os menus suspensos estarão prontos para serem configurados.
Manter sua integração do Genesys Cloud atualizada com as permissões corretas garante um fluxo de dados limpo e sem interrupções. Ao entender como suas licenças interagem com as funcionalidades opcionais e utilizar a atualização de token de forma estratégica, você capacita sua equipe para escalar sua operação comercial com total segurança técnica. ✅