ID do formulário

Carrd

Aponte um formulário personalizado do Carrd para o Ikiform com Send to URL no Pro Plus, ou cole um formulário HTML em um elemento Embed no Pro Standard.

Os formulários de contato e de inscrição do Carrd mandam os envios para os destinos do próprio Carrd. Formulários personalizados no Pro Plus podem enviar para qualquer URL, que é tudo de que o Ikiform precisa, e o Pro Standard pode incorporar o seu próprio HTML.

Plano do CarrdComo conectar o Ikiform
Pro Plus ou superiorUm elemento Form do tipo Custom > Send to URL. Sem código.
Pro StandardUm elemento Embed com o seu próprio formulário HTML
Pro Lite e gratuitoNenhum dos dois. Esses planos não têm embeds nem formulários personalizados.

Formulário personalizado com Send to URL

  1. Crie o formulário

    Clique em Add Element > Form e defina Type como Custom, depois Send to URL.

  2. Defina a URL, o método e o formato

    URL
    https://ikiform.com/f/frm_xxxxxxxxxxxxxxxx
    ConfiguraçãoValorPor quê
    MethodAJAXMantém os visitantes na página. O Carrd entende qualquer 2xx como sucesso, e o Ikiform responde 201 quando armazena o envio.
    FormatDefaultFaz um POST de formulário padrão. JSON também funciona.
    HeadersNenhumO Ikiform não precisa de headers vindos de um navegador.

    Com POST em vez de AJAX, o navegador sai do seu site Carrd para a página de agradecimento do Ikiform ou para a sua URL de Redirect after submit, e a configuração On Success do Carrd não se aplica. Não escolha XML: o Ikiform o recusa com 415 unsupported_media_type.

  3. Defina os IDs dos campos

    O Submitted ID de cada campo, ou o ID quando ele está vazio, vira o nome do campo no Ikiform. O Carrd gera IDs a partir dos rótulos, então defina-os você mesmo: email, name, message. Com Format definido como JSON, um Submitted ID como fields.firstname é enviado como objeto aninhado, que o Ikiform armazena como está.

    • Não adicione um campo File. O Ikiform ainda não aceita arquivos e recusa o envio com 422 files_not_supported.
    • Collect UTM parameters adiciona utm_source, utm_medium, utm_campaign, utm_term e utm_content. Se você definir campos no Ikiform, adicione esses também, ou o envio falha com um erro de campo desconhecido.
    • Um campo Hidden sempre tem o valor predefinido, então não serve como honeypot. A pontuação de spam continua rodando em todo envio.
  4. Escolha On Success e On Failure

    Escolha o que o Carrd mostra depois da requisição. On Failure cobre todos os erros do Ikiform, como 422 validation_failed ou 429 rate_limited; o Carrd não exibe a mensagem do Ikiform, então mantenha seu texto de falha genérico.

Deixe a verificação de spam do formulário desativada. Envios AJAX não conseguem mostrar a página de verificação do Ikiform, então um formulário com a verificação ativa responde 403 challenge_required e o Carrd mostra On Failure toda vez.

Elemento Embed no Pro Standard

Clique em Add Element > Embed, defina Type como Code e Style como Inline, e cole um formulário. Embeds não são renderizados no construtor, então publique para vê-lo.

Embed
<form action="https://ikiform.com/f/frm_xxxxxxxxxxxxxxxx" method="post" target="_top">
  <input name="email" type="email" placeholder="Email" autocomplete="email" required>
  <input name="_gotcha" type="text" tabindex="-1" autocomplete="off" hidden>
  <button type="submit">Join the waitlist</button>
</form>

Isto envia como um formulário normal, então a verificação humana funciona se você ativá-la. Estilize com um bloco <style>, ou comece pelo embed para criadores de sites, mais completo.

Domínios permitidos

Nas duas opções, o navegador envia a partir da sua página do Carrd, então os domínios permitidos funcionam normalmente.

Onde o formulário rodaAdicione em Allowed domains
URL gratuita ou padrãoyour-site.carrd.co
URL sem marca do Proyour-site.crd.co
Domínio próprioexample.com, que também cobre www.example.com
  • Nunca adicione carrd.co ou crd.co sozinhos. Todo site naquele host corresponderia, inclusive os de outras pessoas.

Checklist de teste

  1. Publique o site. Formulários e embeds só funcionam no site publicado.
  2. Envie o formulário e confirme que o Carrd mostra a sua mensagem de On Success, ou que o embed leva à página de agradecimento.
  3. Abra o envio no Ikiform e confira se os nomes dos campos são os IDs que você definiu, e não os gerados.
  4. Envie com um e-mail inválido enquanto o formulário tem campos definidos e confirme que o Carrd mostra On Failure.

Solução de problemas

O que você vêPor quêCorreção
O Carrd mostra On Failure em todo envioO Ikiform recusou o envio: 415 para XML, 422 para um campo desconhecido ou um arquivo, 403 challenge_required com a verificação ativa, ou 403 origin_not_allowed com RejectUse o formato Default, faça os IDs dos campos corresponderem, remova campos File, desative a verificação e adicione o seu domínio.
Os nomes dos campos no Ikiform parecem os rótulos, não os seus IDsSubmitted ID e ID ficaram vaziosDefina os IDs e publique de novo.
Os envios chegam no filtro de spam com origin_mismatchA página que enviou não está nos domínios permitidos do formulárioAdicione o host da tabela acima. Com Reject escolhido, os mesmos envios recebem 403 origin_not_allowed.
O embed fica em branco no construtorO Carrd não roda o código de embeds no construtorPublique e confira o site no ar.