Aprende mokapen

WooCommerce

Conecta tu tienda WooCommerce (WordPress) con Mokapen para llevar al CRM los clientes (contactos), los productos (con variaciones y stock) y los pedidos de la tienda, y para exportar hacia WooCommerce los productos creados o actualizados en Mokapen cuando la dirección de sync lo permita. Mismo objetivo que Shopify: unir e-commerce y gestión comercial en el mismo workspace.

Visión general: Integraciones. Los pedidos importados se convierten en pedidos de venta en Mokapen (módulo Pedidos), no en oportunidades de pipeline.

Requisitos

• Sitio WordPress con WooCommerce activo y accesible en HTTPS.
• Permiso para autorizar Mokapen mediante el flujo WC Auth (administrador WordPress / WooCommerce).
• Plan Mokapen Premium adecuado para las integraciones e-commerce. Sin plan, el botón de conexión abre la pantalla de upgrade.
• Permisos Mokapen sobre contactos, productos y pedidos en tu organización (consulta Roles y permisos).
• Acceso a Integraciones (miembro/admin según white-label y rol org).

Conectar la tienda WooCommerce

1. Menú de usuario → Integraciones → WooCommerce.
2. Introduce la dirección web de la tienda (URL del sitio, p. ej. https://tudominio.com). La encuentras en la barra de direcciones cuando estás en el backend WordPress / vitrina WooCommerce.
3. Inicia la autorización: serás redirigido a WordPress/WooCommerce a la página WC Auth (/wc-auth/v1/authorize) con scope read_write.
4. Acepta generar las claves API para Mokapen (consumer key / secret se guardan cifradas en Mokapen — no hay un formulario «pegar API key» manual).
5. Vuelve a Mokapen: la tienda queda conectada. Mokapen registra los webhook WooCommerce (/wp-json/wc/v3/webhooks) para recibir actualizaciones en tiempo real.

Si no aceptas la autorización, no se sincronizará ningún dato. La URL debe ser válida y en HTTPS: de lo contrario falla la validación.

Qué solicita Mokapen a WooCommerce

El flujo WC Auth concede a Mokapen acceso de lectura/escritura a las API REST WooCommerce necesarias para clientes, productos (y variaciones), pedidos y webhook. Mokapen no sustituye el panel WooCommerce/WordPress para temas, pagos o plugins: alinea los datos hacia (y, en el caso de los productos, desde) el CRM.

Si revocas las claves o desinstalas la autorización en WordPress, desconecta y vuelve a conectar desde Mokapen.

Qué se sincroniza

Hacia Mokapen (import / webhook)

• Clientes → Contactos — clientes WooCommerce en la libreta (y empresa si los datos lo permiten). Actualizaciones también vía webhook.
• Productos y variaciones → Productos — catálogo con variaciones; el stock WooCommerce (stock_quantity) se mapea a la cantidad de variante Mokapen.
• Pedidos → Pedidos — los pedidos WooCommerce se convierten en pedidos de venta en Mokapen (con líneas), no en deals de pipeline. Webhook en actualizaciones.
• Carritos abandonados / informes — menciones comerciales o entradas «Próximamente» en la UI no equivalen a un import de informes de carritos ya activo como en otros flujos: no los cuentes como funcionalidad completa si en la página siguen apareciendo como próximamente.

Hacia WooCommerce (export)

• Productos — con dirección sync «hacia WooCommerce» o «ambas», Mokapen puede exportar/actualizar productos en la tienda (sync bulk y sync-out al guardar producto, si la integración está activa).
• Contactos y pedidos de salida — como en Shopify, el export automático «sync out» implementado hoy afecta en la práctica a los productos. Los clientes llegan sobre todo desde WooCommerce hacia Mokapen (import + webhook). No des por hecho un export bidireccional completo de contactos solo porque el texto comercial lo sugiera: verifica tras la conexión.

En la config también aparece servicios, pero no hay una sync de servicios dedicada: para el catálogo de la tienda usa Productos.

Ajustes tras la conexión

En la página WooCommerce, con la tienda conectada:

Dirección sync

• Solo hacia Mokapen — WooCommerce → CRM.
• Ambas — import + export (donde esté soportado; hoy sobre todo productos de salida).
• Solo hacia WooCommerce — Mokapen → tienda (productos).

Entidades

Contactos, pedidos y productos son los ámbitos de sync (a menudo preseleccionados y no modificables desde la UI).

Compartir sync

Quien conectó puede compartir la conexión con toda la organización o usuarios seleccionados.

Duplicados y conflictos

• Evitar duplicados — normalmente reconocimiento de contactos por email.
• En caso de conflicto — prevalece WooCommerce o Mokapen.

Privacidad (WooCommerce)

A diferencia de Shopify, en la página WooCommerce también puedes encontrar controles de privacidad y colaboradores/stakeholder relacionados con cómo se ven en la org los datos sincronizados. Configúralos si el equipo no debe ver todo el catálogo/clientes importados de la misma forma.

Sync automática vs manual

Activa la sync automática para actualizaciones continuas (junto con los webhook); usa la sync manual para la carga histórica. Marca la autorización de datos en la página antes de sincronizar.

Flujo recomendado

1. Verifica HTTPS y WooCommerce actualizado en el sitio.
2. Conecta la tienda desde Integraciones → WooCommerce y completa WC Auth.
3. Establece dirección sync, duplicados, conflictos, privacidad (si aplica) y compartición.
4. Autoriza y lanza la primera sync.
5. Revisa Contactos, Productos (variaciones/stock), Pedidos en Mokapen.
6. Mantén activos los webhook para los nuevos eventos sin relanzar todo cada vez.

Desconectar

Desde Integraciones → WooCommerce → desconectar. En el modal elige si conservar en Mokapen contactos, pedidos y productos ya importados. Tras la desconexión los webhook ya no actualizan; los datos ya en el CRM permanecen si los conservaste. También puedes revocar claves/autorizaciones desde el panel WordPress.

Problemas frecuentes

• URL no válida / sin HTTPS — usa la dirección completa del sitio con https://.
• Autorización fallida — hace falta un admin WordPress; verifica que WooCommerce y los permalink REST funcionen (firewall/plugins de seguridad pueden bloquear WC Auth o los webhook).
• Botón bloqueado / upgrade — hace falta un plan Premium adecuado para e-commerce.
• Pedidos no en Oportunidades — es correcto: van en Pedidos (Ventas → Pedidos).
• Stock / cantidad — proviene de stock_quantity de las variaciones; no es un WMS completo.
• Webhook que no llegan — el sitio debe ser accesible desde internet; entornos locales o con basic auth a menudo no reciben las notificaciones WooCommerce.

Preguntas frecuentes

P: ¿Debo generar las API key manualmente en WooCommerce?

R: No. Usa el flujo WC Auth desde la página Integraciones Mokapen: las claves se crean y guardan al volver de la autorización.

P: ¿Los pedidos WooCommerce se convierten en oportunidades?

R: No. En Mokapen se convierten en pedidos de venta. Cualquier texto que hable de «oportunidades» es impreciso respecto al comportamiento actual.

P: ¿Puedo actualizar los productos WooCommerce desde Mokapen?

R: Sí, con dirección sync que incluya el export y la integración activa.

P: ¿Diferencia con Shopify?

R: Mismo modelo de datos (contactos, productos, pedidos) y misma lógica Premium e-commerce. Cambia la conexión: Shopify usa OAuth en la app Shopify; WooCommerce usa WC Auth en la URL de tu sitio WordPress. Consulta también la guía Shopify.

P: ¿Hace falta HTTPS?

R: Sí. Sin HTTPS la conexión y los webhook no son fiables (y la validación de URL puede fallar).