Como usar links de pesquisa dentro de um aplicativo

Visão geral

Este guia é para quem quer disparar uma pesquisa por link, de dentro do próprio aplicativo — por exemplo, uma notificação push, um banner ou um botão que abre a pesquisa — e quer que ela abra já identificada com o usuário logado.

A ideia central: o seu app já sabe quem está logado (nome, telefone, e-mail e outros dados). Em vez de enviar um link genérico, você faz o app montar o link com os dados desse usuário no momento em que ele clica. Assim, a pesquisa abre sem pedir preenchimento e as respostas já chegam vinculadas ao contato certo — prontas para os painéis.

Por que não usar um link genérico

Se você enviar o mesmo link para todos, sem parâmetros, ao abrir a pesquisa o respondente terá que digitar manualmente nome, e-mail ou telefone antes de começar (quando esses campos são obrigatórios). Além de aumentar o atrito e reduzir a taxa de resposta, você recebe dados soltos, sem garantia de vínculo com o cadastro — o que dificulta montar painéis confiáveis depois.

Passando os dados na URL, nada disso acontece: a pesquisa abre identificada e o contato é criado ou atualizado automaticamente a partir do que veio no link.

Como funciona: o link é um modelo

Dentro de um app, o link não é fixo — ele é um modelo (template) com marcadores no lugar dos valores. Quando o usuário clica, o app troca cada marcador pelo dado real dele.

Modelo (no código do app):

https://surveys.amplifique.me/survey/{ID_DA_PESQUISA}?ref=App&name={NOME}&phone={TELEFONE}

Link final (gerado para o usuário logado):

https://surveys.amplifique.me/survey/646ca2c79118f9ca6952578c?ref=App&name=Camila%20Guedes&phone=5554991802356

Passo a passo

1. Copie o link da sua pesquisa

No construtor da pesquisa, canal Link, copie o link gerado. Ele tem o formato https://surveys.amplifique.me/survey/ID_DA_PESQUISA. Esse é o ponto de partida — você vai acrescentar os parâmetros no final.

2. Escolha quais dados passar

• Identificação: name, email, phone — para abrir a pesquisa já vinculada ao respondente.
• Campos customizados: customFields[nome_interno] — para levar contexto que você quer analisar depois (ex.: plano, unidade, patrocinadora).

A lista completa de parâmetros e formatos está em Como personalizar links com parâmetros?. O campo customizado precisa já existir na sua conta — veja Como criar campos customizados.

3. Monte o link com marcadores

Acrescente os parâmetros após o link, usando ? antes do primeiro e & entre os demais:

https://surveys.amplifique.me/survey/646ca2c79118f9ca6952578c?ref=App&name={NOME}&phone={TELEFONE}&customFields[patrocinadora]={PATROCINADORA}

4. No app, substitua os marcadores pelos dados do usuário logado

No código, troque cada marcador pelo valor real e aplique codificação de URL nos valores (espaços e caracteres especiais). A maioria das linguagens tem uma função pronta para isso (ex.: encodeURIComponent em JavaScript).

5. Teste antes de disparar

Gere o link para um usuário de teste, abra no navegador e confirme que a pesquisa abre já identificada e que o campo customizado aparece na resposta.

Exemplo completo

Um plano de saúde envia o NPS por notificação no app. O app conhece o usuário logado e monta o link:

Modelo:

https://surveys.amplifique.me/survey/646ca2c79118f9ca6952578c?ref=AppPlano&name={NOME}&phone={TELEFONE}&customFields[patrocinadora]={PATROCINADORA}

Link final para a usuária Camila:

https://surveys.amplifique.me/survey/646ca2c79118f9ca6952578c?ref=AppPlano&name=Camila%20Guedes&phone=5554991802356&customFields[patrocinadora]=plano_ouro

Ao tocar na notificação, Camila abre a pesquisa já identificada. A resposta chega com a patrocinadora plano_ouro, permitindo segmentar os painéis por patrocinadora — mesmo que ela ainda não existisse como contato na plataforma.

Boas práticas

• Crie os campos customizados antes. Um customFields[...] que não existe na conta não é gravado.
• Codifique os valores. Nome com espaço, acento ou & quebra o link se não for codificado.
• Um modelo, vários usuários. Você mantém um único link-modelo; o app gera a versão de cada usuário. Não é preciso um link por pessoa nem subir os contatos antes.
• Cuidado com dados sensíveis. Telefone e e-mail ficam visíveis na URL. Dentro do app isso costuma ser seguro, mas evite registrar essas URLs em logs ou compartilhá-las fora do fluxo do usuário.

Perguntas frequentes

Próximo passo