Canal do Site do Copilot Studio Mostra Chat em Branco: Correção

Ao incorporar um agente do Copilot Studio em seu site, o painel de chat às vezes aparece completamente em branco. Nenhuma mensagem de boas-vindas, nenhuma resposta e nenhum texto de erro. Esse problema geralmente ocorre porque o domínio do site não está autorizado nas configurações de canal do Copilot Studio ou porque uma autenticação ou configuração de fonte de dados necessária está ausente. Este artigo explica as três causas raiz mais comuns e fornece etapas exatas para restaurar a exibição do chat.

Por que o Chat do Site do Copilot Studio Aparece em Branco

O painel de chat em branco é quase sempre causado por uma de três falhas técnicas. Primeiro, o agente do Copilot bloqueia solicitações de domínios que não estão listados nas configurações de segurança do canal. Quando um usuário visita seu site, o navegador envia uma solicitação ao Copilot Studio. Se o domínio não estiver autorizado, o servidor retorna uma resposta vazia ou um erro CORS, e a interface do chat não mostra nada.

Segundo, o método de autenticação está mal configurado. O Copilot Studio suporta dois modos para canais de site: acesso anônimo e acesso autenticado com Microsoft Entra ID. Se o acesso anônimo estiver desativado e seu site não passar um token válido, o agente se recusa a responder. O painel de chat carrega, mas permanece vazio porque nenhum dado é trocado.

Terceiro, o agente não tem tópicos ativos ou o tópico de fallback do sistema está desabilitado. Quando um usuário digita uma mensagem, o agente tenta correspondê-la aos tópicos existentes. Se nenhum tópico corresponder e o tópico de fallback estiver desligado, o agente não retorna nada. O chat permanece em branco mesmo que a conexão esteja funcionando tecnicamente.

Etapas para Reativar o Chat do Site no Copilot Studio

Siga estas etapas na ordem listada. Teste o chat após cada etapa para identificar qual correção resolveu o problema.

Etapa 1: Autorize o Domínio do Seu Site

1. Abra o Copilot Studio e selecione seu agente
   Faça login em copilotstudio.microsoft.com com sua conta Microsoft 365. No menu à esquerda, selecione Agentes e clique no agente que mostra um chat em branco em seu site.
2. Vá para Canais > Site
   No menu à esquerda, clique em Canais. Na lista Canais disponíveis, selecione Site. Isso abre a página de configuração do canal.
3. Adicione o domínio do seu site à lista de permissões
   Em Segurança de domínio, você vê um campo de texto chamado Domínios permitidos. Digite o domínio completo do seu site, por exemplo www.exemplo.com.br. Se seu site usar vários subdomínios, adicione cada um em uma nova linha. Não inclua http:// ou https://. Clique em Salvar no topo da página.
4. Reincorpore o script de chat em seu site
   Após salvar, copie o código de incorporação da página do canal Site. Substitua a tag de script antiga em seu site por este novo código. O chat agora carregará apenas para domínios que você autorizou.

Etapa 2: Configure o Acesso Anônimo

1. Navegue para Configurações > Autenticação
   No Copilot Studio, clique em Configurações no menu à esquerda. Na seção Segurança, selecione Autenticação. Esta página controla como os usuários se identificam para o agente.
2. Ative o acesso anônimo
   Defina a alternância Permitir acesso anônimo como Ativado. Isso permite que visitantes sem uma conta Microsoft 365 interajam com o chat. Se você precisar de acesso autenticado para cenários com dados confidenciais, mantenha esta alternância Desativada e configure o Microsoft Entra ID. Para a maioria dos sites públicos, o acesso anônimo é a escolha correta.
3. Salve e republique o agente
   Clique em Salvar. Em seguida, vá para a seção Publicar no menu à esquerda e clique em Publicar. As alterações são aplicadas ao site ativo em alguns minutos.

Etapa 3: Ative o Tópico de Fallback do Sistema

1. Abra Tópicos > Sistema
   No menu à esquerda, selecione Tópicos. No topo da lista de tópicos, altere o filtro de Personalizado para Sistema. Você vê um tópico chamado Fallback.
2. Ative o tópico de fallback
   Clique no tópico Fallback. No editor de tópicos, certifique-se de que a alternância Status no canto superior direito esteja definida como Ativado. Se estiver Desativado, clique na alternância para ativá-lo. O tópico de fallback é acionado quando o agente não consegue encontrar um tópico correspondente para a mensagem do usuário.
