
O básico
Mande nome, telefone, e-mail e o funil de destino. O contato entra na etapa que você indicar.
Os três detalhes que erram
1. Campo não declarado é descartado em silêncio. Se você mandar uma chave que o endpoint não conhece, ela some — com resposta de sucesso. Confira os campos aceitos na referência antes de integrar.
2. Campo personalizado vai pelo nome, não pelo identificador. A referência mostra isso no exemplo montado.
3. O tipo importa. Texto em campo numérico grava zero.
Não duplicar
O endpoint de criar-ou-atualizar casa por e-mail e telefone: contato que já existe é atualizado em vez de duplicado. É o que você quer em quase todo caso.
Quando o plano estoura
A resposta diz que o limite foi atingido, com o recurso que estourou. Não adianta repetir a chamada.
Quando a etapa trava
Se a etapa exige atividades concluídas, a resposta diz isso e lista as pendências. Não é falha temporária: a recusa não muda sozinha.