Documentação

Restrições de Domínio

Controle quais sites podem incorporar o widget do seu agente.

As restrições de domínio limitam onde o widget do seu agente pode ser incorporado. Quando configuradas, o widget só carrega em domínios aprovados - impedindo o uso não autorizado em outros sites.

Configurando Restrições de Domínio

  1. Vá para a aba Configurações do seu agente
  2. Clique em Segurança
  3. Encontre Domínios permitidos
  4. Ative a restrição
  5. Adicione seu(s) domínio(s)
  6. Salve as alterações

Adicionando Domínios

Digite origens completas incluindo o protocolo. A validação de domínio realiza correspondência exata de origem (protocolo + hostname + porta):

  • https://example.com - Corresponde apenas a https://example.com (NÃO a https://www.example.com)
  • https://www.example.com - Corresponde apenas a https://www.example.com
  • https://*.example.com - Corresponde a qualquer subdomínio (por exemplo, https://app.example.com, https://www.example.com), mas NÃO ao domínio raiz

Exemplos

EntradaCorresponde aNão corresponde a
https://mysite.comhttps://mysite.comhttps://www.mysite.com, https://app.mysite.com
https://www.mysite.comhttps://www.mysite.comhttps://mysite.com, https://app.mysite.com
https://*.mysite.comhttps://app.mysite.com, https://www.mysite.comhttps://mysite.com (domínio raiz)

Importante: Para cobrir tanto a raiz quanto o www, adicione as duas entradas:

https://mysite.com
https://www.mysite.com

O Que Acontece em Domínios Não Autorizados

Quando alguém tenta carregar seu widget a partir de uma origem não aprovada, a API de chat retorna uma resposta 403 Domain not allowed e o widget não conseguirá iniciar uma conversa.

Seu agente e suas mensagens permanecem seguros.

Desenvolvimento e Testes

Para desenvolvimento local, adicione a origem completa incluindo a porta:

  • http://localhost:3000
  • http://127.0.0.1:3000

Lembre-se de remover essas entradas antes de ir para produção, ou use agentes separados para desenvolvimento e produção.

Múltiplos Domínios

Adicione todas as origens onde seu agente deve aparecer:

https://mysite.com
https://www.mysite.com
https://app.mysite.com
https://help.mysite.com

Não há limite para o número de domínios permitidos.

Desativando Restrições

Para permitir a incorporação em qualquer domínio:

  1. Vá para Configurações > Segurança
  2. Desative Domínios permitidos
  3. Salve as alterações

Quando a opção está desativada, o widget pode ser incorporado em qualquer lugar.

Casos de Uso Comuns

Site de Marketing Único

https://mycompany.com
https://www.mycompany.com

Múltiplas Propriedades

https://mainsite.com
https://blog.mainsite.com
https://shop.mainsite.com
https://support.mainsite.com

Desenvolvimento + Produção

Crie agentes separados:

  • Agente de produção: Apenas domínios de produção
  • Agente de desenvolvimento: localhost, domínios de staging

Solução de Problemas

O Widget Não Carrega no Meu Site

  • Verifique se a origem está na lista permitida
  • Verifique se há erros de digitação (https://mysite.com vs https://www.mysite.com)
  • Certifique-se de que cada entrada inclui o protocolo (https:// ou http://) e corresponde à porta usada no navegador
  • Limpe o cache do navegador e tente novamente

O Widget Carrega em Sites Não Autorizados

  • Verifique se as restrições de domínio foram salvas
  • Verifique se o wildcard está muito abrangente
  • Teste em um navegador privado/anônimo

Próximos Passos