Cómo conectar WooCommerce con un CRM paso a paso

Si tienes una tienda en WooCommerce y quieres gestionar tus pedidos, clientes y facturas desde un solo sitio, conectar tu WC a un CRM es el primer paso. En esta guía te enseño cómo hacerlo en menos de 5 minutos, con capturas reales y solución a los errores más comunes.

Paso 1: Habilitar la API REST de WooCommerce

Por defecto, WooCommerce 6.0+ tiene la API REST v3 activada. No necesitas instalar nada. Solo tienes que generar credenciales.

En tu WordPress:

1. Ve a WooCommerce → Ajustes
2. Pestaña Avanzado (arriba a la derecha)
3. Sección API REST (menú lateral)
4. Pulsa "Añadir clave"

Paso 2: Configurar los permisos de la clave

En el formulario:

• Descripción: "Luma CRM" (para saber qué es luego)
• Usuario: tu usuario de admin (el CRM actúa en su nombre)
• Permisos: Lectura/escritura (read/write). Si solo pones lectura, no podrás cambiar estado de pedidos desde el CRM.

Pulsa "Generar clave API". WooCommerce te mostrará una sola vez:

• Consumer key: empieza por ck_
• Consumer secret: empieza por cs_

⚠ Importante: copia ambas claves ahora. WooCommerce no las vuelve a mostrar. Si las pierdes, tienes que generar unas nuevas.

Paso 3: Pegar claves en el CRM

En Luma CRM:

1. Inicia sesión en workspace.callzen.app
2. Ve a Configuración → Integraciones
3. Busca la card de WooCommerce
4. Rellena:
   • URL: https://tutienda.com (sin /wp-admin, sin barra final)
   • Consumer Key: pegas el ck_...
   • Consumer Secret: pegas el cs_...
5. Pulsa "Probar" — si sale "✓ Conexión correcta", está listo

Paso 4: Sincronizar datos

Pulsa "Sincronizar". En 30 segundos tienes:

• Todos los pedidos importados (configurable por cantidad)
• Clientes únicos creados automáticamente
• Productos y variantes cargados

A partir de ahí, cada vez que haya un pedido nuevo en WooCommerce, Luma lo importa automáticamente.

Errores comunes y solución

Error: "HTTP 401 Unauthorized"

Tus credenciales son incorrectas o los permisos son solo lectura y el CRM intenta escribir. Regenera las claves con permisos "Lectura/escritura".

Error: "Failed to fetch" o "NetworkError"

Tu dominio no es accesible desde internet. Si es un sitio de desarrollo local, no funciona. Si tu hosting bloquea requests desde servidores externos, contacta con soporte.

Error: "Respuesta no válida"

WooCommerce devuelve HTML en lugar de JSON. Suele pasar cuando:

• La URL es incorrecta (incluye /wp-admin por error)
• WordPress no tiene WooCommerce activado
• Un plugin de seguridad (WordFence) bloquea la API

Prueba acceder en tu navegador a https://tutienda.com/wp-json/wc/v3/ — debería devolver JSON.

Se sincronizan los pedidos pero no los productos

Verifica que tus productos en WC estén en estado "Publicado". Los borradores no se sincronizan.

¿Y si tengo WC + Shopify?

Luma soporta ambos a la vez en el plan Pro. Tienes un pedido unificado donde ves todos los pedidos juntos con una etiqueta que indica de qué plataforma viene.