Solução de problemas

Cada mensagem de erro do Qorum, o que ela quer dizer e como resolver. Comece pelo teste de conexão: ele acha a maioria dos problemas em segundos.

Testar a conexão

Confere se a chave existe, se o endereço da sua página está liberado e se o relógio do seu computador está certo. Para testar o login e o webhook, use a aba Testar conexão do painel.

No widget

Os comentários não aparecem

• Aparece "Qorum: faltou key ou ref". Falta a opção key ou ref no Qorum.montar, ou o atributo data-key/data-ref está vazio.
• Não aparece nada. Abra o console do navegador (F12). Se houver erro de "Content Security Policy", libere o Qorum como explicado em Widget. Se aparecer "Qorum is not defined", o script widget.js não carregou antes da chamada.
• Aparece "Não deu pra carregar os comentários." A mensagem que vem em seguida diz o motivo. As mais comuns estão abaixo.

Esta página não está liberada para este site

A origem da página não está na lista de domínios do site. Lembre que com e sem www, http e https, e portas diferentes contam como endereços diferentes. Teste a origem no formulário acima e confira a lista em Configurações → Domínios liberados. Veja também Domínios.

Chave do site inválida

A chave pública está errada, incompleta, ou o site foi desativado. Copie de novo a chave da aba Instalação. Ela começa com pk_.

Login vencido, entre de novo

O token mandado foi recusado. O widget continua funcionando para leitura e chama o seu onExpired. Causas:

• O token passou do exp. Renove com onExpired, como no exemplo de Login.
• O token foi assinado com outra chave: a chave pública no lugar da secreta, ou uma chave secreta antiga depois de uma troca.
• O aud não é a chave pública deste site, ou o sub tem caractere não aceito.
• O login do site está desligado em Configurações.

Cole o token na aba Testar conexão do painel: ela lista exatamente o que está errado.

O botão Entrar não aparece

Ele aparece quando a conta Qorum está ligada, quando você passa onLogin ou quando há uma página de login configurada. Com só o login do seu site ligado e sem nenhum desses, o widget não tem para onde mandar a pessoa.

O comentário sumiu depois de publicar

• Se apareceu o aviso de aprovação, ele está na fila. Veja Moderação → Pendentes.
• Se tinha palavra bloqueada, link ou imagem, pode ter ido para a fila pelas regras do site.
• Se a página usa outro ref (por exemplo, com parâmetros no endereço), é outra conversa.

Calma, espere alguns segundos antes de comentar de novo

Existe um intervalo de 5 segundos entre um comentário e outro da mesma pessoa, contra spam. Moderadores não têm esse intervalo.

Muitas ações seguidas, espere um pouco

Mais de 30 ações de escrita (comentar, curtir, editar...) em um minuto pela mesma pessoa. Espere um minuto.

Problemas com imagens

• O botão Imagem não aparece: as imagens estão desligadas em Configurações.
• Formato não aceito: só JPG, PNG, GIF e WebP. Arquivos renomeados (um PDF chamado .jpg) são recusados.
• Imagem maior que 32 MB: reduza o tamanho antes de enviar.
• Resolução grande demais: acima de 40 megapixels (por exemplo, 8000 por 5000 pixels). Reduza antes de enviar.
• O serviço de imagens não respondeu: o envio falhou no meio do caminho. Tente de novo.
• Imagem inválida ao comentar: pela API, só valem endereços devolvidos por POST /v1/images para a mesma pessoa.

No seu servidor

Chave secreta inválida

A chave em X-Qorum-Secret não é a atual. Se alguém clicou em Trocar chave secreta, atualize o seu servidor com a nova. Confira também se mandou X-Qorum-Key com a chave pública do mesmo site.

O webhook não chega

Veja Quando não chega na página de webhooks.

Pedido sem o cabeçalho do painel

As rotas /painel/api são só do painel do Qorum. Para automatizar, use a API de gerência.

Códigos de resposta

Limites