[Voltar ao blog](/pt-br/blog/)  **Em resumo**: crie um formulário no Tally e adicione campos ocultos chamados `eventId`, `bibNumber`, `selfieRequestId` e `ref`. Aponte o botão de CTA para a URL do formulário e acrescente parâmetros como `?eventId=123&bibNumber=456&ref=...`. Depois, conecte o Tally ao [Zapier](https://tally.so/help/zapier-integration) (sem código) ou a [webhooks](https://tally.so/help/webhooks) (mais controle) para encaminhar as solicitações, cobrar o pagamento e entregar os resultados. O que são os campos ocultos do Tally (e por que eles são perfeitos para CTAs) ------------------------------------------------------------------------------- Os campos ocultos do Tally são campos invisíveis que você adiciona a um formulário para **passar dados pela URL do formulário** e salvá-los junto com cada envio. Segundo a documentação do Tally, você adiciona campos ocultos digitando `/hidden` no editor, dá nome aos campos (por exemplo, `name` e `ref`) e depois passa os valores por parâmetros de URL, assim: https://tally.so/r/FORM_ID?name=Marie&ref=email Veja o guia oficial do Tally (em inglês): [Hidden fields](https://tally.so/help/hidden-fields). Dois detalhes importam nos fluxos com CTA: - **Os nomes dos campos ocultos diferenciam maiúsculas de minúsculas** (o parâmetro da URL precisa ser idêntico). - **O primeiro parâmetro começa com `?`** e os parâmetros seguintes usam `&`. Quais parâmetros de URL passar pelo botão de CTA -------------------------------------------------- O objetivo é enviar o menor conjunto de valores que permita à sua equipe (ou à sua automação) identificar o contexto exato sem que o usuário precise digitar tudo de novo. Para CTAs de fotografia de eventos, os parâmetros mais úteis são: eventId Em qual evento/galeria o usuário está. bibNumber Qual número de peito foi buscado (fluxos de busca em corridas). selfieRequestId De qual busca por selfie o usuário veio (se o seu fluxo usa busca por selfie). ref Uma referência de “contexto de retorno” (muitas vezes a URL da página ou uma URL codificada em base64). Você também pode passar campos de atribuição de marketing, como `utm_source`, `utm_medium` e `utm_campaign`, se quiser métricas dos CTAs. Passo 1: crie um formulário no Tally que aceite campos ocultos --------------------------------------------------------------- No editor de formulários do Tally, insira campos ocultos digitando `/hidden` e adicione um bloco por campo. Dê a cada campo oculto exatamente o mesmo nome do parâmetro correspondente na URL do CTA (lembre-se: maiúsculas e minúsculas fazem diferença). O guia do Tally cobre o processo do início ao fim: [Hidden fields](https://tally.so/help/hidden-fields). Nomes de campos ocultos recomendados para CTAs no estilo da 9Pic AI: - **`eventId`** - **`bibNumber`** (opcional) - **`selfieRequestId`** (opcional) - **`ref`** (recomendado) - **`utm_source`, `utm_medium`, `utm_campaign`** (opcional) Depois, adicione os campos visíveis que o usuário deve preencher (por exemplo: e-mail, telefone, “Do que você precisa?”, escolha de pacote etc.). Mantenha o formulário curto: quem clica no CTA já demonstra forte interesse, e você não quer desperdiçar esse clique. Passo 2: preencha previamente os campos visíveis (e-mail/nome) a partir dos campos ocultos ------------------------------------------------------------------------------------------- Às vezes você já sabe o e-mail de quem responde (por exemplo, se a pessoa está logada ou se o e-mail está no seu CRM). O Tally permite **preencher previamente** muitos campos de entrada usando um campo oculto como “Default answer” (resposta padrão). Documentação oficial: [Pre-populate form fields](https://tally.so/help/pre-populate-form-fields). O Tally aponta dois limites importantes: não é possível preencher previamente os blocos **payment** (pagamento) nem **file upload** (envio de arquivo), e os campos ocultos diferenciam maiúsculas de minúsculas. ### Exemplo: preencha previamente um campo de e-mail 1. Adicione um campo de e-mail comum (por exemplo, “Seu e-mail”). 2. Adicione um campo oculto chamado `email`. 3. No campo de e-mail, ative **Default answer** e escolha o campo oculto `email`. 4. Passe `?email=runner@example.com` na URL do CTA. Passo 3: monte a URL do CTA (com exemplos de parâmetros) --------------------------------------------------------- Depois de publicar o formulário no Tally, copie a URL dele (na aba Share) e acrescente os parâmetros. O primeiro parâmetro usa `?`, e cada parâmetro seguinte usa `&`. ### CTA de compra de fotos Use quando o usuário estiver vendo os resultados da busca e quiser comprar fotos, pedir uma fatura ou finalizar a compra. https://tally.so/r/FORM_ID?eventId=123&bibNumber=456&ref=BASE64_OR_URLENCODED_VALUE ### CTA de ajuda com a busca por selfie Use quando a sua interface tiver fluxos de busca por selfie e você quiser que o suporte veja na hora qual solicitação falhou. https://tally.so/r/FORM_ID?eventId=123&selfieRequestId=abc123&ref=BASE64_OR_URLENCODED_VALUE ### CTA de ajuda geral / contato Mesmo sem um número de peito ou um ID de busca por selfie, passar `eventId` e `ref` já basta para agilizar a triagem. https://tally.so/r/FORM_ID?eventId=123&ref=BASE64_OR_URLENCODED_VALUE Dica: se o seu CTA já inclui um parâmetro `ref` (por exemplo, a URL da página atual codificada por segurança), o Tally vai salvá-lo como está no campo oculto. Trate o `ref` como “contexto”, não como um segredo. Casos de uso de CTA para equipes de fotografia de eventos --------------------------------------------------------- Estes são modelos de CTA de alto valor que vimos equipes de eventos configurarem quando querem mais flexibilidade do que um fluxo de pagamento fixo oferece. Todos funcionam bem com um formulário do Tally + campos ocultos, porque a experiência do usuário é rápida e a equipe interna recebe o contexto completo. ### 1) Comprar fotos / pedir um link de pagamento Adicione um CTA “Comprar fotos” ao lado dos resultados da busca. O formulário coleta o e-mail, o telefone (opcional) e o pacote preferido. Os campos ocultos capturam `eventId`, `bibNumber` ou `selfieRequestId` e `ref`, para que sua equipe atenda o pedido sem idas e vindas. Se você usa o [9Pic Checkout](/pt-br/products/checkout/), pode alinhar as perguntas sobre pacotes do formulário com as suas opções de venda de fotos. ### 2) Informar uma foto que falta (ou uma correspondência errada) Um CTA “Não encontrou suas fotos?” pode coletar uma descrição curta (faixa de horário, cor do número de peito, roupa) e, se quiser, permitir o envio de uma captura de tela. Os campos ocultos evitam a parte mais trabalhosa do suporte: pedir ao corredor que explique em que ponto do fluxo ele estava. ### 3) Pedir ajuda (triagem rápida do suporte) Adicione um CTA “Precisa de ajuda?” na interface da galeria. Encaminhe os envios para o Slack, o e-mail ou o seu help desk com os campos ocultos anexados. Isso ajuda principalmente quando você tem vários eventos ativos e o suporte precisa saber de qual evento o usuário está falando. ### 4) Captação de leads B2B de organizadores Adicione um CTA “Vai organizar um evento?” nas páginas de corridas e nas landing pages (por exemplo, [Maratonas](/marathons/)). Use campos ocultos para a atribuição de campanhas e encaminhe os leads para um CRM. Automatize o fluxo com o Zapier (pagamentos, entrega, notificações) --------------------------------------------------------------------- O Tally oferece uma integração com o Zapier que é acionada a cada **novo envio de formulário** e pode se conectar a milhares de apps. A documentação do Tally também informa que a integração com o Zapier é gratuita para todos os usuários do Tally: [Zapier integration](https://tally.so/help/zapier-integration). Modelos de automação comuns que os clientes montam com o Zapier (ou com ferramentas parecidas, como Make, Integrately e Pipedream): - **Fluxo de link de pagamento**: novo envio de “Comprar fotos” → criar um Stripe Payment Link / fatura na sua ferramenta de cobrança → enviar o link por e-mail ao corredor → avisar o canal de operações. - **Fluxo de entrega**: envio → criar um registro de pedido no Airtable/Notion/CRM → definir um responsável → enviar um e-mail de confirmação automático → entregar um link de download quando o pedido for atendido. - **Fluxo de suporte**: envio de “Precisa de ajuda?” → criar um chamado no help desk (ou uma mensagem no Slack) com `eventId` e `ref` → encaminhar para a equipe certa com base no SLA. Observação: o plano gratuito do Zapier se limita a Zaps de duas etapas (segundo o guia do Tally sobre o Zapier). Se precisar de encaminhamentos com várias etapas, talvez você precise de um plano pago ou de webhooks + o seu próprio executor de fluxos. Quando usar webhooks (em vez de Zapier/Make) -------------------------------------------- Se você precisa de controle total, o Tally pode fazer um POST de cada envio para o seu endpoint, em JSON, via webhooks. A documentação de webhooks do Tally destaca alguns detalhes operacionais que vale levar em conta no projeto: há um tempo limite de 10 segundos para responder, novas tentativas em caso de falha e um segredo de assinatura opcional que adiciona um cabeçalho `Tally-Signature` para verificação. Referência: [Webhooks](https://tally.so/help/webhooks). Escolha webhooks quando quiser: - **Iniciar um fluxo de pagamento personalizado** (criar sua própria lógica de sessão de checkout, mapear pacotes, lidar com moedas e registrar o atendimento dos pedidos). - **Entregar resultados automaticamente** (enviar links de download, liberar acessos, gerar PDFs ou acionar tarefas internas). - **Ter o controle da confiabilidade e da segurança** (verificar assinaturas, registrar eventos em log e criar um processamento que suporte novas tentativas com segurança). Boas práticas: privacidade, codificação de URL e convenções de nomes ------------------------------------------------------------------------- - **Não coloque segredos nos parâmetros de URL**: URLs podem ser registradas em logs e compartilhadas. Prefira IDs (como `eventId`) a dados pessoais. - **Codifique o `ref` com segurança**: se você passar uma URL completa como `ref`, aplique a codificação de URL (ou base64) para que ela resista a copiar e colar e não quebre a query string. - **Mantenha os nomes dos campos ocultos estáveis**: trocar `eventId` por `event_id` depois vai quebrar os CTAs existentes, a menos que você atualize os links em todos os lugares. - **Teste de ponta a ponta**: clique no CTA → envie o formulário → confirme que os campos ocultos aparecem nos envios recebidos no Tally → confirme que o seu Zap/webhook recebe os valores esperados. Perguntas frequentes -------------------- ### Os campos ocultos do Tally são gratuitos? Sim. A documentação do Tally informa que os campos ocultos são gratuitos para todos os usuários do Tally. Veja: [Hidden fields](https://tally.so/help/hidden-fields). ### Os nomes dos campos ocultos precisam ser idênticos aos parâmetros da URL? Sim. O Tally explica que os campos ocultos diferenciam maiúsculas de minúsculas, então o nome do campo oculto e o parâmetro da URL precisam ser idênticos (por exemplo, `eventId` é diferente de `eventid`). ### Posso preencher previamente campos de pagamento por parâmetros de URL? A documentação do Tally sobre preenchimento prévio diz que não é possível preencher previamente blocos de pagamento (nem de envio de arquivo). Você ainda pode passar campos ocultos para dar contexto e usar automação para cuidar do pagamento fora do formulário, se necessário. Veja: [Pre-populate form fields](https://tally.so/help/pre-populate-form-fields). ### O Zapier funciona com os envios do Tally? Sim. O Tally documenta uma integração com o Zapier em que o gatilho é um novo envio de formulário e você pode encaminhar os dados para outros apps. Veja: [Zapier integration](https://tally.so/help/zapier-integration). ### Devo usar o Zapier ou webhooks? Use o Zapier para automações rápidas sem código. Use webhooks quando precisar de mais controle, verificação de assinatura e processamento personalizado. A documentação de webhooks do Tally descreve payloads JSON enviados por POST, uma janela de resposta de 10 segundos, segredo de assinatura opcional e novas tentativas: [Webhooks](https://tally.so/help/webhooks). Próximos passos ---------------- Se você quer escalar a venda de fotos de eventos e o suporte, os campos ocultos são um jeito simples de fazer formulários externos parecerem “nativos”, porque o formulário já conhece o contexto. Combine isso com os fluxos de busca do [9Pic BibTrack](/pt-br/products/bibtrack/) e do [9Pic FaceFind](/pt-br/products/facefind/), encaminhe os envios do formulário para as suas ferramentas e mantenha sua equipe focada em atender os pedidos, não em idas e vindas. Pronto para começar? --------------------- Junte-se aos organizadores de eventos que já entregaram 100M+ fotos a 5M+ participantes em 5k+ eventos com a 9Pic AI para hospedagem, busca com IA e entrega de mídia. [Começar](https://admin.9pic.ai/sign-up) [Agendar demo](/pt-br/contact/)