> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatmode.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Ambientes

Ambientes no Chatmode definem onde e como seus agentes de IA interagem com os usuários. Eles servem como a conexão entre seus agentes e diversas plataformas ou canais, principalmente através de chats web incorporáveis (`EMBED`) ou integrações específicas como `ZAPI`.

## Entendendo Ambientes

Um ambiente representa uma implantação específica de um agente. Por exemplo, você pode ter:

* Um agente de suporte ao cliente em seu site
* O mesmo agente implantado via API para seu aplicativo móvel
* Outra instância do agente para uso interno por sua equipe

Cada um deles seria um ambiente separado no Chatmode, potencialmente com configurações diferentes adaptadas a cada caso de uso.

## Tipos de Ambientes

Atualmente, o Chatmode suporta os seguintes tipos de ambientes definidos no sistema:

### Incorporado (`EMBED`)

Incorpore uma interface de chat diretamente em seu site usando um `<iframe>`, permitindo que os visitantes interajam com seu agente.

### `ZAPI`

Conecte seu agente através de integrações específicas configuradas sob este tipo (por exemplo, potencialmente WhatsApp via Z-API). A configuração detalhada depende da integração específica.

## Criando um Ambiente

Para criar um novo ambiente:

1. Navegue até a seção **Ambientes** na barra lateral
2. Clique no botão **Criar Ambiente**
3. Selecione o tipo de ambiente
4. Escolha o agente a ser implantado neste ambiente
5. Configure as definições do ambiente (varia por tipo)
6. Salve sua configuração

## Definições do Ambiente

### Definições Gerais

Todos os ambientes incluem estas configurações comuns:

* **Nome**: Identifique seu ambiente
* **Agente**: O agente de IA que alimentará este ambiente
* **Status Ativo**: Alterne para ativar/desativar o ambiente
* **Idioma Preferencial**: Defina o idioma padrão para interações

### Definições do Embed (`EMBED`)

Ao criar um ambiente Incorporado (`EMBED`), você pode personalizar aspectos da interface de chat apresentada:

* **Nome de Exibição**: O texto mostrado no cabeçalho do chat.
* **Imagem de Exibição**: O logotipo ou avatar mostrado no cabeçalho do chat.
* **Ícone**: O ícone exibido na bolha de chat flutuante quando fechada.
* **Cor Primária**: Afeta botões e outros detalhes na interface do chat.
* **Mensagem Inicial**: A primeira mensagem que o Agente envia quando o chat carrega.

### Definições do Ambiente `ZAPI`

A configuração para ambientes `ZAPI` depende da integração específica que está sendo configurada. Isso geralmente envolve chaves de API, URLs de endpoint ou outras credenciais exigidas pelo serviço de terceiros.

## Implementando Ambientes

### Implementação Incorporada (`EMBED`)

Após criar um ambiente Incorporado, você precisa adicionar um elemento `<iframe>` ao HTML do seu site. O atributo `src` deve apontar para a página de chat pública do seu ID de ambiente.

```html theme={"system"}
<!-- Exemplo de Incorporação com Iframe -->
<iframe
  src="https://<seu-dominio-chatmode>/pt-br/chats/SEU_ID_DE_AMBIENTE"
  width="400"
  height="600"
  style="border: none; /* Adicione outros estilos conforme necessário */"
  title="Assistente Chatmode"
></iframe>

<!--
  Substitua <seu-dominio-chatmode> pelo domínio real onde sua instância Chatmode está hospedada.
  Substitua SEU_ID_DE_AMBIENTE pelo ID do seu ambiente Incorporado criado.
  Ajuste largura, altura e estilos conforme necessário.
-->
```

Coloque esta tag `<iframe>` onde você deseja que a interface de chat apareça em sua página.

*(Nota: A implementação principal recomendada para o chat flutuante usa um snippet de script fornecido na interface do usuário, conforme detalhado nos guias de Embeds.)*

### Implementação API (`ZAPI`)

A implementação para ambientes `ZAPI` envolve configurar a conexão de acordo com o serviço específico (por exemplo, fornecendo URLs de webhook, chaves de API). Consulte a seção de configuração na página de detalhes do ambiente após a criação.

## Gerenciando Ambientes

### Lista de Ambientes

A página Ambientes exibe todos os seus ambientes com informações chave:

* Nome e tipo do ambiente
* Agente associado
* Status ativo
* Data de criação
* Estatísticas de uso (se aplicável)

### Detalhes do Ambiente

Clique em um ambiente para ver seus detalhes e acessar:

* Definições de configuração
* Código de implementação (para Embed)
* Métricas de uso (se aplicável)
* Histórico de conversas (se aplicável)

### Monitoramento e Análise

O monitoramento detalhado e análises avançadas por ambiente podem não estar disponíveis. Revise as conversas associadas para insights.

## Boas Práticas

1. **Teste em Staging**: Antes de implantar em produção, teste seu ambiente em um cenário controlado.
2. **Personalize para o Contexto**: Adapte as configurações do ambiente para corresponder às expectativas da plataforma e do usuário.
3. **Monitore Regularmente**: Verifique o desempenho do ambiente e faça ajustes conforme necessário.
4. **Implemente Fallbacks**: Configure o comportamento para quando um agente não puder lidar com uma solicitação (se aplicável).

## Próximos Passos

Após configurar seu ambiente:

1. [Teste seu agente](/pt-br/features/agents) no novo ambiente
2. [Monitore as conversas](/pt-br/features/conversations) para garantir que tudo funcione corretamente
3. [Personalize a aparência](/pt-br/embeds/customization) para widgets de site