Conector CRM de Pipedrive¶
Este plugin conecta su tienda Shopware 6 con Pipedrive CRM y cierra la brecha entre su tienda en línea y su equipo de ventas. Los nuevos clientes se crean automáticamente como personas y organizaciones en Pipedrive, los pedidos se asignan como oportunidades en su pipeline de ventas y todos los cambios de estado se documentan como actividades – en tiempo real, completamente automático y sin esfuerzo manual.
Aspectos destacados
- 👤 Creación automática de clientes como persona (+ organización para B2B)
- 💼 Cada pedido crea automáticamente una oportunidad en su pipeline
- 🔔 El pago, envío y cancelación se documentan como actividades
- 🔄 Sincronización bidireccional opcional (estado de oportunidad → grupo de clientes)
- 📊 Panel de sincronización con registro de errores y botón de sincronización manual
- ⚙️ Completamente configurable, qué eventos de Shopware se transfieren
❓ Preguntas frecuentes¶
¿Qué es Pipedrive?
Pipedrive es una herramienta de CRM y pipeline de ventas muy popular. A través de la API REST oficial de Pipedrive, es posible crear y actualizar automáticamente personas, organizaciones, oportunidades y actividades. Para utilizar el servicio, necesita una cuenta activa de Pipedrive y un token de API.
¿Qué datos se sincronizan con Pipedrive?
Los nuevos clientes se crean como persona, para clientes comerciales (B2B), también se crea una organización. Cada pedido se convierte en una oportunidad en el pipeline configurado. Los cambios de estado como pago, envío o cancelación se documentan como actividades en la oportunidad correspondiente.
¿Es automática la sincronización?
Sí. La transferencia ocurre en tiempo real basada en eventos a través de la infraestructura Shopware Events/Flow. En la configuración del plugin, especifica los eventos de Shopware (por ejemplo, registro, entrada de pedido, recepción de pago) a enviar a Pipedrive.
¿Qué es la sincronización bidireccional?
Los cambios en Pipedrive – como establecer una oportunidad en "ganada" – pueden opcionalmente funcionar hacia atrás y, por ejemplo, actualizar el grupo de clientes en Shopware. Esta dirección inversa se puede desactivar.
¿Qué sucede si falla una transferencia?
Cada transferencia se registra en el panel de sincronización con un estado. Las transferencias fallidas aparecen en el registro de errores y se pueden relanzar manualmente (Retry).
¿Es el plugin compatible con el RGPD?
Todos los datos transferidos permanecen en su propia instancia de Pipedrive. La conexión se realiza exclusivamente a través del acceso autorizado por usted a la API de Pipedrive.
¿Cuáles son los requisitos previos?
El plugin requiere el plugin CNK Foundation (a partir de la versión 3.0.4) y Shopware 6.7. En el lado de Pipedrive, se necesita una cuenta activa y un token de API.
🔧 Instalación¶
- Requisito previo: Plugin CNK Foundation (a partir de la versión 3.0.4)
- Requisito previo: Cuenta Pipedrive activa con token de API
- Instalación a través del gestor de plugins de Shopware o vía Composer
- Activar plugin:
bin/console plugin:install --activate CnkPlatformPipedrive - Realice la configuración en el área de administración de Shopware
⚙️ Configuración¶
Acceso API¶
| Configuración | Descripción |
|---|---|
| Token de API | Token de API personal de su cuenta Pipedrive (Configuración → Configuración personal → API) |
| Dominio empresarial | Su dominio de Pipedrive (por ejemplo miempresa.pipedrive.com) |
| Probar conexión | Botón que verifica el token contra la API de Pipedrive y muestra el resultado directamente en el admin |
Asignación de pipeline y oportunidades¶
| Configuración | Descripción | Estándar |
|---|---|---|
| Pipeline de destino | Lista de selección de pipelines existentes en Pipedrive | primer pipeline |
| Etapa de inicio | Etapa en la que se crean nuevas oportunidades | primera etapa |
| Esquema de nombre de oportunidad | Patrón para el nombre de oportunidad (por ejemplo Pedido {orderNumber}) | Pedido {orderNumber} |
| Valor de oportunidad | Adoptar el monto del pedido como valor de oportunidad | Activado |
Selección de eventos¶
| Configuración | Descripción | Estándar |
|---|---|---|
| Crear cliente | Transferir nuevo cliente como persona/organización | Activado |
| Pedido → Oportunidad | Crear una oportunidad al entrada de pedido | Activado |
| Pago | Registrar recepción de pago como actividad | Activado |
| Envío | Registrar envío como actividad | Activado |
| Cancelación | Registrar cancelación como actividad | Activado |
| Bidireccional | Reflejar estado de oportunidad de Pipedrive a Shopware | Desactivado |
🔄 Sincronizaciones en detalle¶
Sincronización de contactos¶
Al desencadenante seleccionado (por ejemplo, registro o primer pedido), el cliente se crea en Pipedrive:
- El cliente se crea como persona con nombre, correo electrónico y número de teléfono
- Si se registra una empresa (B2B), también se crea una organización y se vincula la persona
- Los clientes ya transferidos se reconocen por el ID de Pipedrive registrado y se actualizan (sin duplicados)
Creación de oportunidades¶
Cada pedido genera una oportunidad en el pipeline configurado:
- La oportunidad se asigna a la persona/organización correspondiente
- El nombre y valor se establecen según la configuración
- El ID de oportunidad de Pipedrive se registra en el pedido de Shopware para evitar creaciones dobles
Actividades de estado¶
Los cambios de estado del pedido se documentan como actividades en la oportunidad – por ejemplo "Pago recibido", "Enviado" o "Cancelado". El equipo de ventas ve el historial completo directamente en Pipedrive.
Sincronización bidireccional (opcional)¶
Si la dirección inversa está activada, las comparaciones regulares evalúan los cambios en Pipedrive. Ejemplo: Si una oportunidad se establece en "ganada", el grupo de clientes del cliente de Shopware correspondiente se puede ajustar automáticamente.
📊 Panel de sincronización¶
El panel de sincronización en el área de administración ofrece:
- Resumen de todos los registros sincronizados (Personas, Organizaciones, Oportunidades, Actividades)
- Estado de cada transferencia (exitosa / fallida)
- Registro de errores con mensaje de detalle de la API de Pipedrive
- Botón Sincronizar manual para relanzar transferencias fallidas
🛒 Casos de uso típicos¶
Ventas B2B¶
Los clientes comerciales se administran como una organización con contactos asignados en Pipedrive. Cada pedido es una oportunidad en el pipeline y da al equipo de ventas una vista inmediata del comportamiento de compra.
Comercio mayorista e industria¶
Los pedidos recurrentes crean oportunidades rastreables incluyendo historial de actividades. El equipo de ventas puede realizar ventas cruzadas y ascendentes dirigidas.
Nutrición de leads¶
Los nuevos registros se crean como personas y se pueden calificar más en Pipedrive antes del primer pedido.
⭐ Ventajas para operadores de tiendas¶
- Sin transferencia manual de clientes y pedidos al CRM
- El equipo de ventas trabaja completamente en Pipedrive – con datos en tiempo real de la tienda
- Trazabilidad completa a través de IDs de Pipedrive en Shopware
- Control total sobre qué eventos se transfieren
- Compatible con RGPD: Los datos permanecen en la propia instancia de Pipedrive
🧩 Conjunto de funciones¶
- Creación de clientes como persona y – para B2B – como organización
- Creación de oportunidades a partir de pedidos en el pipeline configurable
- Documentación de pago, envío y cancelación como actividades
- Sincronización bidireccional opcional (estado de oportunidad → grupo de clientes)
- Panel de sincronización con registro de errores y reintentos manuales
- Selección de eventos libremente configurable
- Prueba de conexión API directamente en la configuración del plugin
- Registro de errores a través del registro de Shopware
📚 Documentación¶
Se proporcionará más contenido de documentación y capturas de pantalla en futuras versiones del plugin.
Documentación técnica de la API de Pipedrive: https://developers.pipedrive.com/docs/api/v1