Capturando leads do seu site

Todo board tem uma fase de formulário (a primeira coluna, de order 0). Os campos dela podem ser preenchidos publicamente — sem token, sem login — através dos endpoints de formulário público. É o jeito mais simples de transformar o formulário do seu site em cards no CRM.

Opção 1: link do formulário pronto

O Perpetuus já gera uma página de formulário para cada board. Em Board → Fase de formulário → Compartilhar, copie o link e use direto ou dentro de um iframe no seu site.

Opção 2: formulário próprio no seu site

Se você quer manter o visual do seu site, envie os dados direto para a API pública:

<form id="lead-form">
  <input name="name" placeholder="Nome" required />
  <input name="email" placeholder="E-mail" type="email" />
  <input name="phone" placeholder="WhatsApp" />
  <button>Quero saber mais</button>
</form>

<script>
  const BOARD_ID = 'SEU_BOARD_DOCUMENT_ID';

  document.getElementById('lead-form').addEventListener('submit', async (e) => {
    e.preventDefault();
    const dados = Object.fromEntries(new FormData(e.target));

    await fetch(`https://api.perpetuus.com.br/api/boards/${BOARD_ID}/public-form`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ fields: dados }),
    });

    e.target.innerHTML = '<p>Recebemos seu contato! 🎉</p>';
  });
</script>

Os nomes dos inputs devem corresponder aos slugs dos campos do formulário do board. Para descobrir a estrutura (campos, obrigatoriedade, textos), consulte:

curl "https://api.perpetuus.com.br/api/boards/SEU_BOARD_ID/public-form"

Rastreamento de origem

O formulário público aceita campos de rastreamento junto ao envio — fbclid, gclid e UTMs — que ficam anexados ao card. Assim você sabe de qual campanha veio cada lead.

Uploads

Campos do tipo arquivo usam o endpoint POST /boards/{boardId}/public-upload (multipart). Veja os detalhes na API Reference.

Dica

Combine com automações para notificar o time no WhatsApp ou atribuir um responsável automaticamente a cada lead que chegar.