Portal, embed e bolha de chat
Prepare a superfície web do IAgente e distribua o acesso corretamente.
Pré-visualização privada versus portal público
A pré-visualização dentro da configuração usa sessão autenticada do gestor e o canal web_test. A interface informa que ela não consome cota pública. O link de produção usa /c/:agent, atende visitantes reais e está sujeito aos limites públicos.
Use a prévia para testar instruções; depois valide o portal como visitante. Acesso administrativo não comprova a experiência de quem recebe um link.
Configurar o portal
O bloco oferece:
- URL pública e slug personalizado com letras, números e hífens.
- Expiração opcional; a tela informa retorno 404 depois da data.
- Proteção por senha.
- QR code e abertura direta.
- Iframe para incorporar em outro site.
- Capa, imagem social/OG, cor de destaque, título e meta descrição.
- Origens permitidas para incorporação.
Use título e descrição que expliquem função e público. A imagem social sugerida pela interface é aproximadamente 1200 × 630 pixels. A prévia interna não comprova o preview final do WhatsApp ou LinkedIn; teste um compartilhamento real.
Incorporar no site
Copie o iframe oferecido pelo OS. Este exemplo mostra a estrutura, usando um identificador substituível:
<iframe
src="https://os.headoffice.ai/embed/SEU_ID_DE_AGENTE"
width="480"
height="720"
allow="microphone *; camera *; autoplay *; clipboard-write"
loading="lazy"
referrerpolicy="strict-origin-when-cross-origin"
style="border:0;border-radius:16px"
title="Atendimento da empresa"
></iframe>Adapte tamanho e permissões ao uso do seu site. Confirme que o identificador e a origem de publicação são os corretos.
Origens permitidas: há textos divergentes
A tela observada contém tanto “Vazio permite qualquer site” quanto “Nenhuma origem adicionada — apenas este site pode incorporar”. Não presuma o comportamento. Cadastre explicitamente a origem desejada e teste o embed em um domínio permitido e em outro não permitido.
Bolha de chat
O configurador apresenta Aparência, Pré-visualização e Instalar bolha de chat. Há mensagem inicial, modelo Classic/Soft, posição, cores, fonte, tamanho e indicador de contraste. O redirecionamento para WhatsApp depende de conexão desse canal.
Teste desktop e celular, foco de teclado, sobreposição com botões do site e contraste. Um widget bem configurado permite fechar a conversa e não impede a navegação principal.