Conector CRM de Salesforce¶
Este plugin conecta su tienda Shopware 6 con la plataforma CRM líder mundial Salesforce. Los nuevos clientes se crean automáticamente como contactos y cuentas, 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 contacto en Salesforce
- 🏢 Los clientes B2B con nombre de empresa se crean como cuenta de Salesforce
- 💼 Cada pedido crea automáticamente una oportunidad en su pipeline
- 🔔 El pago, envío y cancelación se documentan como actividades
- 🔐 Conexión segura OAuth-2.0 a través de una aplicación Salesforce conectada
- 🧪 Soporte de espacio aislado – pruebe de forma segura antes de la puesta en marcha
❓ Preguntas frecuentes¶
¿Qué es Salesforce?
Salesforce es la plataforma CRM líder mundial. A través de la API REST de Salesforce, es posible crear y actualizar automáticamente contactos, cuentas, oportunidades y actividades. Para utilizar el servicio, necesita una cuenta activa de Salesforce con acceso a la API.
¿Qué datos se sincronizan con Salesforce?
Los nuevos clientes se crean como contacto, para clientes comerciales (B2B), también se crea una cuenta. 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.
¿Cómo se establece la conexión a Salesforce?
La conexión se realiza a través de OAuth 2.0 con una aplicación Salesforce conectada – segura y sin transmisión de contraseña. En Salesforce, crea una aplicación conectada, almacena Consumer Key y Secret en el plugin y autoriza el acceso una sola vez.
¿Se admite el espacio aislado de Salesforce?
Sí. Puede probar primero la integración de forma segura contra su espacio aislado de Salesforce (test.salesforce.com) y solo cambiar al entorno de producción (login.salesforce.com) después de una verificación exitosa.
¿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 a enviar a Salesforce.
¿Qué es la sincronización bidireccional?
Los cambios en Salesforce – por ejemplo una oportunidad en "Closed Won" – pueden opcionalmente funcionar hacia atrás y, por ejemplo, actualizar el grupo de clientes en Shopware. Esta dirección inversa se puede desactivar.
¿Es el plugin compatible con el RGPD?
Todos los datos transferidos permanecen en su propia instancia de Salesforce. La conexión se realiza exclusivamente a través del acceso autorizado por usted a través de OAuth.
¿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 Salesforce, se necesita una cuenta activa con acceso a la API y una aplicación conectada.
🔧 Instalación¶
- Requisito previo: Plugin CNK Foundation (a partir de la versión 3.0.4)
- Requisito previo: Cuenta Salesforce activa con aplicación conectada
- Instalación a través del gestor de plugins de Shopware o vía Composer
- Activar plugin:
bin/console plugin:install --activate CnkPlatformSalesForceConnector - Realice la configuración en el área de administración de Shopware
⚙️ Configuración¶
Acceso OAuth (Aplicación conectada)¶
| Configuración | Descripción |
|---|---|
| Entorno | Producción (login.salesforce.com) o espacio aislado (test.salesforce.com) |
| Consumer Key | Consumer Key de la aplicación Salesforce conectada |
| Consumer Secret | Secret correspondiente de la aplicación conectada |
| Conectar con Salesforce | Botón que inicia el flujo de autorización OAuth-2.0 y confirma la conexión en el admin |
Crea la aplicación conectada en Salesforce bajo Setup → App Manager → New Connected App con la configuración OAuth habilitada. La URL de devolución de llamada mostrada en el plugin debe registrarse allí como URL de redirección autorizada.
Asignación de oportunidades y pipeline¶
| Configuración | Descripción | Estándar |
|---|---|---|
| Pipeline / Tipo de registro | Lista de selección de pipelines de oportunidad existentes en Salesforce | Estándar |
| Etapa de inicio | Etapa en la que se crean nuevas oportunidades | primera etapa |
| Esquema de nombre de oportunidad | Patrón para el nombre (por ejemplo Pedido {orderNumber}) | Pedido {orderNumber} |
| Cantidad | Adoptar el monto del pedido como cantidad de oportunidad | Activado |
Selección de eventos¶
| Configuración | Descripción | Estándar |
|---|---|---|
| Crear contacto | Transferir nuevo cliente como contacto (+ cuenta para B2B) | 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 Salesforce a Shopware | Desactivado |
🔄 Sincronizaciones en detalle¶
Sincronización de contactos y cuentas¶
Al desencadenante seleccionado (por ejemplo, registro o primer pedido), el cliente se crea en Salesforce:
- El cliente se crea como contacto con nombre, correo electrónico y número de teléfono
- Si se registra una empresa (B2B), también se crea una cuenta y se vincula el contacto
- Los clientes ya transferidos se reconocen por el ID de Salesforce registrado y se actualizan (sin duplicados)
Creación de oportunidades¶
Cada pedido genera una oportunidad en el pipeline configurado:
- La oportunidad se asigna al contacto/cuenta correspondiente
- El nombre y la cantidad se establecen según la configuración
- El ID de oportunidad de Salesforce 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 Salesforce.
Sincronización bidireccional (opcional)¶
Si la dirección inversa está activada, las comparaciones regulares evalúan los cambios en Salesforce. Ejemplo: Si una oportunidad se establece en "Closed Won", 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 (Contactos, Cuentas, Oportunidades, Actividades)
- Estado de cada transferencia (exitosa / fallida)
- Registro de errores con mensaje de detalle de la API de Salesforce
- Botón Sincronizar manual para relanzar transferencias fallidas
🛒 Casos de uso típicos¶
Ventas Enterprise B2B¶
Los clientes comerciales se administran como una cuenta con contactos asignados en Salesforce. Cada pedido es una oportunidad en el pipeline y da al equipo de ventas una vista inmediata del comportamiento de compra.
Empresas medianas y grandes¶
Los pedidos recurrentes crean oportunidades rastreables incluyendo historial de actividades. El equipo de ventas puede realizar ventas cruzadas y ascendentes dirigidas.
Incorporación segura a través del espacio aislado¶
La integración completa se puede probar en el espacio aislado de Salesforce antes de la puesta en marcha – sin impacto en los datos de producción.
⭐ Ventajas para operadores de tiendas¶
- Sin transferencia manual de clientes y pedidos al CRM
- El equipo de ventas trabaja completamente en Salesforce – con datos en tiempo real de la tienda
- Conexión segura OAuth-2.0 a través de una aplicación conectada
- Prueba sin riesgo gracias al soporte de espacio aislado
- Compatible con RGPD: Los datos permanecen en la propia instancia de Salesforce
🧩 Conjunto de funciones¶
- Creación de clientes como contacto y – para B2B – como cuenta
- 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
- Soporte de espacio aislado para pruebas sin riesgo
- Conexión segura OAuth-2.0 a través de una aplicación Salesforce conectada
- Selección de eventos libremente configurable
📚 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 Salesforce: https://developer.salesforce.com/docs/apis