Integración con WooCommerce

Actualizado el 4 nov 20267 min de lectura
Español
En esta página

Conecta WooCommerce y verás el historial de pedidos de cada cliente en su conversación de Deskwoot. Los agentes ven pedidos, seguimiento, reembolsos y totales sin tener que ir al admin de WordPress. Lo configuras una sola vez con las claves de API de WooCommerce (Consumer Key + Secret). Las conversaciones de contactos que coinciden con un cliente de WooCommerce (por correo) se vinculan solas con sus pedidos. Disponible en todos los planes.

La integración con WooCommerce trae a la barra lateral de la conversación el historial de pedidos del cliente, los productos que compró y los datos de su cuenta, para que los agentes y el bot de IA respondan preguntas sobre pedidos con todo el contexto. Para configurarla usas una clave de API de WooCommerce que creas en el panel de administración de tu tienda. Tu equipo de soporte tiene todo el contexto sin cambiar de pestaña, y tu bot de IA puede usar los datos de los pedidos al responder a los clientes. Esta guía te explica la configuración, qué esperar una vez conectada y cómo resolver los problemas más comunes.

Crear las claves de API en WooCommerce

  1. En el admin de WordPress, ve a WooCommerce > Settings > Advanced > REST API.
  2. Haz clic en Add Key.
  3. Escribe una descripción (por ejemplo, Deskwoot Integration), elige un usuario con permisos de administrador y pon los permisos en Read/Write si tu equipo debe poder reembolsar y cancelar pedidos desde Deskwoot, o en Read si solo quieres ver los pedidos.
  4. Haz clic en Generate API Key.
  5. Copia enseguida la Consumer Key y el Consumer Secret. Solo se muestran una vez.

Consejo: Guarda las claves en un lugar seguro antes de cerrar la página. Si las pierdes, tendrás que crear un par nuevo.