3. Edite a mensagem de fallback
   No tópico de fallback, você vê um nó de mensagem. Substitua o texto padrão por algo útil, como “Não entendi sua pergunta. Por favor, reformule ou entre em contato com o suporte.” Clique em Salvar e republique o agente.

Etapa 4: Verifique o Código de Incorporação do Chat

1. Verifique a tag de script em seu site
   Abra o arquivo HTML do seu site ou modelo do CMS. Localize a tag de script que carrega o agente do Copilot. Deve ser semelhante a <script src="https://copilotstudio.microsoft.com/..."></script>. Certifique-se de que a URL src está correta e não truncada.
2. Confirme que o script está antes da tag de fechamento do body
   Mova a tag de script para logo antes de </body> se ainda não estiver lá. Isso garante que o DOM da página carregue completamente antes de o chat ser inicializado.
3. Limpe o cache do navegador e teste
   Abra uma janela anônima ou privada do navegador. Navegue até seu site. O chat agora deve exibir uma mensagem de boas-vindas ou uma caixa de entrada. Se ainda estiver em branco, prossiga para a próxima seção.

Se o Chat Ainda Estiver em Branco Após a Correção Principal

O chat funciona em localhost, mas não no domínio ativo

Isso confirma que a configuração de segurança de domínio é o problema. Você provavelmente esqueceu de adicionar o domínio ativo exato à lista de permissões. Volte para Canais > Site > Segurança de domínio e verifique a ortografia do domínio. Inclua o subdomínio se seu site usar www. Por exemplo, adicione tanto exemplo.com.br quanto www.exemplo.com.br se ambos redirecionarem para seu site.

O chat mostra um spinner de carregamento que nunca termina

Um spinner persistente geralmente indica um problema de rede ou CORS. Abra as ferramentas de desenvolvedor do seu navegador (F12) e verifique a guia Console. Se você vir um erro CORS, o domínio não está autorizado ou o script de incorporação está sendo bloqueado por uma política de segurança de conteúdo. Adicione o domínio do Copilot Studio copilotstudio.microsoft.com ao cabeçalho Content-Security-Policy do seu site.

O chat carrega, mas não retorna respostas para as mensagens do usuário

Isso aponta para um problema de configuração de tópicos. O agente não tem tópicos que correspondam à entrada do usuário, e o tópico de fallback está desligado ou vazio. Revisite Tópicos > Sistema > Fallback e confirme que está ativado. Verifique também seus tópicos personalizados: se todos têm condições de gatilho complexas, simplifique-as para capturar mais frases do usuário.

Canal do Site do Copilot Studio: Acesso Anônimo vs Autenticado

Item	Acesso Anônimo	Acesso Autenticado (Microsoft Entra ID)
Quem pode conversar	Qualquer visitante sem login	Apenas usuários com conta Microsoft 365 em seu locatário
Complexidade de configuração	Alternância simples em Configurações > Autenticação	Requer registro de aplicativo no portal Azure e geração de token
Acesso a dados	Agente usa apenas fontes de conhecimento estáticas	Agente pode acessar dados específicos do usuário no Microsoft 365
Caso de uso	FAQ público, marketing, suporte	Portais internos de funcionários, autoatendimento de RH
Risco de chat em branco	Baixo se o domínio estiver autorizado	Alto se o token estiver ausente ou expirado

Para a maioria dos sites públicos, o acesso anônimo é o método correto. O acesso autenticado é destinado a portais corporativos internos onde cada visitante tem uma identidade Microsoft 365. Se você escolher o acesso autenticado, deve implementar a geração de tokens no backend do seu site e passar o token para o SDK de chat do Copilot.

Após concluir as etapas acima, o canal do site do Copilot Studio deve exibir um painel de chat totalmente funcional. Teste o chat em vários navegadores e dispositivos. Se a tela em branco persistir, revise os cabeçalhos Content-Security-Policy do seu site e certifique-se de que permitem scripts de copilotstudio.microsoft.com e todos os subdomínios. Como dica avançada, use o painel Testar Agente do Copilot Studio para enviar mensagens de teste diretamente no estúdio antes de testar o site ativo.