Automatizando pesquisas
Atualizado em 24 de agosto de 2026
Um convite de pesquisa não precisa ser enviado à mão. A Pluspoint consegue disparar um sempre que algo acontece: um pedido é feito, um contato é criado, uma conversa é resolvida. Ela também consegue cobrar quem nunca abriu o primeiro convite. Use este artigo para escolher o mecanismo adequado e siga depois o guia correspondente para os detalhes.
Antes de começar
- Acesso a Pesquisas para escolher um modelo e acesso completo a Campanhas para montar uma automação. Campanhas é um módulo global:
campaigns:fullpermite criar e editar,campaigns:restrictedé somente visualização.- Um modelo de pesquisa com Ativar envio de pesquisas ligado. Um modelo com esse botão desligado nunca aparece em uma automação, em uma campanha, na caixa de entrada nem na gaveta Enviar pesquisas.
- Um canal de saída conectado: SMS, E-mail, WhatsApp (Beta) ou WhatsApp Business. Facebook Messenger, Instagram e chat ao vivo não enviam campanhas nem automações.
- Um plano que inclua Campanhas, para qualquer coisa construída no canvas de automações.
- Contatos que carreguem o endereço de que o canal precisa — um telefone para SMS e WhatsApp, um e-mail para E-mail. Contatos sem isso são pulados.
Onde encontrar
- Automações: Campanhas → Automatizadas, ou acesse https://app.pluspoint.io/campaigns/automated.
- Modelos de pesquisa: Pesquisas → Modelos, ou acesse https://app.pluspoint.io/surveys/templates.
- Sua chave de API: Configurações → Conta, no campo somente leitura X-Api-Key, ou acesse https://app.pluspoint.io/account-settings/general.
Escolha uma abordagem
| Abordagem | Melhor para | O que dispara o envio | Onde você configura |
|---|---|---|---|
| Automação | Eventos que a Pluspoint já conhece, incluindo eventos enviados por uma integração conectada | Um evento de gatilho no canvas de automação | Campanhas → Automatizadas |
| API pública | Seu próprio back office, sistema de reservas ou plataforma de e-commerce | Seu código chamando POST /api/public/v2/surveys | Seu sistema, autenticado com a X-Api-Key |
| Zapier | Ligar um aplicativo que você já usa sem escrever código | Um gatilho de Zap no outro aplicativo | Configurações → Integrações → Zapier |
| Follow-ups automáticos | Lembrar quem recebeu um convite mas nunca o abriu | Nenhuma visita à pesquisa dentro do atraso definido | Modelo de pesquisa → aba Partilha |
| Código QR ou link da pesquisa | Clientes de balcão, recibos, displays de mesa, confirmações de pedido | O cliente escaneando ou clicando | Modelo de pesquisa → aba Partilha |
A proteção contra sobreopiniões vale para todos os caminhos de envio — a gaveta Enviar pesquisas, a fila por trás da API e do Zapier e as etapas de pesquisa das automações. Ela não vale para leituras de QR, então um código QR sempre abre a pesquisa.
Automações e API não são exclusivas. Um padrão comum: envie um Evento personalizado do seu sistema pela API e use Evento personalizado como gatilho da automação. Assim o momento, o canal e as condições continuam editáveis no aplicativo.
Prepare o modelo de pesquisa
Todo caminho automático usa as mesmas configurações do modelo, então faça isto primeiro.
- Vá em Pesquisas → Modelos e abra o modelo pelo ícone de editar.
- Abra a aba Partilha.
- Ligue Ativar envio de pesquisas.
- Preencha o Modelo de mensagem. Ele é obrigatório e é o texto usado nos convites por SMS e WhatsApp (Beta).
- Para o canal de e-mail, preencha o Assunto do e-mail. Se você deixar em branco, a Pluspoint gera um assunto com o nome da localização ou da marca.
- Opcionalmente ligue Enviar follow-ups automáticos, escolha um Atraso de 1 a 7 dias e escreva a Mensagem de Follow-up.
- Defina a Proteção contra sobreopiniões com a menor janela que você considerar confortável. Isso impede que a mesma pessoa receba convites repetidos.
- Clique em Salvar.
Os espaços reservados aceitos na mensagem e no texto de follow-up são [name], [last_name] e [location]. Em um modelo de marca, [location] resolve para o título da marca. Não digite [link]: a Pluspoint acrescenta a URL da pesquisa por você e remove qualquer [link] literal que você escrever. Qualquer outro [token] bloqueia o envio com “Espaço(s) reservado(s) não suportado(s)”.
Monte uma automação que envia uma pesquisa
- Vá em Campanhas → Automatizadas e clique em Criar automação.
- Dê um nome a ela. Uma automação sem nome não pode ser salva.
- Clique no nó Gatilho. No painel à direita escolha um ou mais Eventos de desencadeamento. Selecionar vários significa que a automação dispara quando qualquer um deles ocorre. Se mais de um acontecer, a contagem de tempo parte do evento mais recente.
- Opcionalmente ligue Uma vez por contato, para que um contato que já concluiu, saiu ou falhou nesta automação nunca seja inscrito de novo. Deixe desligado e o contato entra de novo cada vez que o evento dispara. De qualquer forma, um contato que ainda está no meio do fluxo nunca é inscrito uma segunda vez.
- Opcionalmente acrescente condições em Quem pode entrar. Deixe vazio e todo mundo que acionar a automação entra.
- Clique no + da conexão abaixo do gatilho e escolha Enviar pesquisa em Enviar.
- Escolha um Canal e uma Pesquisa. Só são listados modelos com envio habilitado.
- Conclua a parte específica do canal:
- E-mail — escolha um design de e-mail da Biblioteca que tenha um botão Link da pesquisa.
- WhatsApp Business — escolha um modelo do WhatsApp aprovado cujo botão de URL seja um link de pesquisa.
- SMS e WhatsApp (Beta) — não há mais nada a preencher. É usado o próprio Modelo de mensagem da pesquisa.
- Para atrasar o convite, clique no + acima da etapa de envio e acrescente um Aguardar, depois defina um número e uma unidade de minutos, horas ou dias.
- Clique em Salvar.
- De volta à lista Automatizadas, ligue Ativado.
Observação Uma automação salva é um rascunho e não envia nada até você ligar Ativado. Ao ligar, o grafo inteiro é revalidado de forma estrita — todo modelo e todo canal usado por ela precisa estar utilizável naquele momento.
Acertar o momento do envio
Um Aguardar colocado logo depois do Gatilho é medido a partir do próprio horário do evento de gatilho, e não do momento em que o motor chega até ele. É isso que faz “envie a pesquisa 3 dias depois da visita” cair exatamente 3 dias depois da visita. Todo outro aguardar do fluxo é medido a partir de quando o motor chega nele.
Ligar uma automação cuja primeira etapa é um aguardar também recupera o passado. A varredura de inscrição é ampliada para a duração desse aguardar. Contatos cujo evento aconteceu dentro dessa janela são capturados e agendados para o horário do evento mais o atraso.
Eventos de gatilho
| Evento de gatilho | Dispara quando |
|---|---|
| Contato criado | Um registro de contato é criado — por importação, manualmente, por um widget, por uma pesquisa ou pela API |
| Pesquisa respondida | Um contato envia uma pesquisa |
| Pesquisa enviada | Um convite de pesquisa sai |
| Conversa resolvida | Uma conversa da caixa de entrada é encerrada |
| Avaliação recebida | Chega uma avaliação que pode ser atribuída ao contato |
| Evento personalizado | Seu sistema publica um evento em POST /api/public/v2/custom-events |
| Cupom resgatado | O contato resgata um cupom |
| Reserva do CoverManager | Uma reserva do CoverManager é importada. Listado apenas quando a integração CoverManager está conectada |
| Pedido da VTEX | Um pedido da VTEX é importado. Listado apenas quando a integração VTEX está conectada |
Quando Evento personalizado está selecionado, aparece um campo extra Tipo de evento personalizado (opcional). Deixe vazio para reagir a qualquer evento personalizado, ou digite um tipo de evento para corresponder exatamente a ele.
Envie pesquisas a partir do seu próprio sistema
A API pública enfileira um convite exatamente como o aplicativo faz, então a proteção contra sobreopiniões, as verificações de cancelamento de inscrição e a identificação de contatos continuam valendo.
- URL base:
https://app.pluspoint.io/api/public/v2 - Cabeçalho de autenticação:
X-Api-Key, copiado de Configurações → Conta - Documentação de referência:
https://docs.pluspoint.io
Campos do corpo de POST /surveys:
| Campo | Obrigatório | Observações |
|---|---|---|
locationId | Sim | Inteiro. A localização para a qual a pesquisa é enviada |
surveyTemplateId | Sim | O ID externo ou GUID do modelo. Obtenha em GET /survey-templates |
channelId | Sim | GUID. Obtenha em GET /channels |
firstName | Não | Usado para personalizar [name] |
lastName | Não | Usado para personalizar [last_name] |
phoneNumber | Condicional | Obrigatório e validado para canais de SMS e WhatsApp |
email | Condicional | Obrigatório para o canal de e-mail |
delay | Não | Horas de espera antes do envio, 0 ou mais |
whatsAppTemplateId | Condicional | Obrigatório para um canal de WhatsApp Business. Obtenha em GET /channels/{channelId}/whatsapp-templates com hasButtons=true e linkType=survey |
Outros endpoints úteis na mesma URL base: GET /survey-templates lista modelos com suas perguntas, POST /survey-responses envia uma resposta coletada em outro lugar e GET /survey-responses lê as respostas de volta.
Quando o convite realmente sai
Nada aqui é instantâneo. Planeje seus atrasos em torno destes ritmos.
| Caminho | O que esperar |
|---|---|
| Envios de automações | Saem poucos minutos depois do gatilho, mais o aguardar que você definir |
| Fila de pesquisas (API, Zapier e envios em massa) | Envios para o mesmo canal e modelo saem com pelo menos 30 segundos de intervalo; o WhatsApp não oficial sai com cerca de 30 a 60 segundos de intervalo e passa para o dia seguinte depois de 200 mensagens |
| Follow-ups automáticos | Saem cerca de uma vez por hora depois de vencido o atraso, e apenas quando a pesquisa nunca foi aberta |
| Importação de pedidos da VTEX | Uma vez por dia, às 12:00 UTC, cobrindo os pedidos do dia anterior |
O que pode impedir uma pesquisa automática
| Situação | O que acontece |
|---|---|
| O contato cancelou a inscrição | O envio é recusado. Em uma automação, a inscrição sai do fluxo na próxima etapa de envio |
| A proteção contra sobreopiniões ainda está dentro da janela | O envio é pulado em silêncio e o contato segue para a etapa seguinte |
| O contato não tem telefone nem e-mail para aquele canal | A etapa é pulada e o fluxo continua |
| O canal não está pronto | A etapa é repetida em 30 minutos. Enquanto um canal está fora do estado pronto, toda automação com uma etapa nele é marcada como falha. Elas se recuperam quando o canal reconecta |
| Um modelo do WhatsApp Business perde a aprovação | As automações que o usam são pausadas automaticamente e as campanhas em execução que o usam são marcadas como falhas |
| O plano deixa de incluir Campanhas | As automações ativas passam a pausadas. Elas não voltam a ser ligadas automaticamente quando o plano retorna |
| A conta está acima da cota de localizações ou de usuários | Os envios de campanhas são bloqueados mesmo que o plano inclua Campanhas. As inscrições devidas ficam paradas por 30 minutos de cada vez e retomam quando o faturamento se regulariza — nada se perde |
| Uma inscrição fica sem processamento por mais tempo que a soma das esperas do fluxo mais 90 dias | Ela sai sem enviar, então ninguém recebe uma mensagem meses atrasada |
Solução de problemas
| Sintoma | Causa | Solução |
|---|---|---|
| O modelo não aparece no menu Pesquisa | Ativar envio de pesquisas está desligado nesse modelo | Abra o modelo, vá até a aba Partilha e ligue o botão |
| Enviar pesquisa não aparece no painel de etapas | Você não tem acesso ao módulo Pesquisas | Peça a um administrador da conta para conceder acesso a Pesquisas a uma das suas equipes |
| A chave Ativado está desligada e acinzentada | A automação teve um erro de etapa irrecuperável | Abra, corrija a etapa destacada, salve (o que limpa a marcação de falha) e ligue de novo |
| A automação está ativada mas ninguém é inscrito | Os eventos de gatilho aconteceram antes de ela ser ligada, ou os contatos cancelaram a inscrição, ou nenhum deles tem endereço para o canal de envio | A inscrição só olha para a frente, a partir de uma janela recente. Confirme que o tipo de canal combina com os dados que seus contatos realmente têm |
| Tudo é enviado, mas uma pessoa específica nunca recebe convite | A proteção contra sobreopiniões já a cobria, ou ela cancelou a inscrição | Confira a linha do tempo de atividades do contato e reduza a janela de sobreopiniões no modelo, se ela estiver larga demais |
| Toda a seção Campanhas mostra uma página de upgrade | O plano não inclui Campanhas | Use o link da pesquisa, um código QR ou a gaveta Enviar pesquisas, ou faça upgrade do plano |
| O salvamento é recusado porque o fluxo é grande demais | Uma automação é limitada a 100 etapas | Divida o fluxo em duas automações |