Disparar pesquisa NPS automaticamente

A forma mais escalável de coletar NPS é deixar o disparo no piloto automático. Você configura uma pesquisa com gatilho e delay, e a partir daí, toda vez que o evento acontece (ex: venda fechada), o cliente recebe o link da pesquisa sozinho — sem você precisar lembrar de mandar manualmente caso a caso.

Esse artigo cobre os tipos de trigger disponíveis, como o disparo manual funciona pra leads selecionados a dedo, e como o sistema lida com expiração de respostas.

Pré-requisitos

• Permissão de admin ou manager.
• Pelo menos uma pesquisa criada (veja Criar uma pesquisa NPS).
• Pra envio via WhatsApp, instância conectada (QR Code ou Cloud API).

Tipos de trigger disponíveis

Ao criar/editar uma pesquisa, no campo Disparar quando, você escolhe entre:

Manual (enviar link)

A pesquisa não dispara sozinha. Você decide quando enviar e pra quem. Útil pra:

• Pesquisas pontuais (campanha de um mês específico)
• Quando você quer filtrar leads que recebem (não todos os clientes)
• Testes iniciais antes de automatizar

Automático — Venda fechada

A pesquisa dispara toda vez que uma Sale é criada no Syncro — ou seja, quando um lead vai pra etapa de Ganho no funil ou quando alguém marca a venda como fechada manualmente.

Use pra:

• Medir satisfação pós-venda (NPS clássico)
• Identificar problemas de experiência logo após a compra
• Coletar depoimentos espontâneos (via campo de comentário)

Automático — Conversa fechada (em breve)

A ideia é: quando uma conversa do chat é marcada como fechada, dispara a pesquisa pro lead vinculado. Bom pra medir satisfação pós-atendimento, separado de venda.

Hoje a opção aparece no select da UI, mas o disparo automático ainda não está ativo. Use Manual pra esse caso por enquanto.

Delay — quando exatamente o link é enviado

O campo Delay (horas após trigger) define quanto tempo o sistema espera entre o evento e o envio:

• 0 — manda na hora (instantâneo)
• 2 — duas horas depois
• 24 — no dia seguinte
• 72 — três dias depois
• 168 — uma semana depois (máximo permitido)

Recomendações por contexto:

Caso de uso	Delay sugerido	Por quê
NPS pós-venda de SaaS / serviço	24-72h	Cliente já experimentou o produto/serviço
NPS pós-venda de produto físico	5-7 dias (120-168h)	Tempo de entrega + uso
NPS pós-atendimento	0-2h	Memória fresca da experiência
NPS de upsell / renovação	24h	Não atrapalhar o momento do pagamento

Disparo manual em massa

Mesmo com gatilho automático, você pode disparar manualmente pra um grupo selecionado. Útil pra:

• Backfill — enviar pra clientes antigos que não tinham passado pelo trigger
• Campanhas pontuais — disparar de uma vez pra todos os leads de uma lista
• Re-engajamento — coletar feedback de quem ficou tempo sem responder

Como disparar manualmente

1. Em Pesquisas, encontre a pesquisa desejada na tabela.
2. Clique no botão de envio em massa (procure ícone tipo paper plane ou opção em menu de ações).
3. Selecione os leads que devem receber:

• Pode escolher por filtro (ex: leads de uma lista, leads de um pipeline, leads com tag X)
• Ou colar/digitar IDs específicos

4. Confirme o disparo.
5. O Syncro cria registros pendentes em survey_responses e enfileira jobs de envio.

O que acontece nos bastidores quando o trigger dispara

Pra cada lead afetado:

1. O sistema cria um registro em survey_responses com:

• uuid único (vai virar parte do link público)
• survey_id da pesquisa
• lead_id do destinatário
• status='pending'
• expires_at = now+7 dias

2. Enfileira o job SendNpsSurveyJob com o delay configurado.
3. Quando o delay vence, o job:

• Verifica se a pesquisa está ativa
• Verifica se o lead ainda existe e tem WhatsApp (pra canal whatsapp)
• Envia mensagem com o link /s/{uuid}
• Atualiza sent_at = now

4. Quando o lead clica no link e responde:

• status='answered', score, comment, answered_at populados.

Mensagem padrão enviada via WhatsApp

Pra envios via WhatsApp, o Syncro usa um texto padrão com o nome do lead embutido:

"Olá {nome}! 😊

Como foi sua experiência conosco? Responde rapidinho aí: {link}"*

Hoje esse texto não é editável pela UI — se você precisar de mensagem customizada, considere:

• Disparar pelo canal link e enviar manualmente o link em uma mensagem própria.
• Usar uma automação com action de envio de mensagem que inclua o link da pesquisa nos parâmetros.

Expiração — o que acontece se o cliente não responder

Cada link de pesquisa tem expires_at = sent_at + 7 dias por padrão.

• Antes da expiração: o cliente clica → responde normalmente.
• Depois da expiração: o cliente clica → vê página "Pesquisa expirada" com o ícone ⏰ e a mensagem "O prazo para responder esta pesquisa já passou.". Não consegue responder.

Internamente, o status da resposta passa de pending pra expired automaticamente conforme o tempo passa.

💡 Dica: respostas expiradas não contam no cálculo do NPS Score. Se a taxa de expiração ficar alta, considere reduzir o delay ou enviar lembretes pelos canais que você usa.

Configuração via Observer (técnico)

Pra desenvolvedores curiosos: o trigger automático Venda fechada é implementado via SaleObserver (app/Observers/SaleObserver.php). Quando uma Sale é criada (created hook), o observer procura pesquisas ativas com trigger='lead_won' e dispara o SendNpsSurveyJob pra cada uma — respeitando o delay configurado em cada pesquisa.

Múltiplas pesquisas com o mesmo trigger

Você pode ter várias pesquisas ativas com trigger='lead_won' ao mesmo tempo. Cada uma vai disparar independente. Use isso pra:

• Pesquisas A/B — testar variações de pergunta
• Pesquisas em sequência — uma de NPS imediato (delay 0) e outra de follow-up 30 dias depois (delay 720, mas limite atual é 168h — solução: criar via automação)

Artigos relacionados

• Criar uma pesquisa NPS
• Analisar respostas e calcular o NPS
• Automações