Conectar en Deskwoot

  1. En Deskwoot, ve a Configuración > Integraciones > WooCommerce.
  2. Escribe la URL de tu sitio de WooCommerce (por ejemplo, https://yourstore.com), la Consumer Key y el Consumer Secret.
  3. Haz clic en Conectar.

Deskwoot comprueba la conexión enviando una solicitud de prueba a tu tienda. Cuando la confirma, los datos de pedidos y clientes empiezan a aparecer en tu espacio de trabajo.

Historial de pedidos en las conversaciones

Una vez conectada, la sección Pedidos de la pestaña Detalles de la conversación muestra los 10 pedidos más recientes del cliente, con el número de pedido, el estado, el total y la fecha. Haz clic en un pedido para ver los artículos, la dirección de envío y los datos de seguimiento (el seguimiento necesita el plugin gratis WooCommerce Shipment Tracking). Los pedidos se buscan por la dirección de correo del cliente. Con una clave Read/Write, la sección también ofrece Reembolsar, Cancelar pedido y Marcar como enviado.

Sincronización de datos de clientes

Deskwoot importa tus clientes de WooCommerce como contactos al conectar y después una vez al día, con nombre, correo, teléfono, empresa, ciudad y país, y total gastado. Estos datos completan los perfiles de los contactos y ayudan a los agentes a dar una atención personalizada.

Contexto para el bot de IA

Cuando el bot de IA está activado, recibe automáticamente el contexto de los pedidos del cliente actual. Así puede responder preguntas como “¿Dónde está mi pedido?” o “¿Qué pedí la última vez?” sin que intervenga un agente.

Cuando un visitante que no está verificado pregunta dónde está un pedido, Fynn le pide el número de pedido y el código postal de la dirección de envío (o de la dirección de facturación si el pedido no tiene dirección de envío). Esto funciona con todos los pedidos de tu tienda, también con los que se hicieron antes de conectarla: un pedido que Deskwoot todavía no guardó se consulta en vivo en WooCommerce. Si el número y el código postal no coinciden, Fynn le pide al cliente que revise los dos y luego le ofrece verificarlos por correo como alternativa. Fynn necesita Pedidos y transacciones (a través de Shopify/Stripe/WooCommerce) activado en Acceso a datos, en la configuración de los bots (Configuración > Bots).

Solución de problemas

  • La conexión falla al verificarla: Revisa que la URL de tu sitio incluya https:// y no termine en barra. Confirma que se puede acceder a la REST API y que ningún plugin de seguridad o regla del firewall la bloquea.
  • No aparecen pedidos en la barra lateral: Asegúrate de que la dirección de correo del cliente en la conversación sea la misma que la de su cuenta de WooCommerce. Los pedidos se buscan por correo, así que si no coinciden, faltarán datos.
  • Errores de permisos: Comprueba que la clave de API se creó con un usuario que tiene permisos de administrador. Para reembolsar y cancelar desde Deskwoot, los permisos deben estar en Read/Write.

Buenas prácticas

  • Usa una cuenta de usuario de WordPress solo para la clave de API, así puedes quitarle el acceso sin afectar a otras integraciones.
  • Elige Read si solo quieres ver los pedidos en Deskwoot. Elige Read/Write solo si tu equipo debe poder reembolsar, cancelar o marcar pedidos como enviados desde Deskwoot.
  • Revisa de vez en cuando tus claves de la REST API de WooCommerce y elimina las que ya no uses.

Preguntas frecuentes

¿Cuánto tardan los datos de los pedidos en aparecer en Deskwoot?
Los datos de los pedidos se cargan en tiempo real cuando se abre una conversación, así que los agentes siempre ven la información más reciente.
¿Mis datos de WooCommerce están seguros?
Deskwoot se comunica con tu tienda por HTTPS con las credenciales de API que le das. Las claves se guardan cifradas. Con una clave Read, la integración no puede hacer ningún cambio en tu tienda; con una clave Read/Write, tu equipo puede reembolsar, cancelar y marcar pedidos como enviados.
¿Cómo creo las claves de API de WooCommerce?
Admin de WordPress → WooCommerce → Settings → Advanced → REST API → Add key. Nivel de permiso Read/Write si tu equipo debe poder reembolsar y cancelar pedidos desde Deskwoot, Read si solo quieres ver los pedidos. Copia la Consumer Key + el Secret.
¿Qué datos aparecen en el panel de la conversación?
Los últimos 10 pedidos del cliente con estado, total, artículos, número de seguimiento e historial de reembolsos. Haz clic en un pedido para abrirlo y ver todos los detalles. Se ven en la sección Pedidos de la pestaña Detalles, en cada conversación de un contacto que coincide.
¿Los agentes pueden hacer reembolsos desde Deskwoot?
Sí, con una clave Read/Write. La sección Pedidos de la pestaña Detalles de la conversación tiene Reembolsar, Cancelar pedido y Marcar como enviado. Fynn también puede cancelar pedidos y hacer reembolsos cuando permites estas acciones en Fynn > Lo que Fynn puede hacer. Están desactivadas de forma predeterminada, y el bot primero verifica al cliente y le pide que lo confirme.
¿Sincroniza los datos de clientes en los dos sentidos?
Los datos de clientes solo van de WooCommerce a Deskwoot. Los cambios que haces en un contacto en Deskwoot no se envían de vuelta a WooCommerce. Las acciones de pedido (Reembolsar, Cancelar pedido, Marcar como enviado) sí cambian el pedido en tu tienda cuando usas una clave Read/Write.
¿Cómo relaciona Deskwoot un contacto con un cliente de WooCommerce?
Por correo. Mismo correo = misma persona. Si un cliente usó correos distintos (por ejemplo, uno para comprar y otro para soporte), aparece en registros separados. Combínalos en Deskwoot si hace falta.
¿Los pedidos anteriores aparecen justo después de conectar?
Sí. La sección Pedidos lee tu tienda en vivo, así que los pedidos que ya existen se ven enseguida. Al conectar, Deskwoot también registra webhooks de pedidos en tu tienda, para que los pedidos nuevos y los cambios lleguen en tiempo real.
¿Y si tengo varias tiendas de WooCommerce?
Un espacio de trabajo conecta una sola tienda de WooCommerce. Si conectas otra tienda, reemplaza a la actual y a sus pedidos.
¿El bot de IA puede usar los datos de los pedidos en sus respuestas?
Sí. El bot puede decir “Tu pedido #12345 se envió el...” como parte de su respuesta. Los datos de los pedidos están en el contexto del bot para los contactos que coinciden.
¿Funciona con WooCommerce Subscriptions?
Deskwoot lee los pedidos de WooCommerce. No lee las suscripciones en sí, así que no muestra el estado de una suscripción.
¿Y WooCommerce en un sitio de pruebas (staging)?
Cada instalación de WooCommerce (producción o staging) necesita su propia clave de API. Conecta la de producción para atender a tus clientes reales; la de staging casi nunca sirve, porque ahí no hay clientes reales.
¿En qué se diferencia de la integración con Shopify?
Funciona igual, pero en otra plataforma. WooCommerce funciona en tu WordPress; Shopify está alojado por Shopify. Del lado de Deskwoot todo es igual: contacto → panel de pedidos en la barra lateral de la conversación.

¿Te resultó útil esta guía?

Sigue leyendo

Preguntar a Fynn sobre esta guía

Recibe una respuesta corta basada en esta guía y el resto del centro de ayuda.

¿Aún necesitas ayuda?

Fynn responde en el chat con estas guías, y ahí también puedes hablar con el equipo.

Escríbenos por correo