AdSpirit Connector releases
AdSpirit Connector — plugin WordPress que conecta sites ao CRM AdSpirit (Digitals). CF7 + telemetria + anti-spam + CAPI + GA4 + behavior tracking.
by Agência Digitals · github.com/agencia-digitals/digitals-wp-connector · website
Install
The author publishes release zips, so WP-CLI can install straight from GitHub:
wp plugin install https://github.com/agencia-digitals/digitals-wp-connector/releases/download/v2.79.0/adspirit-connector-v2.79.0.zipReadme
AdSpirit Connector — v2.29.0
Plugin WordPress que conecta o site ao CRM AdSpirit da Agência Digitals. Um único pacote cobre captura de leads, anti-spam, tracking/atribuição e conversões server-side, tudo configurado pelo wp-admin (menu AdSpirit).
O que faz
- Captura de leads multi-fonte — Contact Form 7 (hook
wpcf7_before_send_mail, priority 99: captura ANTES do envio do e-mail, então o lead não se perde se o SMTP falhar), Gravity Forms, WPForms, Elementor Forms, Fluent Forms, WooCommerce (order → deal), shortcode[adspirit_form]com builder visual no admin, e o qualifier. - Rede de segurança (Lead Store) — todo lead é gravado na tabela local
{prefix}adspirit_submissionsANTES de qualquer chamada externa. Dispatch pro CRM é blocking e o status reflete a resposta real (2xx=sent · 4xx/5xx=failed · timeout=pending). Cron re-POSTa pending/failed com backoff (15min/1h/6h/24h, máx 5 tentativas). Reenvio manual (unitário e em massa) na aba Submissões. - Qualificação multi-step —
[adspirit_form_qualifier]: form BANT em etapas (roteiro por marca vindo do CRM), modos popup/inline/embed/trigger,form_step_viewpor etapa pro dataLayer, redirect por perfil retornado pelo CRM. - Anti-spam em camadas com quarentena — honeypot, time-trap, rate-limit por IP, User-Agent check, reverse text trap, blocklist regex; opcionalmente Cloudflare Turnstile invisível (fail-open em erro de rede). Bloqueio vira status
spamcom motivo na aba Submissões — revisável e resgatável pelo Reenviar (TTL 30d). - Tracking e atribuição — pixel do CRM injetado no
<head>(opt-in; opcionalmente servido de path first-party via proxy com cache, anti ad-blocker), telemetria server+client no payload, e atribuição first + last touch em cookies first-party (adspirit_ftnunca sobrescrito,adspirit_ltatualizado a cada visita com UTM; 90d), injetada como hidden fields no submit. - Conversões server-side — Meta CAPI (Graph API;
event_id= submission_id pra dedupe com o pixel browser) e GA4 Measurement Protocol v2 (generate_lead,page_view). Shortcode[adspirit_thank_you]dispara ambos na página de obrigado com redirect. - Eventos automáticos —
tel_click,email_click,whatsapp_click(+generate_lead) efile_downloadpro dataLayer, via arquivo JS versionado. - Testes A/B — variantes de
[adspirit_form]com cookie sticky 90d, divisão automática com pesos, vencedora manual ou automática, arquivamento preservando números. - Widget de leads no painel WP — leads do mês, por origem, pendentes, com deep-link pro CRM (read-only, fail-soft, só admin conectado).
- Extras — cross-domain link decoration (
?dos_vid=), webhook out genérico, Customer.io e Mailchimp passthrough, CSV export, Schema.org LD+JSON, dedup local 60s, Site Health, WP-CLI (wp adspirit test|safe-mode|logs), widget/popup de WhatsApp, log de submissões local.
Instalação
- Baixe o ZIP em GitHub Releases ou em
public/downloadsdo CRM (mesmo zip servido pelo manifest). - wp-admin → Plugins → Adicionar novo → Enviar plugin → ZIP → Instalar → Ativar.
- Conecte por um dos dois caminhos:
- Click-to-Connect: AdSpirit → Conexão → "Conectar ao AdSpirit" → loga no CRM, autoriza, credenciais (brand_slug, secret, pixel_token, endpoint) gravadas automaticamente.
- Magic Install: operadora gera token no CRM (
/install-wp) e entrega o linkwp-admin/?adspirit_token=XYZ; o plugin redime o token (single-use) e já conecta com CF7 + pixel ativos.
Updates: updater próprio, dual-source — consulta o manifest hospedado no CRM ({endpoint}/downloads/manifest.json) e o GitHub Releases, e oferece a maior versão das duas. A partir da 2.28 o plugin se auto-opta no auto-update nativo do WP (a frota se mantém sozinha; escape pelo filtro adspirit_connector_auto_update). Não usa plugin-update-checker externo.
Arquitetura em um parágrafo
O boot carrega primeiro a camada de segurança (Safe Bootstrap + Crash Tracker + Safe Hook): todo callback de hook roda em try/catch, fatais são capturados em register_shutdown_function, e ≥3 crashes do plugin em 5min ativam Safe Mode automático — features desligam, a UI de admin continua acessível, o site fica intocado. A captura é entry-first: validar → record_pending() no Lead Store → dispatch externo → mark() por integração; se o insert local falhar, o envio segue mesmo assim (integridade nunca bloqueia lead). Todo POST pro CRM — qualifier, form nativo, adapters, Woo — passa pelo dispatcher canônico (Lead_Store::dispatch_to_crm + mark_crm_attempt); o retry do cron re-POSTa só pro CRM, reusando o submission_id original — fanout/CAPI/GA4 rodam UMA vez, no submit original, nunca no retry.
Avisos de operação (leia antes de prometer qualquer coisa a cliente)
LGPD — consentimento IMPLÍCITO. O banner é informativo, com um único botão ("Entendi"); scroll/clique/navegação registram adspirit_consent=accept_all. Não há opção de recusa nem categorias granulares, então na prática Pixel, CAPI, GA4 e telemetria sempre rodam — os únicos módulos cujo gate de consent tem efeito real são Behavioral e Clarity. O eixo LGPD completo (recusa real, gates efetivos, retenção configurável, export/erase) foi despriorizado por decisão (2026-08-17) e está no ROADMAP como futuro.
Ritual de release (deploy do CRM antes do release do plugin):
- Bumpar a versão em 2 lugares: header
Version:e constanteADSPIRIT_CONNECTOR_VERSIONemdigitals-connector.php. bash build.sh— geradist/adspirit-connector-v{X}.zip(zip anterior preservado emdist/oldpra rollback).- Criar o GitHub Release com o zip e sincronizar zip +
manifest.jsonempublic/downloadsdo repo do CRM. Os dois canais precisam andar juntos: o updater pega a maior versão dos dois, e quando o repo virar privado o manifest vira a única fonte viva.
Paredes-mestras (contratos que NUNCA mudam)
Quebrar qualquer um destes quebra sites em produção ou o dedup do CRM:
- Chaves canônicas do payload (
your-name,your-email,Telefone,empresa, …) — contrato com o webhook do CRM; defaults sincronizáveis via/api/wp/field-mapping. - *Headers `x-cf7-
** (x-cf7-secret,x-cf7-submission-id`) — autenticação e identidade da submissão. submission_idreusado no retry/reenvio — é o que faz o CRM promover/atualizar o lead em vez de duplicar.- Slug da pasta no ZIP:
adspirit-connector— o WP deriva a identidade do plugin (e o caminho de update) do nome da pasta. Não renomear.
Contexto completo e cicatrizes de incidente: doc "Paredes-Mestras" (galeria de artifacts). Backlog: ROADMAP.md.
Licença
Proprietário — Agência Digitals.
Read the full README on GitHub →
Releases
| Tag | Published | Asset | Downloads |
|---|---|---|---|
| v2.79.0 | Sep 4, 2026 | adspirit-connector-v2.79.0.zip | 9 |
| v2.78.0 | Sep 2, 2026 | adspirit-connector-v2.78.0.zip | 10 |
| v2.77.0 | Sep 2, 2026 | adspirit-connector-v2.77.0.zip | 0 |
| v2.76.0 | Sep 1, 2026 | adspirit-connector-v2.76.0.zip | 10 |
| v2.75.0 | Sep 1, 2026 | adspirit-connector-v2.75.0.zip | 6 |
| v2.74.0 | Sep 1, 2026 | adspirit-connector-v2.74.0.zip | 0 |
| v2.73.0 | Sep 1, 2026 | adspirit-connector-v2.73.0.zip | 0 |
| v2.72.0 | Sep 1, 2026 | adspirit-connector-v2.72.0.zip | 2 |
| v2.71.0 | Aug 31, 2026 | adspirit-connector-v2.71.0.zip | 6 |
| v2.70.0 | Aug 31, 2026 | adspirit-connector-v2.70.0.zip | 1 |
| v2.69.0 | Aug 31, 2026 | adspirit-connector-v2.69.0.zip | 0 |
| v2.68.0 | Aug 31, 2026 | adspirit-connector-v2.68.0.zip | 5 |
| v2.67.0 | Aug 31, 2026 | adspirit-connector-v2.67.0.zip | 0 |
| v2.66.0 | Aug 30, 2026 | adspirit-connector-v2.66.0.zip | 6 |
| v2.65.0 | Aug 30, 2026 | adspirit-connector-v2.65.0.zip | 1 |
| v2.64.1 | Aug 29, 2026 | adspirit-connector-v2.64.1.zip | 6 |
| v2.64.0 | Aug 29, 2026 | adspirit-connector-v2.64.0.zip | 1 |
| v2.63.0 | Aug 28, 2026 | adspirit-connector-v2.63.0.zip | 6 |
| v2.62.0 | Aug 28, 2026 | adspirit-connector-v2.62.0.zip | 1 |
| v2.61.0 | Aug 28, 2026 | adspirit-connector-v2.61.0.zip | 1 |
| v2.60.0 | Aug 28, 2026 | adspirit-connector-v2.60.0.zip | 1 |
| v2.59.0 | Aug 28, 2026 | adspirit-connector-v2.59.0.zip | 5 |
| v2.58.1 | Aug 27, 2026 | adspirit-connector-v2.58.1.zip | 0 |
| v2.57.1 | Aug 27, 2026 | adspirit-connector-v2.57.1.zip | 1 |
| v2.57.0 | Aug 27, 2026 | adspirit-connector-v2.57.0.zip | 1 |
Active-site estimate ≈10 comes from the v2.78.0 cohort. Method.