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. 
<!-- 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 no novo ambiente
  2. Monitore as conversas para garantir que tudo funcione corretamente
  3. Personalize a aparência para widgets de site