Google Review Requests
Pede aos seus clientes uma avaliação no Google após a visita, no WhatsApp e nos seus outros canais, no idioma de cada um, com o seu link de avaliação de cada unidade. O seu CRM, POS ou um arquivo envia os clientes; o MonoChat envia o pedido no momento certo, de forma justa.
Visão geral
O Google Review Requests pede aos seus clientes que deixem uma avaliação no Google após a visita, pelo WhatsApp e pelos outros canais que você usa no MonoChat. Seu CRM, PDV ou sistema de reservas envia os clientes do dia; o MonoChat envia a cada um deles uma mensagem curta e simpática com o seu link de avaliação do Google no momento certo, no idioma do próprio cliente. Feito para restaurantes, clínicas, salões, lojas e qualquer negócio com uma ou mais filiais.
Você adiciona cada filial como uma location (local) com o seu próprio link de avaliação e idiomas, decide quando as solicitações são enviadas (General, Geral) e envia clientes de quatro formas: pela API, por um arquivo CSV ou uma lista colada (Send, Enviar), pelos Triggers (Gatilhos) do MonoChat ou pela sua equipe a partir de uma conversa. Today (Hoje), Requests (Solicitações), Reports (Relatórios) e Activity (Atividade) mostram o que foi enviado, lido e respondido.
Destaques
- Um link por filial, em todos os idiomas. Um Place ID abre a janela “escrever uma avaliação” do Google com as estrelas; um link de avaliação colado (g.page/r/…/review) também funciona. Cada local escolhe os seus idiomas entre os 35 idiomas do MonoChat, com textos prontos que você pode alterar.
- WhatsApp do jeito certo. Enquanto a janela de 24 horas do cliente está aberta, vai a mensagem livre, mais barata; fora dela, um modelo aprovado no idioma do cliente. Um único modelo pode atender todas as filiais: o botão de link dele termina com o Place ID da filial.
- Pedidos justos. Todos os clientes recebem o link de avaliação. “Teve um problema?” fica ao lado do link, nunca no lugar dele. Não há campo de recompensa ou cupom, e o app nunca pede cinco estrelas nem nomes de funcionários.
- Respeitoso por padrão. Um atraso após a visita, horário de silêncio, uma solicitação por cliente a cada 90 dias, um limite diário opcional e um lembrete opcional. “Stop” e a palavra de descadastro de cada idioma descadastram o cliente para sempre.
Antes de começar
Você precisa de:
- O Google Place ID ou o link de avaliação da sua filial. O Place ID Finder do Google mostra o Place ID: procure o seu negócio no mapa e copie o ID que aparece abaixo do nome.
- Um canal para enviar. Para o WhatsApp: um número de WhatsApp conectado em Configurações › Canais e um modelo aprovado (o app sugere um em cada idioma). As solicitações de avaliação quase sempre são aprovadas como Marketing, e valem os preços de marketing da Meta. Os outros canais (Instagram, Messenger, chat do site, Telegram) recebem a mensagem livre enquanto permitirem; o SMS funciona a partir do seu número de SMS.
- Opcional: uma chave da Google Places API, para encontrar um Place ID pelo nome e acompanhar a nota de cada filial.
Este app não é feito nem endossado pelo Google. Google é uma marca registrada da Google LLC.
Instalação e configuração
- Instale o Google Review Requests em Configurações › MonoStore › Aplicativos, ou abra o link de instalação app.monochat.ai/apps/TN5QsrchsFJyCgbJx. Se você não tem uma conta MonoChat, o link permite se cadastrar primeiro e instala o app para você.
- Abra o painel Reviews (Avaliações; o ícone de estrela no menu à esquerda). Em Locations (Locais), clique em New location (Novo local): o nome, o Place ID ou o link de avaliação (Test the link, Testar o link), os idiomas e mensagens, e o número de WhatsApp ou SMS de envio. Clique em Save (Salvar).
- Para o WhatsApp, clique em Suggest a template (Sugerir um modelo), copie o modelo para o WhatsApp Manager ou envie-o para aprovação, e escolha-o no local quando a Meta o aprovar.
- Em General (Geral), confira o atraso, o horário de silêncio e as configurações de descadastro. Ative o Test mode (Modo de teste) se quiser testar tudo primeiro.
- Envie clientes: conecte o seu CRM ou PDV em API, envie um arquivo em Send (Enviar) ou adicione um Trigger (Gatilho).
- Clique no botão verde de ligar no cabeçalho do painel e em Turn on (Ativar). O selo ao lado do título muda de Off (Desativado) para On (Ativado).
Carregue os Sample data (Dados de exemplo; “Al Noor Grill”, duas filiais em Dubai, sessenta solicitações ao longo de duas semanas) para ver todas as telas preenchidas antes da sua primeira solicitação. Nada é enviado com os dados de exemplo, e Remove sample data (Remover dados de exemplo) os apaga sem mexer nos seus locais, gatilhos e solicitações reais.
Tela por tela
O app fica no painel Reviews (Avaliações): Today (Hoje), Requests (Solicitações), Send (Enviar), Locations (Locais), Reports (Relatórios) e Activity (Atividade), e depois as configurações: General (Geral), Triggers (Gatilhos), API, Google e Sample data (Dados de exemplo). As capturas de tela abaixo mostram os dados de exemplo.
Primeiros passos
A aba Primeiros passos da sua página inicial adiciona um cartão Set up Google Review Requests (Configurar o Google Review Requests) com cinco etapas: 1. Your location and its review link (Seu local e o link de avaliação dele), 2. How the request goes (Como a solicitação é enviada), 3. The sending rules (As regras de envio), 4. Your CRM or POS (optional) (Seu CRM ou PDV, opcional) e 5. Turn it on (Ativar). Cada etapa tem um botão que abre a tela onde fazê-la, e Next (Próximo) avança para a etapa seguinte.
O cabeçalho do painel
O cabeçalho mostra On (Ativado) ou Off (Desativado) ao lado do título. O alfinete de local abre New location (Novo local), e o botão de ligar abre Turn Google Review Requests on (Ativar o Google Review Requests): ele lista o que está pronto e o que falta (A location with its Google review link, Um local com o link de avaliação do Google; A WhatsApp template or a message, Um modelo de WhatsApp ou uma mensagem; The sending rules, As regras de envio; The API key (optional), A chave de API, opcional). Uma vez ativado, as solicitações devidas são enviadas, os gatilhos funcionam e as respostas são lidas. Enquanto está desativado, as solicitações que chegam ficam guardadas e aguardam.
Hoje
Reviews › Today (Avaliações › Hoje) abre com um resumo: solicitações de avaliação enviadas hoje, lidas, respostas, “teve um problema” e descadastros, quantas estão aguardando e os erros. Abaixo, o estado do app, as etapas de configuração ainda pendentes e os eventos mais recentes: solicitações Received (Recebidas) da API ou de um arquivo, Sent (Enviadas; na conversa como mensagem livre ou como modelo de WhatsApp com o idioma), Replied (Respondidas) com a resposta do cliente, Had a problem (Teve um problema), Opted out (Descadastrado), Skipped (Ignoradas) com o motivo (por exemplo Already asked recently, Já solicitado recentemente) e a Google rating (nota no Google) de cada local quando a chave da Places API está configurada.
Solicitações
Reviews › Requests (Avaliações › Solicitações) lista todas as solicitações. Filtre por status (Every status, Todos os status), local (Every location, Todos os locais) ou origem (Every source, Todas as origens), ou pesquise. Cada linha mostra o cliente e o telefone, o status (Scheduled, Agendada; Sent, Enviada; Delivered, Entregue; Read, Lida; Replied, Respondida; Had a problem, Teve um problema; Opted out, Descadastrado; Skipped, Ignorada; Failed, Falhou; Cancelled, Cancelada), o local, de onde veio (API, File, Arquivo; Trigger, Gatilho; ou By hand, Manual), o número do pedido e quando é ou foi enviada, com o idioma.
O ícone no fim de uma linha abre a solicitação: o local, o idioma e a origem, o seu número de pedido e o seu próprio id, como ela é enviada (mensagem livre ou modelo de WhatsApp), as Steps (Etapas: visita, recebida, agendada, enviada, entregue, lida, respondida) e a Activity (Atividade). Sua equipe pode abrir a conversa, enviar a solicitação novamente quando ela falhou ou foi ignorada, ou cancelá-la enquanto aguarda. Uma solicitação ignorada mostra o motivo, por exemplo Already asked recently (Já solicitado recentemente), The customer opted out (O cliente se descadastrou), The channel’s 24-hour window is closed (A janela de 24 horas do canal está fechada), No template or message for this language (Nenhum modelo ou mensagem para este idioma), No phone number (Sem número de telefone) ou The location has no review link (O local não tem link de avaliação).
Enviar
Reviews › Send (Avaliações › Enviar) cria solicitações manualmente:
- Upload a file (Enviar um arquivo): solte um arquivo CSV do seu PDV ou CRM (Excel: salve-o primeiro como CSV). Associe as colunas, veja as primeiras linhas e envie agora ou distribua as solicitações ao longo de algumas horas.
- Paste numbers (Colar números): um cliente por linha (número, nome), com o Location (Local), o Language (Idioma) e When (Quando: After the usual delay, Após o atraso habitual; Now (outside the quiet hours), Agora, fora do horário de silêncio; ou distribuídas em 2, 4 ou 8 horas). Create the requests (Criar as solicitações) as adiciona.
- One customer (Um cliente): telefone, nome, local, idioma e número do pedido, depois Send now (Enviar agora) ou After the usual delay (Após o atraso habitual).
Recent files and lists (Arquivos e listas recentes) mostra cada envio com quantas foram enviadas, estão aguardando, foram ignoradas ou falharam. Um número sem código do país recebe o código do país definido em General (Geral).
Locais
Reviews › Locations (Avaliações › Locais) lista as suas filiais com o estado, se o link de avaliação está pronto e os idiomas das mensagens. Use o lápis para editar um local, a seta para abrir o link de avaliação dele, o ícone de ligar para ativá-lo ou desativá-lo, ou a lixeira para excluí-lo. New location (Novo local) adiciona um, e Suggest a template (Sugerir um modelo) mostra um modelo de WhatsApp pronto.
No formulário do local:
- Name (Nome; como os clientes o conhecem, preenche
{location}nas mensagens), Sort order (Ordem) e Active (Ativo). - Google review link (Link de avaliação do Google): Place ID or review link (Place ID ou link de avaliação). Um Place ID abre a janela “escrever uma avaliação” do Google com as estrelas; um link de avaliação colado é mantido como está. O link completo é exibido, e Test the link (Testar o link) o abre. Com uma chave da Places API, Find my place (Encontrar meu lugar) pesquisa o nome e preenche o Place ID.
- Languages and messages (Idiomas e mensagens): os Languages (Idiomas) que este local usa, o Default language (Idioma padrão; para solicitações sem idioma ou num idioma que este local não usa) e o Editing language (Idioma de edição). Para cada idioma: Review request (Solicitação de avaliação), Reminder (Lembrete), Opt-out confirmation (Confirmação de descadastro) e Reply to “Had a problem?” (Resposta a “Teve um problema?”), com os marcadores
{name}{firstName}{location}{reviewLink}{date}{orderNo}. Cada idioma começa com textos prontos; Restore the ready texts (Restaurar os textos prontos) os traz de volta. - WhatsApp: o WhatsApp number (número de WhatsApp) de envio e o modelo aprovado por idioma, com o botão de link associado ao Place ID.
- SMS: o SMS number (número de SMS), para as solicitações que a API envia com o canal
smse para números de telefone quando não há número de WhatsApp.
Sugerir um modelo
Suggest a template (Sugerir um modelo) mostra um modelo de WhatsApp pronto no idioma que você escolher: o nome (por exemplo google_review_request_en_us), a categoria Marketing, o texto com {{1}} para o primeiro nome e {{2}} para o local, um botão de link Leave a review (Deixar uma avaliação) que termina com o Place ID, e as respostas rápidas Had a problem? (Teve um problema?) e Stop. Como o botão termina com o Place ID, um único modelo atende todas as filiais. Use Copy (Copiar) para levá-lo ao WhatsApp Manager, ou envie-o para aprovação a partir do app quando houver um número de WhatsApp conectado.
Relatórios
Reviews › Reports (Avaliações › Relatórios) cobre os últimos 7, 30, 90 ou 180 dias: solicitações enviadas, lidas, respondidas, com problema e descadastros, Per location (Por local) e Per source (Por origem: Trigger, Gatilho; API; By hand, Manual; File, Arquivo), com taxas de entrega e leitura, ignoradas e com falha. Com uma chave da Places API, Google rating (Nota no Google) mostra a nota e o número de avaliações de cada local dia a dia e as novas avaliações desde a primeira solicitação.
Atividade
Reviews › Activity (Avaliações › Atividade) lista tudo o que o app fez: All (Tudo), Sent (Enviadas), Replies (Respostas), Skipped (Ignoradas) ou Errors (Erros), com o cliente, o local, o que aconteceu e a origem.
Geral
Reviews › General (Avaliações › Geral) define quando as solicitações são enviadas e o que as respostas fazem:
| Configuração | O que faz |
|---|---|
| Test mode (Modo de teste) | Nada vai para os clientes: cada solicitação é escrita como uma nota interna na conversa, mostrando o que seria enviado. Desative-o para começar a enviar de verdade. |
| Delay after the visit (hours) (Atraso após a visita, em horas) | 2 por padrão. Sem data de visita, o atraso conta a partir de quando a solicitação chega. |
| One request per customer in (days) (Uma solicitação por cliente a cada, em dias) | 90 por padrão. |
| Quiet hours, From, To (Horário de silêncio, De, Até) | 21:00–10:00 por padrão. Nenhuma solicitação é enviada nesse horário; ela aguarda até que ele termine. |
| Days without requests (Dias sem solicitações) | As solicitações que caem nesses dias aguardam o dia seguinte. |
| Daily limit per location (Limite diário por local) | 0 significa sem limite. Acima do limite, as solicitações são enviadas no dia seguinte. |
| Time zone (Fuso horário) | O do espaço de trabalho por padrão. |
| One reminder, Reminder after (hours) (Um lembrete, Lembrete após, em horas) | Enviado uma vez quando o cliente não respondeu nem tocou em nenhum botão. Desativado por padrão. |
| Free-form message inside the 24-hour window (Mensagem livre dentro da janela de 24 horas) | No WhatsApp, quando o cliente escreveu nas últimas 24 horas, vai a mensagem livre do local em vez do modelo (mais barato). |
| Country code for local numbers (Código do país para números locais) | Por exemplo, 050 123 4567 vira +971 50 123 4567. |
| Language of the team notes (Idioma das notas da equipe) | O idioma das notas internas que o app escreve. |
| Opt-out tag, Stop words (Tag de descadastro, Palavras de descadastro) | Clientes com a tag nunca recebem uma solicitação. Uma resposta que seja apenas uma das palavras de descadastro descadastra o cliente; o botão “Stop” e a palavra dele em cada idioma sempre o fazem. |
| “Had a problem?”: Extra words, Tag, Give the conversation to (“Teve um problema?”: Palavras extras, Tag, Atribuir a conversa a) | “Teve um problema?” em qualquer idioma sempre conta; adicione os seus próprios textos de botão. O cliente recebe a tag, a equipe uma nota, e a conversa pode ir para uma equipe ou uma pessoa. Seus fluxos podem reagir com o evento personalizado review.feedback. |
Gatilhos
Reviews › Triggers (Avaliações › Gatilhos) envia solicitações a partir de eventos do MonoChat. Cada gatilho tem um Name (Nome), When (Quando: Conversation closed, Conversa encerrada; Payment received, Pagamento recebido; ou Tag added, Tag adicionada), o Location (Local), After (hours) (Após, em horas), o Language (Idioma; o do local ou um fixo), Sort order (Ordem) e Active (Ativo). Uma conversa que não é de WhatsApp nem de SMS recebe a mensagem livre enquanto o canal permitir; caso contrário, a solicitação vai pelo WhatsApp para o número do cliente, quando ele é conhecido.
API
Reviews › API (Avaliações › API) mostra o endereço, a App key (chave do app; Make the app key, Gerar a chave do app) e exemplos de curl prontos para One request (Uma solicitação), Several requests (Várias solicitações; até 500 numa chamada) e List the locations (Listar os locais). O token bearer é um token de API de usuário do MonoChat (perfil › tokens de API); a chave do app deve ir no corpo, e uma chamada sem ela é recusada mesmo com um token válido.
curl -X POST 'https://app.monochat.ai/api/<workspace>/custom-functions/app-google-review-requests/methods/api-request.js' \
-H 'Authorization: Bearer <YOUR_MONOCHAT_API_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{"key":"<APP_KEY>","phone":"+971501234567","name":"Sara Ahmed","location":"Dubai Marina","language":"en","visitAt":"2026-10-18T19:30:00+04:00","orderNo":"A-1043","externalId":"pos-88121"}'
| Campo | O que é |
|---|---|
phone | O número do cliente; números locais recebem o código do país de General (Geral). |
name | Opcional; preenche {name} e {firstName}. |
location | O nome ou o id do local; pode ser omitido quando você tem um único local. |
language | Opcional: um código ou nome de idioma (ar, ar-SA, ar_AE, Arabic, العربية …); caso contrário, o padrão do local. |
visitAt | Opcional: quando o cliente fez a visita (data ISO); a solicitação aguarda o atraso a partir desse momento. |
orderNo | Opcional; preenche {orderNo}. |
externalId | Opcional: o seu próprio id; o mesmo id é aceito uma única vez. |
channel | Opcional: sms para enviar por SMS. |
A resposta lista cada solicitação como aceita (com quando será enviada) ou recusada com um motivo: invalid-phone, location-unknown, no-location, duplicate, already-scheduled, recently-asked, invalid-date, too-old. A chamada inteira é recusada com bad-key ou app-off.
Google
Reviews › Google (Avaliações › Google) é opcional. Com uma chave da Google Places API, Find my place (Encontrar meu lugar) preenche o Place ID de um local a partir do nome, e a nota e o número de avaliações de cada local são lidos uma vez por dia para os relatórios. No Google Cloud: crie um projeto, ative a “Places API (New)”, crie uma chave de API em Credentials e restrinja-a a essa API. O Google cobra as chamadas na sua conta: uma pesquisa por Find my place e uma chamada de Place Details por local e por dia. Cole a chave e clique em Test (Testar) e Save (Salvar).
Ao lado de uma conversa
Na caixa de entrada, o cartão Google review (Avaliação no Google) ao lado de uma conversa mostra as solicitações de avaliação deste cliente com o status, e Send review request (Enviar solicitação de avaliação) envia uma agora para o local que a sua equipe escolher: o cliente recebe o link de avaliação do local com “Teve um problema?” ao lado. Quando o cliente se descadastrou, o cartão informa isso.
Perguntas frequentes
É permitido pedir avaliações no Google aos clientes? Sim, pedir a todos os clientes é permitido. O Google remove avaliações solicitadas de forma injusta: com recompensas, pedindo apenas a clientes satisfeitos ou pedindo notas ou palavras específicas. O app envia o link para todos, não tem campo de recompensa e nunca pede cinco estrelas.
O que acontece quando um cliente toca em “Teve um problema?”?
O cliente recebe uma resposta curta no idioma dele perguntando o que aconteceu. Sua equipe recebe uma tag e uma nota, a conversa pode ir para uma equipe ou uma pessoa, e seus fluxos podem começar com o evento personalizado review.feedback.
Qual categoria de modelo devo escolher no WhatsApp? As solicitações de avaliação quase sempre são aprovadas como Marketing, e valem os preços de marketing da Meta. Enquanto a janela de 24 horas do cliente está aberta, o app envia a mensagem livre no lugar, que é mais barata.
O mesmo cliente pode receber o pedido duas vezes?
Não dentro dos dias definidos em One request per customer in (days) (Uma solicitação por cliente a cada, em dias; 90 por padrão), e o mesmo externalId do seu sistema é aceito uma única vez.
Posso testar sem enviar nada? Sim. Ative o Test mode (Modo de teste) em General (Geral): cada solicitação é escrita como uma nota interna na conversa, mostrando exatamente o que seria enviado.