> For the complete documentation index, see [llms.txt](https://docs.skyone.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skyone.cloud/skyone-studio/inteligencia-artificial/agentes/canais-de-publicacao-de-agentes-de-ia/como-configurar-o-chat-privado-no-skyone-studio.md).

# Como configurar o Chat Privado no Skyone Studio?

O **Chat Privado** é uma ferramenta de automação conversacional inspirada em chatbots, concebida para executar fluxos de trabalho de agentes em um ambiente totalmente independente do **Skyone Studio**, com usuários próprios e URLs exclusivas. 

Ele foi criado para atender a demandas específicas onde o acesso ao **Skyone Studio** não é possível, permitindo que usuários testem e interajam com fluxos de agente de forma rápida e prática.

* **Usuários novos**: podem acessar o **Chat Privado** assim que o fluxo for publicado.
* **Usuários antigos**: precisam que um administrador publique o fluxo e compartilhe a URL ou QR Code.

### Benefícios

* Utiliza os mesmos elementos básicos da construção de um agente de IA: fluxos de agente (workflows), componentes interativos (mensagens, botões, etc.) e agentes AI.
* Flexibilidade de uso, permitindo acesso por URL gerada, semelhante a um chatbot tradicional.
* Integrações com **Slack** e **WhatsApp**, além do acesso independente via navegador ou QR Code.
* Ideal para testes de fluxo quando o **Skyone Studio** não está acessível.
* Facilita validação rápida de interações antes da publicação definitiva.
* Suporte para demonstrações com stakeholders ou equipes externas.

### Etapas de configuração

A publicação de um fluxo no **Chat Privado** é feita em etapas simples, que envolvem a criação do fluxo, configuração do agente e definição dos usuários que terão acesso.\
Cada passo garante que o chat esteja funcional, seguro e pronto para uso.

#### Passos:

[\[ Passo 01 \] Como publicar um fluxo no Chat Privado](#como-publicar-um-fluxo-no-chat-privado): Publicar um fluxo no Chat Privado disponibiliza o agente para testes e acesso via URL ou QR Code.

***

### Como publicar um fluxo no Chat Privado

Siga o passo a passo abaixo para realizar a publicação de um fluxo de agente:

1. [Crie o fluxo de agente](/skyone-studio/integracoes/fluxos/gestao-dos-fluxos/criar-fluxo.md). 

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FyAThE0CmXbZwjxYON1sh%2FpFvzWwbr4h.png?alt=media&amp;token=7fdee754-b7ed-4ce5-af20-ce0085da1555" alt=""><figcaption></figcaption></figure>

2. [Crie uma Skill](/skyone-studio/inteligencia-artificial/skills.md#criar-uma-nova-skill) (Opcional)
3. [Crie um agente e associe a Skill](/skyone-studio/inteligencia-artificial/agentes.md#criar-um-agente). (Opcional)
4. Associe um modelo ao agente.
5. Clique em “**Publicar**”.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FNzevrbGsCD8CvOFEr3RB%2FuKSm8u0Wbk.png?alt=media&amp;token=a34213ff-73fc-4834-9fcd-c587f74b7d8e" alt=""><figcaption></figcaption></figure>

6. Selecione a opção Chat Privado.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2F6BuI2xmNzlOSs7dOecjT%2Fchrome_cfBKsNBFEq.gif?alt=media&amp;token=54c746ad-99d4-49a1-87e7-2db3a9d36ff5" alt=""><figcaption></figcaption></figure>

7. Escolha o fluxo de agente desejado.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FvcXMmlxmmxY6ytr2bJKZ%2FZlmii1DvPp.png?alt=media&amp;token=06d16ae6-6f8b-483c-a9f7-e6c2df0e2be4" alt=""><figcaption></figcaption></figure>

8. Selecione a conta onde será publicada.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2Fxr7Q20n7upSHGEfc4583%2FzuOXxw4bFp.png?alt=media&amp;token=ed7d2613-0d47-40cd-a30d-157d2c903f43" alt=""><figcaption></figcaption></figure>

9. Gerencie os usuários e grupos que terão permissão de acesso.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FIS8r0Q62dATXiKXtXtuJ%2Fchrome_YFtrVcPAQE.png?alt=media&amp;token=38820463-be87-429a-a787-5830e76dca7b" alt=""><figcaption></figcaption></figure>

10. Clique em "**Salvar**".

**Após salvar**:

* Um QR Code e uma URL serão gerados.
* Você poderá acessar o chat diretamente pelo navegador ou pelo celular.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2F6OYnQg2iLcyyreYN01g9%2F8A87F525-BA30-4DCE-AC7A-8AD66DE32CED.png?alt=media&amp;token=8addba4e-ea46-4350-bb67-116b1698fe92" alt=""><figcaption></figcaption></figure>

A interface exibirá todas as suas publicações com seus respectivos fluxos de agente.

### **Testar**

Na aba **Testar**, você pode acessar a publicação de duas formas:

* **QR Code:** escaneie o código com o celular para acessar e testar a publicação.
* **Link:** copie o endereço exibido no campo de link. Utilize o ícone de cópia para copiá-lo ou o ícone de link externo para abri-lo em uma nova aba.

Ao abrir o link, você será direcionado diretamente para o chat selecionado, sem precisar escolhê-lo novamente.

#### **Embeddable**

A aba **Embeddable** é exibida quando a opção **Habilitar embedding** está ativa na conta da publicação. Nela, você encontra os códigos para inserir o chat em seu site:

* **Toolkit:** exibe um ícone flutuante no canto da tela do site que, ao ser clicado, abre o chat.
* **IFrame:** incorpora a interface do chat em uma área específica do site, com tamanho ajustável ao layout da página.

Para copiar o código, clique no ícone de cópia no canto superior direito de cada bloco e cole-o no HTML do seu site.

#### **Recursos disponíveis no chat**

Além das funcionalidades de interação, os chats públicos e privados oferecem os seguintes recursos:

* **Exportar tabela:** se a resposta contiver uma tabela, passe o mouse sobre ela e clique em **Baixar como Excel** para fazer o download em formato Excel.
* **Copiar código:** ao copiar um código gerado pelo Agente, a indentação original é mantida, permitindo colá-lo diretamente em um editor de código.
* **Copiar por linha:** quando a resposta estiver organizada em linhas separadas, é possível copiar cada linha individualmente pelo ícone de cópia ao final dela, ou copiar todo o conteúdo pelo botão de cópia geral.

***

### FAQ

<details>

<summary>Posso usar o Chat Privado sem ter acesso ao Skyone Studio?</summary>

Sim, desde que alguém com permissões publique o fluxo e compartilhe a URL ou QR Code.

</details>

<details>

<summary>É preciso criar uma Skill para usar o Chat Privado?</summary>

Não, a criação de Skill é opcional.

</details>

<details>

<summary>Posso controlar quem acessa o Chat Privado?</summary>

Sim, é possível definir usuários e grupos autorizados durante a publicação.

</details>

***

### Vídeo Demonstrativo

Para facilitar a compreensão, assista ao vídeo abaixo com a demonstração prática de todas as etapas apresentadas nesta documentação. O vídeo mostra cada tela, clique e configuração necessária para concluir a integração do Chat privado no Skyone Studio.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FnkmapQ0TkFfmfgNh70Ey%2Fchat%20privado.mp4?alt=media&token=91edc9fa-2183-4901-87bf-f6b66dbfd2ca>" %}


---

# 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.skyone.cloud/skyone-studio/inteligencia-artificial/agentes/canais-de-publicacao-de-agentes-de-ia/como-configurar-o-chat-privado-no-skyone-studio.md?ask=<question>&goal=<user_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.