Voltar para artigos
HotsiteBasicoAtualizado em 30 de out. de 2026

Configuração do Servidor do Hotsite

Por que endereços e chaves do hotsite ficam num lugar só e o que acontece quando um deles está errado

#hotsite#participante#campanha

O que e?

É a decisão técnica (ADR-005, aceita) de concentrar num único ponto a configuração do servidor do hotsite: o endereço da API, o endereço público do site e dos arquivos, o serviço de consulta de NFC-e e a chave da inteligência artificial que identifica produtos. Essa configuração é do servidor e não tem relação com a configuração da campanha no painel.

Como funciona?

  • Cada endereço é conferido pelo sistema: valor ausente ou mal escrito gera erro logo, em vez de uma falha silenciosa.
  • Chaves e endereços internos ficam só no servidor e nunca chegam ao navegador do participante.
  • A configuração fica num arquivo do servidor, fora do código, e é preservada entre as publicações.
  • A chave da inteligência artificial é opcional: sem ela o site funciona e só a identificação automática de produtos fica indisponível.

Como explicar ao cliente?

A configuração técnica do hotsite é única para todas as campanhas e é cuidada pelo time técnico. O cliente não precisa nem consegue alterá-la; tudo o que é da campanha fica no painel.

Possiveis falhas, causas e solucoes

  • Falha: depois de uma publicação, uma parte do site para em todas as campanhas (por exemplo comprovantes que não abrem ou leitura de QR Code que nunca funciona).
  • Possivel causa: um endereço de serviço configurado errado no servidor.
  • Como orientar: informe que o time técnico está verificando. Para a nota, oriente o preenchimento manual.
  • Quando escalar: acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com o horário e o que parou.
  • Falha: a tela avisa "A identificação automática dos produtos está indisponível".
  • Possivel causa: a chave da inteligência artificial não está configurada ou o serviço está fora.
  • Como orientar: oriente adicionar os produtos manualmente. O cadastro da nota funciona normalmente.
  • Quando escalar: só se o recurso for esperado e continuar indisponível por mais de um dia, abrindo issue no Jira (projeto DEV).

Exemplo de resposta pronta

Olá! Neste momento a identificação automática dos produtos está indisponível, mas você pode concluir o cadastro normalmente: basta adicionar os produtos participantes da sua compra manualmente antes de enviar.

Quando escalar?

Acione urgentemente o time de desenvolvimento e abra issue no Jira (projeto DEV) quando um recurso parar em todas as campanhas ao mesmo tempo, principalmente logo após uma publicação. Envie o horário em que começou, o recurso afetado e os prints.

Artigos relacionados

HotsiteBasico
APIs e Integrações do Hotsite

Quais serviços o hotsite usa e o que o participante vê quando cada um falha

#hotsite#participante#campanha
Atualizado em 30 de out. de 2026
HotsiteBasico
Operação e Publicação do Hotsite V2

Onde o hotsite roda e como novas versões são publicadas e o que conferir quando algo sai do ar

#hotsite#participante#campanha
Atualizado em 30 de out. de 2026
HotsiteBasico
Decisões Técnicas do Hotsite V2

Resumo das decisões técnicas registradas do hotsite e o efeito prático de cada uma no atendimento

#hotsite#participante#campanha
Atualizado em 30 de out. de 2026