Um webhook é uma URL própria da sua organização que aceita dados e cria um contato. É o
caminho mais direto para ligar o formulário do seu site ao funil, e o que resolve
qualquer integração sob medida sem escrever código do lado de cá.
Referência completa da API
Formatos aceitos, respostas, códigos de erro e exemplos em várias linguagens.
Criar um webhook
Abra Configurações → Integrações → Webhooks
A tela lista os webhooks existentes, com o contador de contatos recebidos por cada
um.
Dê um nome que diga a fonte
“Formulário do site”, “Landing de black friday”. O nome aparece no histórico, e
daqui a seis meses é ele que vai explicar de onde vieram aqueles contatos.
Escolha o tipo
Genérico aceita qualquer JSON ou formulário HTML. Typeform entende o formato
que o Typeform envia e mapeia as respostas por tipo de campo.
Ligue uma origem, se quiser
O webhook pode ter uma origem fixa. Assim todo contato que entra por ele já nasce
ligado à origem certa, sem depender do que o sistema de fora manda.
Copie a URL
Ela tem esta forma, com um token único de 48 caracteres: Enviar dados
O endereço aceita application/json, application/x-www-form-urlencoded e
multipart/form-data, o que significa que um formulário HTML pode apontar direto para
ele, sem nenhum código no meio.
Os nomes de campo são reconhecidos em português e em inglês, com as variações mais
comuns. A lista completa está em Campos aceitos.
Testar a conexão
Uma requisição GET na mesma URL diz se o webhook existe e está ativo, sem criar
contato nenhum:
Segurança do token
O token identifica a sua organização, então quem o tem pode criar contatos nela.
Não coloque o token em código que roda no navegador de um site público. Um formulário
HTML apontando direto para a URL é aceitável, porque o pior que alguém faz é criar
contatos falsos; um token em JavaScript de página pública é convite para isso
acontecer em escala.
O que acontece depois que o contato entra
O email é validado, o contato é criado na etapa de entrada, atribuído ao primeiro
dono ou administrador ativo, ligado à origem quando o nome bate com uma cadastrada, e
uma notificação e uma entrada no histórico são criadas. As automações de contato criado
disparam a partir daí. 
