📋 Requisitos Prévios

Antes de iniciar a conexão na plataforma Atom, certifique-se de cumprir com os seguintes elementos operativos:

Uma conta ativa de Genesys Cloud CX.
Privilégios de Administrador no Genesys (necessários para criar um Cliente OAuth ou OAuth Client).
Credenciais de acesso geradas a partir do Genesys: Client ID e Client Secret.
Acesso ao módulo de integrações no Atom (Caminho: Configurações > Integrações).

⚙️ Configuração do Cliente OAuth no Genesys

Para que Atom e Genesys possam se comunicar de forma bidirecional, você precisa criar um cliente OAuth no Genesys e conceder um conjunto de permissões específicas.

1. Criação de Credenciais

Acesse seu console de administração do Genesys Cloud e crie um novo cliente OAuth. Ao finalizar, o sistema fornecerá um Client ID e um Client Secret. Mantenha essas chaves à mão, pois você as inserirá posteriormente no cartão de integração dentro do Atom.

2. Permissões Obrigatórias

Essas permissões são de caráter estritamente funcional e são necessárias para rotear o tráfego de conversas e mapear as tipificações corretamente.

⚠️ Importante: Se seu OAuth Client no Genesys não possuir a totalidade dessas permissões, o sistema Atom rejeitará a conexão para proteger a integridade do fluxo de atendimento e será impossível finalizar a integração.

Funcionalidade	Permissão técnica no Genesys
Receber mensagens	`conversation:message:receive`
Visualizar fluxos	`architect:flow:view`
Gerenciar roteamento	`routing:message:manage`
Adicionar integrações	`messaging:integration:add`
Remover integrações	`messaging:integration:delete`
Classificações	`routing:wrapupCode:view`

3. Permissões Opcionais

Essas permissões habilitam funcionalidades estendidas relacionadas à sincronização e gestão de contatos externos.

💡 Dica: Dependendo do seu tipo de licença CX no Genesys, algumas dessas permissões podem não estar disponíveis. Não se preocupe! É completamente viável estabelecer a conexão apenas com as permissões obrigatórias. Você pode atualizar as permissões opcionais mais tarde sem afetar a operação básica.

Funcionalidade	Permissão técnica no Genesys
Visualizar contatos externos	`externalContacts:contact:view`
Adicionar contatos externos	`externalContacts:contact:add`
Editar contatos externos	`externalContacts:contact:edit`
Visualizar campos personalizados	`externalContacts:customFields:view`
Editar campos personalizados	`externalContacts:customFields:edit`

📊 Validação de Estados da Integração

Assim que você tiver suas credenciais e se dirigir para Configurações > Integrações no Atom, você interagirá com o cartão de Genesys Cloud. Conhecer os diferentes estados de conexão ajudará você a verificar que os pré-requisitos foram validados com êxito.

Estado no Atom	Significado Operativo
Conectar	Estado inicial padrão. Indica que a integração está pronta para ser configurada.
Conectando...	Aparece ao inserir suas credenciais. O Atom está validando e carregando as permissões concedidas no Genesys.
Configuração pendente	Suas credenciais e permissões estão corretas! Falta apenas que você configure um fluxo de roteamento e uma tipificação padrão no Atom para iniciar a operação.
Conectado	A integração foi validada, mapeada e está pronta para rotear suas conversas.
Conexão falhada	Ocorre se o usuário abandonar prematuramente a janela de credenciais ou a validação antes de terminar o processo.
Com erro	Estado crítico. Significa que, após uma conexão bem-sucedida, alguma permissão obrigatória foi perdida no Genesys ou existe uma alteração que impede o roteamento de mensagens. Requer revisão imediata do seu OAuth Client.

Preparar seu ambiente e garantir as permissões corretas desde o primeiro momento assegura uma configuração tranquila, segura e livre de bloqueios. Você já tem tudo pronto para unificar o poder de automação do Atom com a eficiência de seus agentes no Genesys Cloud! ✅

🔌 Configuração de Pré-requisitos para Genesys Cloud