Automatizando pesquisas
Atualizado em 2 de outubro 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 API e o 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ê. 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
Ligar uma automação que começa com um aguardar também inscreve os contatos cujo evento de gatilho aconteceu dentro desse aguardar, então eles podem receber mensagens logo depois que você a liga.
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 |
| Pagamento concluído | Um cliente conclui um pagamento por meio de uma integração de pagamentos conectada. Listado apenas quando há uma 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 e as verificações de cancelamento de inscrição 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 |
| Follow-ups automáticos | Saem depois de vencido o atraso, e apenas quando a pesquisa nunca foi aberta |
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 | Toda automação com uma etapa nesse canal é 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 retomam quando o faturamento se regulariza — nada se perde |
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 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 | 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 |