Aprende mokapen

Shopify

Conecta tu tienda Shopify con Mokapen para llevar al CRM los clientes (contactos), los productos (con variantes y cantidades) y los pedidos de la tienda, y para exportar hacia Shopify los productos creados o actualizados en Mokapen cuando la dirección de sync lo permita. Sirve para unir e-commerce y gestión comercial: datos maestros, catálogo e historial de compras 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

• Tienda Shopify activa (URL que termina en .myshopify.com).
• Permiso para autorizar la app Mokapen en Shopify (OAuth) con una cuenta de administrador de la tienda.
• Plan Mokapen Premium adecuado para las integraciones e-commerce. Sin plan, el botón de conexión abre la pantalla de upgrade; en algunos flujos Shopify también puede proponer un cargo recurrente vinculado a la app.
• 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 Shopify

1. Menú de usuario → Integraciones → Shopify.
2. Introduce el nombre de la tienda (como en Shopify Admin; la URL completa termina en myshopify.com). Si no estás seguro, abre el panel de Shopify y mira la barra de direcciones del navegador.
3. Inicia la autorización: serás redirigido a Shopify para aceptar los permisos.
4. Acepta los scope solicitados (lectura/escritura de clientes y productos, lectura de pedidos — ver abajo).
5. Vuelve a Mokapen: la tienda aparece conectada. Si llegas desde la App Store de Shopify, puede que debas elegir la organización Mokapen en la que instalar la conexión.

Si no aceptas en Shopify, no se sincronizará ningún dato. Tras la conexión Mokapen registra los webhook en la tienda: así las actualizaciones de clientes, productos y pedidos pueden llegar en tiempo real, además de la sync bulk que lances tú.

Qué solicita Mokapen a Shopify

En la autorización OAuth Mokapen suele solicitar:

• read_customers / write_customers — leer (y potencialmente escribir) los clientes de Shopify.
• read_products / write_products — leer y actualizar productos/variantes.
• read_orders — leer los pedidos de la tienda.

Mokapen no sustituye el panel de Shopify para checkout, temas o pagos: alinea los datos hacia (y, en el caso de los productos, desde) el CRM. Si revocas la app desde Shopify o caduca el token, desconecta y vuelve a conectar desde Mokapen. Shopify también exige endpoints GDPR (solicitud de datos / redact): Mokapen los gestiona vía webhook.

Qué se sincroniza

Hacia Mokapen (import / webhook)

• Clientes → Contactos — los datos maestros de Shopify entran en la libreta; si hay datos de empresa pueden crearse/vincularse también la empresa. Webhook en create/update/delete de clientes.
• Productos y variantes → Productos — catálogo con variantes; la cantidad de inventario Shopify de la variante se mapea al campo cantidad de la variante Mokapen (no es un módulo de almacén separado).
• Pedidos → Pedidos — los pedidos Shopify se convierten en pedidos de venta en Mokapen (con líneas de artículo), no en deals de pipeline. Webhook en actualizaciones de pedido.
• Checkouts abandonados — en la sync puede existir un flujo de importación de checkouts abandonados de Shopify (como pedidos/datos relacionados). Los informes dedicados a carritos abandonados / analytics e-commerce en la página siguen apareciendo como Próximamente: no los cuentes como funcionalidad ya activa.

Hacia Shopify (export)

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

En la config la integración también lista los servicios, pero no hay una sync de servicios e-commerce dedicada como para los productos: usa Productos para el catálogo de la tienda.

Ajustes tras la conexión

En la página Shopify, con la tienda conectada, sueles configurar:

Dirección sync

• Solo hacia Mokapen — los datos parten de Shopify y entran en el CRM.
• Ambas — import + export (donde esté soportado; hoy sobre todo productos de salida).
• Solo hacia Shopify — envío desde Mokapen hacia la tienda (productos).

Entidades

Contactos, pedidos y productos aparecen como ámbitos de sync (a menudo ya seleccionados y no modificables desde la UI). La sync histórica y los webhook cubren estos tres bloques.

Compartir sync

Quien conectó la tienda puede permitir que otros miembros usen la misma conexión (toda la organización o usuarios seleccionados), para que no todos tengan que repetir OAuth.

Duplicados y conflictos

• Evitar duplicados — opción típica: contactos reconocidos por email, para no crear duplicados en la libreta.
• En caso de conflicto — elige si prevalece Shopify o Mokapen cuando el mismo registro fue modificado en ambos lados.

Sync automática vs manual

Con la sync automática activa, las actualizaciones (y los webhook) mantienen alineados los datos; puedes lanzar igualmente una sincronización manual para la carga histórica inicial. Antes de sincronizar marca la autorización de tratamiento/compartición de datos requerida en la página.

Flujo recomendado

1. Conecta la tienda y verifica Cuenta conectada.
2. Establece la dirección sync (en la mayoría de casos: Solo hacia Mokapen o Ambas si quieres actualizar los productos Shopify desde Mokapen).
3. Configura duplicados/conflictos y compartición.
4. Autoriza y lanza la primera sync (puede tardar en catálogos grandes).
5. Revisa en Mokapen: Contactos, Productos (variantes/cant.), Pedidos.
6. Mantén activos los webhook: los nuevos pedidos y actualizaciones de clientes/productos llegarán sin relanzar todo cada vez.

Desconectar

Desde Integraciones → Shopify → desconectar. En el modal puedes elegir si conservar en Mokapen los contactos, pedidos y productos ya importados, o gestionarlos según las opciones propuestas. Tras la desconexión los webhook dejan de actualizar; los datos ya en el CRM permanecen si elegiste conservarlos. También puedes revocar la app desde el panel de Shopify.

Problemas frecuentes

• Nombre de tienda no válido — usa el subdominio *.myshopify.com, no solo el dominio personalizado de la vitrina.
• Botón bloqueado / upgrade — hace falta un plan Premium adecuado para e-commerce.
• Pedidos no en Oportunidades — es correcto: van en Pedidos. Abre Ventas → Pedidos.
• Cantidad de producto — proviene de la cantidad de variante Shopify; no es un WMS completo.
• Informes de carritos / analytics — si en la página aparecen «Próximamente», aún no están operativos.
• Token caducado / sync parada — desconecta y vuelve a conectar; verifica que la app no haya sido desinstalada desde Shopify.

Preguntas frecuentes

P: ¿Dónde encuentro la URL de la tienda?

R: En la barra de direcciones del panel Shopify Admin: termina en myshopify.com.

P: ¿Los pedidos Shopify se convierten en oportunidades?

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

P: ¿Puedo actualizar los productos Shopify desde Mokapen?

R: Sí, con dirección sync que incluya el export y la integración activa: los productos (variantes) pueden enviarse/actualizarse en la tienda.

P: ¿Los contactos se actualizan también de Mokapen a Shopify?

R: El import y los webhook llevan los clientes Shopify al CRM. El export automático de contactos no es el flujo principal hoy (a diferencia de los productos): verifica en tu plan/entorno tras la conexión.

P: ¿Hace falta WooCommerce además de Shopify?

R: No: son dos integraciones e-commerce alternativas. Usa Shopify si la tienda está en Shopify; consulta la guía WooCommerce si usas WordPress/Woo.