> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/human-offloading-live-chat/genesys-purecloud.md).
# Genesys Cloud
Aprenda como configurar seu chatbot Chatlayer com o Genesys Cloud (anteriormente Genesys PureCloud) para handover humano
{% hint style="danger" %}
Esta integração foi marcada como obsoleta pela Genesys. Se você estiver procurando uma integração alternativa com este provedor, entre em contato com [o suporte](https://docs.chatlayer.ai/support/get-in-touch) e forneceremos mais informações.
{% endhint %}
Na plataforma Genesys Cloud, acesse Admin > Integrações > OAuth
Adicione um novo cliente OAuth para o Chatlayer.ai usar
Escolha um nome e uma descrição para o app. Deixe a duração do token inalterada e selecione o tipo de concessão Client Credentials.
Na aba de funções, atribua todas as funções
Copie o ID do cliente recém-criado e o segredo do cliente para sua integração de Offloading do Genesys Cloud no Chatlayer
### Crie a implantação do widget
Crie um novo Widget acessando **Admin > Contact Center > Widgets > Criar Widget**
Copie a chave de implantação para a tela de configuração de offloading no Chatlayer.
## Enviando um usuário para o Genesys Cloud
Para transferir seu usuário para um agente ao vivo no Genesys Cloud, crie uma ação no ponto do fluxo em que você deseja que o usuário seja encaminhado.
Adicione a ação "Enviar para provedor de offloading" ao seu bloco e configure-a com as definições corretas para o Genesys Cloud.
Selecione a fila para a qual as conversas do seu chatbot serão encaminhadas.
Assim que um usuário chegar a esta parte da conversa, o offloading para o Genesys Cloud será acionado. O bot será pausado automaticamente quando um usuário chegar a esta ação. Quando o agente encerrar a conversa, o bot será retomado.
### Informações do usuário e campos personalizados
Quando a conversa chegar a um bloco de transferência para humano para o Genesys Cloud, o Chatlayer preencherá as seguintes informações sobre o seu usuário usando variáveis, se estiverem disponíveis na sessão de chat:
**Nome**: `genesysCloud.firstName` OU `internal.user.firstName`\
**Sobrenome**: `genesysCloud.lastName` OU `internal.user.lastName`\
**Telefone** **Número**: `genesysCloud.phoneNumber`\
**E-mail**: `genesysCloud.email`
Talvez você queira passar informações adicionais sobre o usuário para a Genesys, não cobertas pelos campos acima. Para lidar com isso, você pode declarar variáveis adicionais de sessão no `genesysCloud.customFields` namespace. Elas serão adicionadas como campos personalizados no Genesys Cloud.
Por exemplo, para adicionar a localização do usuário como um campo personalizado, você ajustaria o fluxo do seu bot para perguntar a localização do usuário e armazenaria a resposta como uma variável em `genesysCloud.customFields.location`
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/human-offloading-live-chat/genesys-purecloud.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
