Introdução
Quando você administra um negócio, confiança é tudo. E qual a melhor maneira de construir confiança do que exibindo suas avaliações verificadas do Google diretamente no seu site?
Pense nisso: os visitantes já pesquisam sua empresa no Google antes de fazer negócios com você. Ao exibir avaliações reais de clientes do seu Perfil de Negócios do Google diretamente no seu site construído com Laravel, você aumenta instantaneamente a credibilidade, conversões e rankings SEO.
Mas aqui está o desafio: o Google não oferece mais um widget simples de copiar e colar. Para fazer isso corretamente — e com segurança — você precisará usar a Google Places API. Não se preocupe. Neste guia, vou orientá-lo em tudo: desde obter sua chave API até buscar e exibir avaliações dinamicamente no Laravel.
Ao final deste tutorial, você terá uma solução totalmente funcional que faz seu site parecer profissional, confiável e otimizado para conversões.
Por que Mostrar Avaliações do Google no seu Site Laravel?
Antes de mergulhar no código, vamos entender por que isso importa:
- Confiança à primeira vista – Clientes em potencial não confiam apenas na sua palavra. Eles querem provas. Avaliações do Google fornecem exatamente isso.
- Vantagem SEO – O Google valoriza quando empresas integram seu ecossistema. Incorporar avaliações pode impactar positivamente a relevância e autoridade do seu site.
- Impulso de conversão – Prova social é um dos mais fortes impulsionadores de conversão. Um selo de 5 estrelas com depoimentos verificados pode inclinar decisões de compra a seu favor.
- Consistência – Em vez de copiar avaliações manualmente, esta integração mantém seu site atualizado automaticamente.
Passo 1: Configurar um Projeto no Google Cloud
Para usar a Google Places API, primeiro você precisa criar um projeto no Google Cloud:
- Acesse o Google Cloud Console.
- Crie um novo projeto e dê um nome significativo (ex: "Integração Laravel Reviews").
- Habilite a Places API na biblioteca de APIs.
- Gere uma Chave API.
⚡ Dica Pro: Crie uma Chave de Servidor separada (não uma chave de navegador), já que o Laravel fará requisições do lado do servidor.
Passo 2: Encontrar seu Google Place ID
Cada perfil de negócio está vinculado a um Place ID único. Você precisará dele para buscar avaliações.
- Acesse o Google Place ID Finder.
- Pesquise o nome do seu negócio (ex: Ramlit Limited).
- Copie o
place_id.
Guarde-o bem — você precisará dele no .env.
Passo 3: Armazenar Chaves com Segurança no Laravel
Abra seu arquivo .env e adicione:
GOOGLE_PLACES_API_KEY=your_api_key_here
GOOGLE_PLACE_ID=your_place_id_here
GOOGLE_REVIEWS_CACHE_HOURS=12
Isso garante que credenciais sensíveis não estejam hardcoded.
Passo 4: Criar um Serviço GooglePlaces no Laravel
Em app/Services/GooglePlaces.php:
<?php
namespace App\Services;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\Http;
class GooglePlaces
{
public function details(): array
{
$ttlHours = (int) config('services.google_places.cache_h', 12);
return Cache::remember('google.place.details', now()->addHours($ttlHours), function () {
$resp = Http::get('https://maps.googleapis.com/maps/api/place/details/json', [
'place_id' => config('services.google_places.place_id'),
'fields' => 'name,rating,user_ratings_total,reviews',
'key' => config('services.google_places.api_key'),
])->json();
if (($resp['status'] ?? '') !== 'OK') {
return ['name' => null, 'rating' => null, 'total' => 0, 'reviews' => []];
}
$r = $resp['result'];
return [
'name' => $r['name'] ?? 'Google Reviews',
'rating' => $r['rating'] ?? null,
'total' => $r['user_ratings_total'] ?? 0,
'reviews'=> collect($r['reviews'] ?? [])->map(fn ($rev) => [
'author' => $rev['author_name'] ?? 'Google user',
'profile' => $rev['author_url'] ?? null,
'rating' => $rev['rating'] ?? null,
'text' => $rev['text'] ?? '',
'time' => $rev['relative_time_description'] ?? '',
])->toArray(),
];
});
}
}
✔ Este serviço busca suas avaliações, formata-as de forma organizada e armazena em cache para performance.
Passo 5: Atualizar o Controller
No seu PageController.php:
use App\Services\GooglePlaces;
public function index(Request $request, GooglePlaces $places)
{
$reviews = $places->details();
$placeId = config('services.google_places.place_id');
$googleReviewsUrl = 'https://www.google.com/maps/place/?q=place_id:' . $placeId;
$googleWriteUrl = 'https://search.google.com/local/writereview?placeid=' . $placeId;
return view('ramlit-limited.pages.index', [
'reviews' => $reviews,
'googleReviewsUrl' => $googleReviewsUrl,
'googleWriteUrl' => $googleWriteUrl,
]);
}
Passo 6: Template Blade para Avaliações
Agora, vamos deixar bonito.
<section class="google-reviews">
<div class="container">
<div class="section-title">
<h5>O Que os Clientes Dizem</h5>
<h2>Confiança Mundial — Avaliações Verificadas do Google</h2>
<p>⭐ {{ $reviews['rating'] }} ({{ $reviews['total'] }} Avaliações do Google)</p>
</div>
<div class="reviews-carousel swiper-container">
<div class="swiper-wrapper">
@foreach($reviews['reviews'] as $review)
<div class="swiper-slide">
<div class="testimonial-card">
<h3>{{ $review['author'] }}</h3>
<span>{{ $review['time'] }}</span>
<div class="rating-box">
@for($i = 0; $i < $review['rating']; $i++)
<i class="fa fa-star"></i>
@endfor
</div>
<p>{{ $review['text'] }}</p>
</div>
</div>
@endforeach
</div>
</div>
<div class="review-actions">
<a href="{{ $googleReviewsUrl }}" class="btn btn-primary" target="_blank">Ver Todas as Avaliações do Google</a>
<a href="{{ $googleWriteUrl }}" class="btn btn-secondary" target="_blank">Escrever uma Avaliação</a>
</div>
</div>
</section>
✅ Totalmente dinâmico. ✅ Estilizado para combinar com seu tema. ✅ Confiável.
Limpar Cache e Testar
php artisan config:clear
php artisan cache:clear
php artisan view:clear
Recarregue sua página inicial. Você deverá ver suas avaliações verificadas do Google exibidas de forma elegante.
Dicas Extras para Produção
- Limitar uso da API – Google Places API é paga após o nível gratuito. Use cache (
Cache::remember) com sabedoria. - Proteger chaves API – Sempre restrinja sua chave API a endereços IP.
- Fallbacks – Se a API falhar, mostre uma mensagem padrão em vez de quebrar o layout.
- Estilização – Combine com a identidade da sua marca (cores, fontes, animações).
Pontos-Chave / Resumo Rápido
- Avaliações do Google = confiança + impulso SEO
- Use uma Chave de Servidor para Laravel (não chave de navegador)
- Obtenha seu Place ID pelo Place Finder do Google
- Armazene credenciais no
.envcom segurança - Armazene respostas em cache para economizar chamadas à API
- Adicione botões de "Ver Todas as Avaliações" e "Escrever uma Avaliação" para UX e confiança
Chamada para Ação (CTA)
Pronto para conquistar mais clientes? Comece a integrar suas avaliações do Perfil de Negócios do Google no seu site Laravel hoje. É uma das melhorias mais fáceis e poderosas que você pode fazer para credibilidade e conversões.
Seção de Perguntas Frequentes
P: A Google Places API é gratuita? R: O Google oferece um nível gratuito com $200 em créditos mensais. A maioria dos sites pequenos se encaixa confortavelmente nisso.
P: Posso filtrar avaliações (ex: apenas 5 estrelas)? R: Sim. Você pode filtrar avaliações dentro do serviço antes de enviá-las para sua view.
P: Preciso de uma conta de faturamento do Google Maps? R: Sim, você precisa habilitar o faturamento para usar a Places API — mesmo se ficar dentro da cota gratuita.
P: As avaliações podem se atualizar automaticamente? R: Sim. Com cache, você pode atualizar avaliações a cada poucas horas sem atingir os limites da API.
