Google Reviews
Conecte negócios do Google para exibir avaliações reais no widget Avaliações — chave de API, Place ID, sincronização e cache.
O widget Avaliações (Google Reviews) mostra a nota e as avaliações de um negócio cadastrado no Google. Ele nunca consulta o Google diretamente durante a visita: lê um cache guardado no servidor, atualizado por sincronização.
Configuração
Em Converto → Integrações → Google Reviews:
- Informe a Api Key (Google Places API — versão "New").
- Em Negócios, clique para adicionar um item por negócio e preencha:
- Nome interno: apenas para você identificar o negócio no painel (ex.: "Loja Centro").
- Place ID: o identificador do local no Google Places (começa com
ChIJ…).
- Salve as opções. Ao salvar, cada negócio novo recebe um identificador interno permanente e uma sincronização é agendada.
Use Add Negócio para incluir um negócio e Delete Negócio para removê-lo.
Cada item tem os botões Sincronizar e Ver Avaliações (prévia das avaliações em cache) e mostra a data da última sincronização.
Como a sincronização funciona
| Regra | Detalhe |
|---|---|
| Frequência | Uma vez por dia (agendamento do WordPress), para negócios cuja última sincronização tem mais de 24 horas. |
| O que é buscado | Nota, quantidade de avaliações, endereço do Google Maps e as avaliações que a API retorna. |
| Acúmulo | As avaliações novas são mescladas às já guardadas, sem duplicar. |
| Cache | Arquivo JSON por negócio, na pasta de uploads (converto/google-reviews). |
| Remoção | Ao excluir um negócio do painel, o cache dele é apagado. |
Usando no widget
No widget, selecione o Negócio (a lista vem das empresas cadastradas), o tipo de exibição (Grade ou Carrossel), a ordenação e filtros. Veja todas as opções em Avaliações (widget).
Mensagens de erro
| Mensagem | O que significa |
|---|---|
| "Api Key não configurada." | Falta preencher a chave. |
| "Negócio não encontrado." | O item foi removido ou não foi salvo. |
| "Google respondeu 403/400: …" | Chave inválida, API não habilitada ou Place ID errado; a mensagem da Google acompanha o código. |
| "Resposta da Google sem campo "id"…" | O Place ID não corresponde a um local válido. |
Boas práticas
- Restrinja a chave de API no Google Cloud (por API e por origem) para evitar uso indevido.
- Exiba apenas avaliações reais; o widget não permite editar o conteúdo das avaliações.