Conectar Picqer

Visión general

La integración con Picqer conecta tu sistema de gestión de almacén con Bugalou. Una vez conectada, puedes activar automatizaciones con eventos de pedidos y devoluciones, y el AI Agent puede consultar a demanda la información de pedidos y los niveles de stock. Ve a Canales → Picqer y haz clic en "Conectar".

Qué necesitarás

• Una cuenta de Picqer activa con acceso de administrador
• Tu subdominio de Picqer (la parte anterior a .picqer.com, p. ej. mycompany)
• Una clave de API de Picqer (se genera en Ajustes → Claves de API de Picqer)

Paso 1: crea una clave de API en Picqer

1. En Picqer, ve a Ajustes → Claves de API
2. Haz clic en "Añadir clave de API"
3. Ponle un nombre (p. ej. Bugalou) y guarda
4. Copia la clave de API generada: solo la verás una vez

Paso 2: conecta en Bugalou

1. Ve a Canales → Picqer
2. Introduce tu Subdominio (p. ej. mycompany)
3. Pega tu API Key
4. Haz clic en "Conectar": Bugalou verificará la conexión

Paso 3: configura los webhooks en Picqer

Para recibir eventos de pedidos y devoluciones en tiempo real, añade webhooks en Picqer (Ajustes → Webhooks). La URL del webhook se muestra en la página de la integración de Picqer en Bugalou. Añade un webhook distinto para cada evento que quieras usar:

Evento	Cuándo se activa
orders.completed	El pedido se ha procesado y completado por completo
orders.status_changed	Cambia el estado del pedido (p. ej. a "enviado")
orders.closed	El pedido se cierra
returns.status_changed	Cambia el estado de la devolución
returns.products_received	Los productos devueltos se reciben en el almacén

Paso 4: sincroniza tus productos

Tras conectar, haz clic en "Sincronizar productos" para importar tu catálogo de productos. Esto permite que el AI Agent responda preguntas sobre stock y consulte los detalles de los productos. La sincronización puede tardar un minuto en catálogos grandes: la página muestra el estado de la sincronización y el número de productos cuando termina.

Qué puedes hacer

• Desencadenantes de automatización — activa automatizaciones de WhatsApp, email o SMS con eventos de pedidos y devoluciones de Picqer. Consulta la referencia de desencadenantes de Picqer para ver todos los subeventos y variables
• Consulta de pedidos por el AI Agent — cuando un cliente menciona un número de pedido, el AI Agent lo busca automáticamente en Picqer e incluye el estado, los productos y la información de seguimiento en su respuesta
• Consultas de stock del AI Agent — el AI Agent puede responder preguntas sobre la disponibilidad de productos usando tu catálogo de Picqer sincronizado
• Variables disponibles — {{customer_name}}, {{order_number}}, {{order_status}}, {{tracking_url}}, {{tracking_code}}, {{return_number}}

Casos de uso

• Pedido completado → solicitud de valoración — cuando se completa un pedido, espera 2 días y envía automáticamente una solicitud de valoración por WhatsApp
• Pedido enviado → seguimiento — cuando el estado de un pedido cambia a "enviado", envía el enlace de seguimiento al cliente
• Devolución recibida → confirmación — cuando llegan los productos devueltos, envía automáticamente una confirmación de la devolución
• Consultas de stock con IA — los clientes pueden preguntar "¿Hay stock de la chaqueta azul?" y el AI Agent responde usando el catálogo de productos sincronizado

Desconectar

Para desconectar Picqer, haz clic en "Desconectar" en la parte inferior de la página de la integración de Picqer. Esto elimina las credenciales y detiene todos los webhooks entrantes. Los productos sincronizados anteriormente y las automatizaciones existentes no se eliminan.