Mapeamento de campos e novas tentativas de sincronização
Brevo, webhooks, Google Sheets, HubSpot, Mailchimp, Notion e Airtable compartilham um único sistema de mapeamento de campos: cada campo de destino é mapeado a partir de uma origem do lado do quiz, opcionalmente transformado e validado antes de cada tentativa de sincronização. O Slack não aceita mapeamento de campos: ele envia uma mensagem com formato fixo.
Última atualização
Como funciona o mapeamento de campos nas integrações do FluoTest?
Cada campo de destino é mapeado a partir de um campo padrão do quiz, de uma pergunta específica ou de um valor calculado, com transformação, condição e valor alternativo opcionais. O esquema do destino é lido em tempo real da conta conectada. As tentativas de sincronização com falha são registradas e repetidas automaticamente com espera progressiva antes de serem marcadas como mortas.
Provedores com mapeamento de campos#
Os provedores a seguir aceitam mapeamento de campos. Cada um lê o esquema de destino em tempo real da conta ou do recurso conectado; um webhook não tem esquema para buscar, então as chaves de destino dele são livres.
| Provedor | Origem do esquema de destino |
|---|---|
| Brevo | Atributos de contato da conta do Brevo conectada. |
| Webhook | Nenhuma: as chaves de destino são livres. |
| Google Sheets | A linha de cabeçalho da planilha selecionada. |
| HubSpot | Propriedades de contato da conta do HubSpot conectada. |
| Mailchimp | Merge fields do público selecionado. |
| Notion | Propriedades do banco de dados selecionado. |
| Airtable | Campos da tabela selecionada. |
Campos de origem#
Todo quiz oferece o mesmo conjunto de campos de origem padrão, mais um campo por pergunta.
| Campo | Descrição |
|---|---|
| Endereço de e-mail do respondente. | |
| name | Nome completo. |
| first_name | Nome. |
| last_name | Sobrenome. |
| company | Nome da empresa, se coletado. |
| score | Pontuação total. Em quizzes com pontos negativos, ela é deslocada para cima pela menor pontuação possível (veja a referência de payload do webhook). |
| max_score | Pontuação máxima possível (deslocada do mesmo jeito em quizzes com pontos negativos). |
| score_percent | Pontuação como percentual. |
| tier | Rótulo da faixa de pontuação correspondente. |
| outcome | Chave do resultado principal correspondente (mecanismo de resultados do Pro). |
| tags | O rótulo da faixa, como uma lista de um item, usado como destino de tags nos provedores que aceitam tags. |
| submitted_at | Data e hora do envio. |
| quiz_name | Nome do quiz. |
| country | Não é coletado no momento; sempre vazio. |
| phone | Resposta à pergunta de telefone do quiz. |
| outcomes | Chaves de todos os resultados correspondentes, como lista. |
| disqualified | "Yes" ou "No". |
| all_answers | Todas as perguntas e respostas como um único bloco de texto, prático para um único campo de texto longo. |
| pdf_url | Link para o PDF das respostas (abre para o dono do quiz e os membros do workspace). |
| dashboard_url | Link para as respostas do quiz no painel do FluoTest. |
| results_url | Link para a página pública de resultados do respondente. |
| submission_id | O ID da resposta. |
| hidden:<name> | Um campo oculto do link do quiz (uma origem para cada nome definido no quiz, por exemplo hidden:website), listado em Campos ocultos. Fica vazio quando o link não o trouxe. |
Cada pergunta do quiz também está disponível como campo de origem, identificada pelo texto da pergunta. Respostas de seleção múltipla são enviadas como lista (assim preenchem colunas de seleção múltipla no Notion e no Airtable e são unidas por vírgulas nos demais), e os envios de arquivo são enviados como um link para o arquivo. No Notion, Airtable, Google Sheets e webhooks, "Mapear todas as perguntas" adiciona um campo por pergunta com um clique; as colunas que faltam são criadas na primeira sincronização.
Tipos de transformação#
Um mapeamento pode aplicar uma das transformações a seguir ao valor de origem resolvido antes de enviá-lo.
| Tipo | Descrição |
|---|---|
| none | Envia o valor de origem sem alterações. |
| lowercase | Converte um valor de texto para minúsculas. |
| uppercase | Converte um valor de texto para maiúsculas. |
| concat | Junta vários campos e/ou texto literal com um separador. |
| json_path | Lê um valor aninhado do objeto de respostas ou de pontuações da resposta enviada por um caminho com pontos. |
| constant | Sempre envia um valor fixo, ignorando qualquer campo de origem. |
| computed | Gera um valor que o FluoTest calcula: full_name, score_fraction (por exemplo, "8/10") ou score_percent. |
| custom | Um texto modelo com marcadores {field_key} substituídos pelos campos de origem. |
Mapeamento condicional#
Um mapeamento pode ter uma condição: ele só se aplica quando uma comparação com um campo de origem (igual a, diferente de, maior que, menor que ou contém) é verdadeira. Isso permite preencher um mesmo campo de destino de formas diferentes, ou não preenchê-lo, dependendo das respostas ou da pontuação do quiz.
Valores alternativos#
Se o valor resolvido de um mapeamento estiver vazio, o valor alternativo dele (se definido) é usado no lugar. Um mapeamento com valor alternativo e sem campo de origem sempre envia esse valor alternativo.
Campos obrigatórios e validação#
Um campo de destino que o esquema marca como obrigatório precisa resolver para um valor não vazio em algum mapeamento (uma origem, uma constante ou um valor alternativo), senão a sincronização falha na validação antes de ser tentada. Falhas de validação não são repetidas automaticamente, já que tentar de novo sem mudar o mapeamento gera o mesmo resultado; o mapeamento precisa ser corrigido.
Entrega, novas tentativas e falhas#
Toda tentativa de sincronização (com sucesso, com falha ou repetida) é registrada. Uma tentativa com falha (que não seja uma falha de validação) entra na fila para ser repetida com espera progressiva.
| Status | Significado |
|---|---|
| success | Entregue sem erros. |
| failed | A tentativa mais recente falhou; ainda pode ser repetida. |
| retrying | Na fila para uma nova tentativa em um horário agendado. |
| dead | Todas as novas tentativas se esgotaram, ou a falha foi um erro de validação; não haverá mais tentativas automáticas. |
As novas tentativas são agendadas 1 minuto, 5 minutos e 30 minutos depois de cada tentativa com falha (até 3 novas tentativas além da primeira, 4 tentativas no total). Uma tarefa em segundo plano verifica as novas tentativas pendentes a cada minuto. Uma sincronização na fila ou marcada como morta também pode ser repetida manualmente no painel de Integrações do quiz.
Perguntas frequentes#
Quais integrações aceitam mapeamento de campos?
Brevo, webhooks, Google Sheets, HubSpot, Mailchimp, Notion e Airtable. O Slack envia uma mensagem com formato fixo e não usa mapeamento de campos.
De onde vem a lista de campos de destino?
Ela é lida em tempo real da conta ou do recurso conectado (por exemplo, as propriedades de contato do HubSpot ou a linha de cabeçalho de uma planilha do Google Sheets), em vez de ser uma lista fixa, então inclui os campos personalizados.
O que acontece se um campo de destino obrigatório não tiver mapeamento?
A sincronização falha na validação e não é tentada nem repetida. Mapear um campo de origem, uma constante ou um valor alternativo para o campo obrigatório resolve o problema.
Quantas vezes o FluoTest repete uma sincronização com falha?
Até 3 tentativas adicionais depois da primeira, com intervalos de 1, 5 e 30 minutos. Depois disso, ou imediatamente no caso de uma falha de validação, a sincronização é marcada como morta e pode ser repetida manualmente.