WooCommerce

Conecta tu tienda WooCommerce para que el agente consulte pedidos, importa tu catálogo y mantén las existencias enlazadas.

Actualizado el 4 de noviembre de 20265 min de lectura

Con WooCommerce conectado, Orkestal puede:

Mostrar los pedidos de un cliente junto a su conversación, y dejar que el agente consulte el estado de un pedido.
Importar tu catálogo (productos y variaciones) a tu inventario.
Enlazar las existencias entre tu tienda y Orkestal.

Sobre los pedidos la integración es de solo lectura: Orkestal no cancela, reembolsa, cambia direcciones ni modifica pedidos en tu tienda. Lo único que Orkestal escribe en tu tienda son las existencias de un producto, y solo cuando tú las editas en tu inventario (mira Existencias).

Qué necesitas#

Tu tienda con HTTPS y acceso de administrador a WordPress.
Una clave de REST API de WooCommerce (Consumer Key ck_… y Consumer Secret cs_…). Con permiso de solo lectura funcionan los pedidos y la importación del catálogo; si quieres que las existencias que edites en Orkestal se reflejen en tu tienda, la clave necesita permiso de lectura y escritura.
Un secreto de webhook que inventas tú: mínimo 16 caracteres.

Conectar paso a paso#

1. Crear la clave REST en WooCommerce#

En WordPress: WooCommerce → Ajustes → Avanzado → API REST → Añadir clave. Elige el permiso (solo lectura, o lectura y escritura si quieres enviar existencias a tu tienda) y copia la Consumer Key y el Consumer Secret.

2. Conectar en Orkestal#

Ve a Integraciones → WooCommerce.
Completa URL de la tienda, Consumer key, Consumer secret y el secreto de webhook.
Elige la estrategia del inventario inicial (abajo).
Pulsa conectar. Orkestal valida las credenciales y las guarda cifradas. Verás «WooCommerce conectado».

3. Crear los webhooks en WooCommerce#

Tras conectar, la tarjeta muestra la URL de entrega. En WooCommerce: Ajustes → Avanzado → Webhooks, crea:

Webhook	Obligatorio
Order updated	Sí
Product updated	Sí
Order created	Opcional
Product created	Opcional

En cada uno, usa esa URL de entrega y exactamente el mismo secreto que escribiste en Orkestal. Los eventos de borrado no se usan.

4. Verificar#

Pulsa Verificar en la tarjeta y provoca una actualización de pedido de prueba. El indicador debe pasar de «Falta recibir el primer webhook firmado de la tienda» a «Webhook verificado recientemente».

Pedidos#

Al conectar, Orkestal importa los pedidos modificados en los últimos 90 días y después se mantiene al día con los webhooks.
Un pedido se vincula a un contacto solo si su correo o teléfono lo identifica de forma clara. Si el correo y el teléfono apuntan a contactos distintos, no se adivina.
En el chat del contacto aparece la tarjeta Pedidos de WooCommerce con número, estado, pago, artículos, método de envío y rastreo.

Lo que puede decir el agente#

El agente consulta los pedidos del contacto de esa conversación, nunca los de otra persona, y no recibe la dirección de entrega. Si no encuentra una coincidencia segura, no afirma que el pedido no existe: pide el número de pedido y ofrece pasar la conversación a una persona.

Importar tu catálogo#

Para que el agente venda tus productos de WooCommerce, importa el catálogo:

La importación corre sola la primera vez que se sincroniza la tienda, y la puedes repetir con Importar catálogo o Re-sincronizar catálogo.
Trae productos y variaciones a tu inventario, con la moneda de tu tienda.
Un producto sin SKU recibe uno sintético (WOO-<id>) para poder enlazarse.
No pisa lo que editaste a mano en Orkestal. Esos productos se cuentan como «conservados». Si quieres reemplazarlos con los datos de WooCommerce, la opción Reemplazar también los que edité a mano lo hace, y te pide confirmar.
Respeta el límite de productos de tu plan: lo que no cabe no se importa, y la pantalla te dice cuántos quedaron fuera.

Estrategia del inventario inicial#

Al conectar eliges qué pasa con las existencias de los productos que ya tenías:

Opción	Efecto
Vincular sin cambiar existencias	Enlaza productos por SKU sin tocar ninguna cantidad
Conservar existencias de WooCommerce	Orkestal toma como verdad las cantidades de tu tienda
Conservar existencias de Orkestal	Orkestal toma como verdad sus propias cantidades

Existencias y disponibilidad#

Los productos enlazados por SKU mantienen sus existencias alineadas según la estrategia que elegiste:

De tu tienda a Orkestal: si elegiste conservar las existencias de WooCommerce, los cambios de producto que llegan por el webhook actualizan tu inventario.
De Orkestal a tu tienda: cuando editas las existencias de un producto en Orkestal, la misma cantidad se envía a tu tienda (necesita una clave con permiso de escritura).

Cuando el stock llega a 0, el producto pasa a Agotado y el agente deja de ofrecerlo.

Con Envia.com#

Los pedidos sincronizados de WooCommerce son la fuente de las guías de rastreo para Envia.com.

Desconectar#

Desconectar elimina las credenciales y la bandeja de eventos de esa tienda en Orkestal. No borra los webhooks de WooCommerce: elimínalos desde tu tienda si ya no deben enviarse.

Problemas comunes#

Síntoma	Qué revisar
«No se pudo conectar WooCommerce»	Que la URL sea HTTPS y pública, y que las claves tengan permiso de lectura
Se queda en «Falta recibir el primer webhook firmado»	Que los webhooks usen exactamente la URL de entrega y el mismo secreto, y que estén activos
Un cliente no ve sus pedidos	Que su correo o teléfono en Orkestal coincida con los del pedido
Faltan productos tras importar	Revisa el resumen de la importación: pueden ser conservados por edición manual o excedentes del límite de tu plan
El stock que edité en Orkestal no cambia en la tienda	Que la clave REST tenga permiso de escritura y que el producto tenga el mismo SKU en ambos lados