Formulário que pessoas e agentes preenchem, com entrega garantida

Um formulário no site existe para que a resposta chegue a quem precisa dela. O problema é que, muitas vezes, ela não chega. O sistema que recebe está fora do ar, recusa a chave ou devolve erro, e a pessoa que preencheu já foi embora. O Forms existe para que isso não aconteça. Ele recebe a resposta, assina o evento e entrega aos destinos que a conta escolheu. Se o destino recusa, a entrega espera na fila em vez de desaparecer.

Como o formulário chega ao site

Você copia uma linha para a página, com o código do formulário, e ele aparece no lugar. O script desenha o formulário como um componente próprio, sem dependências, e herda a fonte e a cor do texto da página. Se você não tem site, existe um link pronto para compartilhar. O formulário também pode ser limitado a até 20 domínios, conferidos pela origem do pedido.

O que acontece quando alguém responde

Cada resposta guarda os valores, a página de onde veio, a versão do formulário que a pessoa viu e a origem. A origem vem de campos ocultos preenchidos pelo endereço da página: utm_source, utm_campaign e o link curto que trouxe a pessoa. Com isso, você sabe qual anúncio ou post gerou a resposta.

Essa resposta vira um evento no formato Standard Webhooks, com cabeçalhos próprios (prefixo x-ccm). Seu servidor confere a assinatura com a chave do destino, recusa timestamps com mais de cinco minutos e ignora um identificador já visto. Cada destino recebe só os eventos que a conta escolher, e pode ser desligado por formulário.

Quando o destino recusa

Toda entrega começa como uma linha numa caixa de saída. Se o destino falha, o Forms tenta de novo em 1 minuto, 5 minutos, 30 minutos, 2 horas e 12 horas. Depois disso, a entrega fica parada para reenvio manual.

Há um caso à parte. Se o destino responde 401 ou 403, a entrega não gasta tentativa: ela fica retida, com um teste por hora. Quando você troca o segredo do destino, as entregas retidas voltam para a fila. Só o 410 é definitivo. O reenvio usa o mesmo identificador do evento, então o seu sistema não processa a mesma resposta duas vezes.

Agentes preenchem pelo MCP

Além de pessoas, um agente pode preencher o formulário pelo servidor MCP do Forms, com o login da conta. A resposta sai marcada como enviada por agente, com o nome dele. Há um limite de cinco respostas por hora por conta, cliente e formulário.

Um agente nunca dá consentimento em nome de uma pessoa: uma resposta de agente com a caixa de consentimento marcada é recusada. Criar, alterar ou publicar um formulário pelo MCP vira um pedido de aprovação, que uma pessoa aprova no painel. Apagar uma resposta só pode ser feito por uma pessoa, e essa ação não é registrada no MCP.

Robôs barrados sem captcha

O formulário usa três barreiras que não pedem nada da pessoa. Há um campo escondido que só robôs preenchem. Há um tempo mínimo de três segundos entre abrir e enviar. E há um limite de cinco envios por hora por endereço, por formulário. O bloqueado vê a mesma mensagem de sucesso, e o bloqueio fica registrado por 30 dias para revisão. Uma pessoa pode aceitar um bloqueio como resposta, sempre sem consentimento.

Perguntas frequentes

Quem pode preencher um formulário?

Qualquer pessoa com acesso à página, e também agentes autorizados pelo MCP. Nada obriga a conta a usar um dos dois sozinho.

Dá para fazer lógica condicional entre perguntas?

Não. Não há lógica condicional: as perguntas são sempre as mesmas, não aparecem nem somem conforme a resposta anterior. O formulário também não recebe envio de arquivo. São sete tipos de campo e até 40 campos por formulário.

O que é salvo sobre o IP de quem respondeu?

Só um hash e o começo do endereço para exibir. O endereço completo nunca fica em claro.

Apagar uma resposta apaga tudo?

Apaga a resposta, a prova de consentimento e as entregas que ainda estavam pendentes. Fica um registro anônimo de que algo foi apagado.

Para continuar lendo

• Como saber até onde cada post do blog foi lido

• Newsletter só para quem confirmou: por que a dupla confirmação importa

• Link curto que mostra qual post trouxe cada clique

Quando a resposta precisa chegar

O formulário só serve se a resposta chegar ao sistema que a espera, mesmo quando esse sistema falha por um momento. O Forms mantém cada entrega na fila até o destino aceitá-la, com a origem e a prova que você precisa. Para conhecer o produto, veja Conhecer o Forms.

Fontes

• Referência do Forms para pessoas e agentes (llms.txt)

• Página do Forms