Genera un plugin WordPress para sincronizar contactos con HubSpot CRM
El plugin oficial de HubSpot para WordPress es una buena base para trackear formularios y chat. Se queda corto cuando necesitas bidireccional, mapeo de propiedades custom, asociaciones de empresas por dirección de facturación o deals creados automáticamente desde tipos de pedido concretos. Los workarounds son: un addon de pago, una pipeline Zapier o escribir un plugin.
Un plugin HubSpot a medida mapea tus objetos WordPress al modelo de datos de HubSpot con las propiedades exactas que importan. Usamos Private Apps (sin dance OAuth), respetamos rate limits v3 (100 cada 10s) y encolamos escrituras para que una llamada lenta nunca ralentice el checkout WC.
¿Por qué generarlo en vez de instalar un plugin existente?
El plugin oficial HubSpot cubre formularios y tracking pero no expone toda la superficie de la API. Para cualquier flujo no trivial (link empresa→contacto, crear deals al pedido, actualizar lifecycle stage según user meta) vas solo.
Conectores tipo Zapier, Make, PieSync/Operations Hub van bien para volumen ocasional. Cuando WordPress es sistema de registro para 1000+ contactos se vuelven caros y lentos — cada sync es un viaje por su infra.
Mapeo de propiedades custom es donde rompen las integraciones genéricas. Las propiedades custom de HubSpot tienen nombres internos, tipos y validaciones que las herramientas generales no exponen bien. Un plugin escrito alrededor de tu schema específico lo maneja nativo.
Prompt de ejemplo
Este es el tipo de descripción que genera este plugin. Puedes partir de aquí y ajustar lo que necesites antes de generar.
Nombre del plugin: Acme HubSpot Sync
Autenticación: access token de Private App HubSpot (en wp_options autoload=no).
Reglas:
1. Alta usuario WordPress → contacto HubSpot con email, firstname, lastname, company, source=wordpress.
2. Pedido WC completado → deal HubSpot (pipeline="sales", stage="closedwon") con amount=total, dealname=número de pedido. Asocia contacto por email.
3. Cambio user meta "role" → actualiza propiedad "lifecyclestage" (customer / subscriber / evangelist).
Mapeo custom: UI admin para añadir filas (WP source → propiedad HubSpot).
Rate limiting:
- Respeta 100 req/10s por key.
- Encola; cron cada minuto drena 80 por tick.
- 429 → espera Retry-After + jitter.
Supresión por email. Saltar sync en pedidos test.
Admin: token, tabla de mapeo, botón "prueba", log últimos 20.
Compatible HPOS.Qué suele incluir el plugin generado
- Cliente HubSpot v3 con wp_remote_post y Bearer
- Clases servicio para Contacts, Companies, Deals con upsert idempotente por email
- Patrón de escritura encolada respetando 100/10s
- Manejo de 429 con Retry-After + jitter exponencial
- UI admin de mapeo y log de operaciones recientes
- Lectura pedidos HPOS-compatible
- Lista supresión + skip test-mode
Añade eventos timeline custom, asociar deals con companies, enriquecer contactos con Clearbit — cada uno es un hook.
Preguntas frecuentes
¿Necesito plan HubSpot de pago?
El free cubre Contacts API básica. Para Deals hace falta Sales Hub (Starter en adelante). El plugin va con lo que tu plan permita.
¿Qué es Private App vs OAuth?
Private Apps son tokens single-tenant que creas desde ajustes HubSpot. Más simple que OAuth (sin redirect), HubSpot lo recomienda para integraciones internas. Lo usamos exclusivamente.
¿Cómo se resuelven conflictos?
WordPress es fuente de verdad para contactos nuevos. Si hay conflicto (mismo email en HubSpot con empresa distinta), el plugin actualiza HubSpot con valores de WP salvo que añadas regla de merge en el prompt.
¿Es bidireccional?
Por defecto one-way WP → HubSpot. Si quieres que cambios en HubSpot vuelvan, añadimos webhook receiver escuchando contact.propertyChange. Descríbelo en el prompt.