Insider for Gravity Forms
Add-on do Gravity Forms que manda os leads para a Insider pela API de upsert, direto do servidor. Cada formulário tem o seu feed, mapeado no painel do WordPress, sem código.
- Papel
- Autor
- Onde
- Open source (GPL-2.0)
- Período
- 09/2026 – 10/2026
- Stack
- PHP · WordPress · Gravity Forms · API da Insider
Desafio
Os leads do site precisam chegar à Insider no mesmo perfil que o back-end já cria para a pessoa. Se o envio depende do navegador, um redirecionamento na confirmação ou um bloqueador de anúncios pode derrubar o lead no caminho.
- Se o site manda o documento em uuid e o back-end manda um id interno, a Insider guarda duas pessoas.
- Sem pelo menos um identificador, a Insider não cria o contato.
- Evento ou parâmetro que não existe no painel da Insider é descartado na chegada.
Abordagem
Escrevi um add-on de feed para o Gravity Forms. No feed de cada formulário, escolho pelo painel qual campo vira e-mail, telefone, nome, identificador e parâmetro do evento. O envio sai do servidor, pela API de upsert, no formato que o back-end usa.
- Os valores vêm da entrada salva, então formulário de várias páginas manda todos os campos.
- Telefone sai em E.164: (11) 90000-0000 vira +5511900000000.
- Número vai como número (15000, não "15000"). Com zero à esquerda, como 01310, fica texto.
- O CPF vai em identifiers.custom, sem pontuação.
Resultado
Foram sete versões entre 16 de setembro e 7 de outubro de 2026. Cada uma resolveu um problema concreto: a chave da API que recusava IPv6, a recusa que voltava com status 200, o SDK que travava a thread principal.
- Envio com falha vira nota na entrada, com o status e a resposta da Insider.
- A entrada ganha um link para o perfil do contato no painel da Insider One.
- As regras de conversão não dependem do WordPress e têm teste próprio.
- Instala pelo .zip da release ou pelo Composer.
php tests/test-payload.php
ok