Formulários públicos

Formulários são um aplicativo do site, não um recurso do núcleo. O dono liga o aplicativo por site, no painel; o padrão é desinstalado. Sem o aplicativo, o site não exibe formulários nem recebe envios.

Quem recebe o envio

O formulário é exibido e enviado pelo próprio site, no domínio dele. O envio anônimo do visitante não passa por api.canverly.com: é o site que repassa o envio ao serviço de formulários, identificando-se pelo domínio. Por isso não existe chave de API para “enviar um formulário”.

Ler os leads

Os envios viram leads, e um sistema externo os lê pela API de conteúdo com uma chave ck_ que tenha o escopo leads:read:

GET /v1/leads: lista paginada.
GET /v1/leads/{id}: um lead.

As duas rotas têm um limite próprio, mais baixo que o das outras (lead é dado pessoal). Detalhes, campos e exemplos em Leads.

Receber cada lead na hora

Para não precisar consultar a lista, configure um webhook: cada lead novo é entregue num endereço HTTPS seu, com assinatura HMAC.