Menu da documentação

Obter uma resposta para cada bloco

Um e-mail pode pedir mais de uma resposta: uma enquete, depois uma avaliação, depois um formulário curto. Cada um desses blocos salva sua resposta separadamente, no momento em que ela é dada. O e-mail não consegue segurar respostas e enviá-las juntas, porque não tem JavaScript e cada resposta abre uma página. E é isso que você quer: se alguém responde a enquete e para por ali, você ainda tem o voto. O que o MailInApp acrescenta é a visão do todo: o destinatário vê quanto falta, e você vê quem respondeu tudo.

O que o destinatário vê

Depois de uma resposta, o destinatário chega à visualização ao vivo do e-mail. Quando o e-mail conta dois ou mais blocos:

  • No meio do caminho, uma caixa no topo mostra o progresso ("1 de 3 respondidas") com um link Próxima pergunta que leva ao primeiro bloco ainda sem resposta. Cada bloco já respondido mostra a marca Respondida, então até um e-mail longo mostra num relance o que falta, nesta visita e nas próximas.
  • Depois da última, a caixa mostra a mensagem final no lugar: "Tudo pronto. Obrigado!" e "Todas as suas respostas foram registradas." por padrão, no idioma do destinatário, ou as suas próprias palavras.
  • Um bloco com mensagem própria a mantém: a pontuação de um quiz, a confirmação de um RSVP ou uma reunião agendada continuam aparecendo primeiro, com o progresso embaixo.

O mesmo acontece na caixa de entrada nativa, onde Próxima pergunta rola dentro do e-mail, e no app móvel do MailInApp, que mostra o progresso junto com o e-mail e a mensagem final depois da resposta que completa o conjunto.

Nada muda no e-mail enviado: o progresso fica só nas páginas que uma resposta abre.

Como configurar

Abra o painel Respostas na barra à esquerda do estúdio.

  1. Agradecer aos destinatários: Depois que todos os blocos forem respondidos (padrão) ou Depois de qualquer resposta, que agradece após cada resposta e não mostra progresso.
  2. Blocos que contam: cada enquete, avaliação, quiz, RSVP e formulário do e-mail, todos marcados de início. Desmarque os opcionais. Com todos marcados, um bloco adicionado depois também conta.
  3. Mensagem final: um título e um texto. Deixe os dois em branco para o agradecimento padrão no idioma do destinatário. Se preencher um deles, suas palavras substituem o padrão.
  4. Depois da última resposta, ir para (opcional): uma página do seu próprio site, que a resposta que completa o conjunto abre no lugar do e-mail. Precisa ser um endereço https:// completo. As respostas anteriores continuam levando ao e-mail.

Clique em Salvar. O painel salva sozinho, separado do salvamento automático do e-mail. Insights › Configurações mostra a configuração em Respostas completas, com um link de volta para o painel.

Com menos de dois blocos que pedem resposta, o painel só avisa isso: cada resposta recebe seu agradecimento, como antes. Você também pode pedir à Mia AI, por exemplo "transforme isto numa pesquisa em que as três perguntas são obrigatórias", ou configurar por um assistente com a ferramenta set_response_settings.

O que conta

  • Blocos que podem contar: enquetes, avaliações, quizzes, RSVPs e formulários, de uma ou várias páginas. O "Salvar para depois" de um produto, reações, agendamentos, checkouts, jogos e cliques simples nunca contam. Nem os detalhes pedidos depois de um RSVP ou a pergunta de acompanhamento de uma avaliação, que são opcionais.
  • Só o que foi mostrado ao destinatário. Um bloco que uma condição esconde dele, ou que só aparece no fallback estático, não conta para ele. Um bloco dentro de uma repetição conta uma vez. Um bloco excluído depois do envio deixa de contar.
  • Só destinatários conhecidos concluem. Uma visualização sem destinatário (a pré-visualização do estúdio, o HTML exportado, um link compartilhado sem destinatário) mostra o simples "Obrigado! Sua resposta foi registrada." e nunca é concluída.
  • Uma vez. Uma resposta é concluída na primeira vez em que cada bloco contado tem resposta. Mudar uma resposta depois não a conclui de novo nem envia nada duas vezes.
  • Pesquisas encerradas. Quando uma pesquisa é encerrada (por uma data de encerramento ou um limite de respostas), o e-mail mostra o aviso de encerramento, não o progresso. Quem concluiu antes do encerramento continua concluído.

Onde os resultados aparecem

  • Insights: uma taxa de conclusão e uma etapa Concluíram, com as pessoas que começaram mas não terminaram a um clique. Veja Taxa de conclusão.
  • Destinatários e exportação: uma coluna Concluído, a condição Concluiu a resposta e uma coluna completed_at na exportação CSV ampla.
  • Webhooks: um evento response.completed, uma vez por destinatário e e-mail, nos webhooks da conta e no webhook do próprio e-mail. Zapier e n8n têm um gatilho Response Completed.
  • Jornadas: os gatilhos Resposta concluída e Resposta não terminada, por exemplo para reenviar a pesquisa a quem parou no meio. Veja os gatilhos de jornadas e a jornada inicial Termine sua pesquisa.

Quando um único formulário é melhor

Vários blocos combinam com um e-mail cujas perguntas são de tipos diferentes (votar aqui, avaliar ali) e em que cada resposta vale por si só. Para um questionário que deve ser respondido e enviado de uma vez, use um formulário com várias páginas. Ele é enviado uma única vez, no fim, então não há nada parcial para acompanhar. Com Etapas no e-mail ativado, um formulário de até 12 perguntas mostra suas páginas dentro do próprio e-mail nos apps que conseguem, com Próxima e Voltar.

Para desenvolvedores

Quando um e-mail tem um estado de progresso, a resposta JSON do endpoint de interações traz completion: blockIds (os blocos contados, na ordem do e-mail), answered, nextBlockId e complete. GET /api/v1/liveview/{token} traz o mesmo completion para esse destinatário, ou null, e completionMessage (title, text), a mensagem final já resolvida no idioma do e-mail.