La integración entre PrestaShop y Spoki permite automatizar el envío de mensajes transaccionales por WhatsApp, como confirmaciones de pedidos, actualizaciones de envío, recuperación de carritos abandonados y notificaciones al vendedor. También permite activar funciones avanzadas mediante el Spoki AI Sales Agent.
- Tiempo de configuración: ~10 minutos
- Nivel: no se requieren conocimientos técnicos
- Compatibilidad: PrestaShop 1.4+
Requisitos previos #
Antes de empezar, asegúrate de tener:
- Una cuenta de Spoki activa con canal de WhatsApp configurado
- Acceso de administrador a tu tienda PrestaShop
- La última versión del módulo Spoki
1. Activar la integración en Spoki #
- Accede a Spoki
- Ve a Integraciones
- Selecciona PrestaShop
- Activa la integración
- Copia los valores generados:
- Delivery URL
- Secret Token
💡 Nota
El Delivery URL y el Secret Token solo son visibles después de activar la integración. Si no los ves, asegúrate de que el interruptor esté activo.
2. Instalar el módulo Spoki #
Método recomendado: Marketplace de PrestaShop #
- Accede al panel de administración de PrestaShop
- Ve a Módulos > Catálogo de módulos
- Busca Spoki
- Haz clic en Instalar
- Después de la instalación, haz clic en Configurar
Método alternativo: carga manual #
- Descarga la última versión del módulo Spoki
- En PrestaShop, ve a Módulos > Module Manager
- Haz clic en Subir un módulo
- Sube el archivo
.zip - Abre la configuración del módulo
💡 Nota
Si cierras la ventana de configuración, busca “Spoki” en el Module Manager y haz clic en Configurar.
⚠️ Atención
Utiliza siempre la última versión del módulo. Las versiones anteriores no son compatibles.
3. Configurar el módulo #
En la página de configuración del módulo Spoki, completa los campos requeridos.
Campos obligatorios #
- Live Mode → activa la integración
- Delivery URL → pega el Delivery URL de Spoki
- Secret → pega el Secret Token de Spoki
Campos recomendados #
- Enable Recovery Endpoints → activa la recuperación de carritos
- Show WhatsApp Field → añade el campo de WhatsApp en el registro
- WhatsApp Field Required → hace obligatorio el número de WhatsApp
- Seller Phone → número de WhatsApp para notificaciones de ventas
- Review Link → enlace a la página de reseñas
- Cart Recovery Link TTL → duración de los enlaces de recuperación
Haz clic en Guardar para completar la configuración.
4. Probar la conexión #
- Realiza un pedido de prueba
- Ve a Spoki > Automatizaciones
- Verifica que el evento
order.createdha sido recibido - Para probar el carrito abandonado:
- añade un producto al carrito
- espera aproximadamente 15 minutos
Si los eventos se reciben correctamente, la integración está activa.
Automatizaciones disponibles #
- Order Created → confirmación de pedido al cliente
- Order Updated → actualización del estado del pedido
- Tracking Number Added → notificación de envío
- Abandoned Cart → recuperación de carrito abandonado
- Cart Resumed → el cliente vuelve mediante el enlace
- Customer Registered → registro de nuevo usuario
- Order Review → solicitud de reseña tras la entrega
- Order Notify → notificación de nueva venta al vendedor
Automatizaciones recomendadas #
Para empezar, recomendamos activar:
- Recuperación de carrito abandonado
Mensaje con productos y enlace directo al checkout:%%PRESTASHOP_CHECKOUT_LINK%% - Confirmación de pedido
Mensaje con productos comprados y total del pedido. - Notificación de envío
Mensaje con número de seguimiento:%%PRESTASHOP_TRACKING_NUMBER%%
Variables dinámicas #
Puedes personalizar los mensajes utilizando variables dinámicas.
Ejemplos:
%%FIRST_NAME%%%%LAST_NAME%%%%PRESTASHOP_ORDER_ID%%%%PRESTASHOP_ORDER_AMOUNT%%%%PRESTASHOP_CHECKOUT_LINK%%%%PRESTASHOP_TRACKING_NUMBER%%
Las variables disponibles pueden variar según la automatización.
Integración con Spoki AI #
PrestaShop también permite la integración con el Spoki AI Sales Agent, que permite a la IA buscar productos, mostrar detalles y ayudar en la creación de pedidos.
Configuración de Spoki AI #
- Genera una API Key en PrestaShop
- Copia la API Key y la URL de la tienda
- Ve a Spoki > AI > Integrations
- Selecciona PrestaShop
- Introduce los datos
- Haz clic en Guardar
- Activa las funcionalidades deseadas
Funcionalidades de la IA #
- Recomendaciones de productos personalizadas
- Upsell y cross-sell
- Creación de pedidos por chat
- Envío de carritos por WhatsApp
- Envío de enlaces de checkout
- Recopilación de datos de envío en conversación
Resolución de problemas #
- No se reciben eventos → verifica que la integración esté activa
- Faltan Delivery URL o Secret Token → activa primero la integración
- El módulo no se instala → descarga la última versión
- La automatización no se activa → verifica que el cliente tenga número de WhatsApp
- El carrito abandonado no se activa → espera al menos 15 minutos
- El enlace no funciona → aumenta el valor de Cart Recovery Link TTL
