# WooCommerce

Conecta tu tienda WooCommerce para que el agente consulte el estado de los pedidos por teléfono, cree pedidos con enlace de pago y responda desde tu catálogo

> Full REST + WebSocket API reference: https://api.happ.tools/reference

WooCommerce se conecta con una clave que tu tienda emite a HAPP después de que la apruebes en tu propio sitio. Una vez vinculado, el agente encuentra los pedidos recientes de un comprador por su número de teléfono, crea pedidos nuevos con enlace de pago y responde preguntas sobre productos desde tu catálogo, incluido "¿tenéis esto?" con una foto.

## Qué puede hacer el agente [#what-the-assistant-can-do]

* **Estado del pedido por teléfono**: encuentra los pedidos del comprador por el teléfono usado al pagar y le indica el número de pedido, el estado, los artículos, el total y el número de seguimiento cuando tu tienda lo registra.
* **Crear un pedido**: crea un pedido en WooCommerce con el estado **Pending payment**, los productos y opciones elegidos (talla, color), el nombre, el teléfono y la dirección de entrega del comprador, y le envía el enlace de pago de ese pedido.
* **Respuestas del catálogo**: conoce tus productos publicados con precios, variaciones y estado de stock, y encuentra un producto a partir de una foto que envía el comprador.

## Antes de empezar [#before-you-start]

* **Tienda WooCommerce** en WordPress, servida por **HTTPS**.
* **Cuenta de administrador de WordPress**: apruebas el acceso con la sesión iniciada.
* **Espacio de trabajo de HAPP** con al menos un agente configurado para hablar con clientes.
* **WooCommerce activado para tu espacio de trabajo**: la integración se activa por empresa. Pide al soporte de HAPP que la active.

No hace falta instalar ningún plugin.

## Conectar [#connect]

1. Inicia sesión en el panel de WordPress en el mismo navegador.
2. En HAPP abre **Integraciones** y busca WooCommerce en **Añadir un CRM**.
3. Haz clic en **Conectar** e introduce la dirección de tu tienda: sirven tanto `your-store.com` como el enlace de wp-admin.
4. Tu tienda abre la pantalla "HAPP would like to connect to your store" con acceso **Read/Write**. Haz clic en **Approve**.
5. Vuelves a **Integraciones** con WooCommerce en **Mis integraciones**.

La clave que recibe HAPP puede leer productos, clientes y pedidos, y crear pedidos. Puedes verla y revocarla en **WooCommerce > Settings > Advanced > REST API**.

## Configuración [#settings]

Abre el icono de engranaje de la tarjeta en la pestaña **Integraciones** del agente y activa lo que el agente puede hacer.

* **Buscar**: estado del pedido por el teléfono del comprador.
* **Crear**: pedidos pendientes de pago con enlace de pago.
* **Catálogo**: búsqueda de productos por texto y por foto. La primera sincronización tarda unos minutos; después, el catálogo se actualiza cada 6 horas. Solo se sincronizan los productos publicados, hasta 5000.

## Límites [#limits]

* Los pedidos se crean como **Pending payment**; WooCommerce los avanza cuando el comprador paga.
* La búsqueda por teléfono acepta los formatos habituales (`050 111 22 33`, `+380501112233`, `0501112233`). Si nada coincide, el agente revisa tus últimos 100 pedidos.
* El número de seguimiento solo aparece si tu tienda lo guarda con un plugin: WooCommerce Shipment Tracking o un plugin de transportista que guarde el albarán (TTN).

## Solución de problemas [#troubleshooting]

| Problema                                                 | Causa                                                                   | Solución                                                                        |
| -------------------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| "Enter the store address as https\://…"                  | La dirección no es HTTPS o no es un sitio público                       | Usa la dirección `https://` de tu tienda.                                       |
| "The store address redirects to …"                       | Introdujiste una dirección que redirige a otra (por ejemplo, sin `www`) | Conecta con la dirección del mensaje.                                           |
| "Access was not granted on the store"                    | Se hizo clic en **Deny** en la pantalla de aprobación                   | Vuelve a hacer clic en **Conectar** y elige **Approve**.                        |
| "The store did not send the key to Happ"                 | Tu sitio no pudo llegar a HAPP (firewall o plugin de seguridad)         | Permite las peticiones salientes a `api.happ.tools` y vuelve a intentarlo.      |
| "The store refused access — reconnect WooCommerce" (401) | La clave se revocó o eliminó en WooCommerce                             | Abre **Integraciones** > **WooCommerce** y vuelve a hacer clic en **Conectar**. |
| Falta un producto en el catálogo                         | El producto es un borrador, es privado o supera el límite de 5000       | Publícalo; aparecerá tras la siguiente sincronización.                          |

## Desconectar [#disconnect]

Desconecta la tarjeta en HAPP o revoca la clave de HAPP en **WooCommerce > Settings > Advanced > REST API**. Los pedidos que ya están en tu tienda no se tocan.

## Siguiente [#next]

* [CRM](/docs/integrations/crm): todas las integraciones de CRM
* [Herramientas](/docs/agents/tools): lo que el agente llama durante las conversaciones
* [Integraciones](/docs/integrations): el catálogo completo