Conector Zoho CRM¶
Este plugin conecta tu tienda Shopware 6 con Zoho CRM y cierra la brecha entre la tienda en línea y el equipo de ventas. Los nuevos clientes se crean automáticamente como contactos, los clientes B2B como cuenta, los pedidos como deals en tu pipeline de ventas y todos los cambios de estado como actividades – en tiempo real, completamente automático y sin esfuerzo manual.
Aspectos destacados
- 👤 Creación automática de clientes como contacto en Zoho CRM
- 🏢 Los clientes B2B con nombre de empresa se crean como cuenta Zoho
- 💼 Cada pedido crea automáticamente un deal en tu pipeline
- 🔔 El pago, envío y cancelación se registran como actividades
- 🔐 Conexión segura OAuth 2.0 sin claves API manuales
- 📊 Panel de sincronización con registro de errores y botón de sincronización manual
❓ Preguntas frecuentes¶
¿Qué es Zoho CRM?
Zoho CRM es una plataforma CRM y de ventas ampliamente utilizada. A través de la API REST oficial de Zoho CRM, los contactos, cuentas, deals y actividades se pueden crear y actualizar automáticamente. Para usarlo, necesitas una cuenta activa de Zoho CRM.
¿Qué datos se sincronizan con Zoho CRM?
Los nuevos clientes se crean como contacto, para clientes B2B, se crea una cuenta adicional. Cada pedido se convierte en un deal en el pipeline configurado. Los cambios de estado como pago, envío o cancelación se registran como actividades en el deal correspondiente.
¿Cómo se establece la conexión con Zoho?
La conexión se realiza a través de OAuth 2.0 – segura y sin claves API manuales. En la consola de API de Zoho, creas un cliente OAuth, registras el ID de cliente y el secreto en el plugin y autorizas el acceso una sola vez. La región de Zoho apropiada (EU, COM, IN, AU) es seleccionable.
¿La sincronización es automática?
Sí. La transferencia se produce en tiempo real a través de la infraestructura Shopware Event/Flow. En la configuración del plugin, definas qué eventos de Shopware (por ejemplo, registro, recepción de pedido, recepción de pago) se envían a Zoho CRM.
¿Qué significa sincronización bidireccional?
Los cambios en Zoho CRM – como configurar un deal como «ganado» – pueden impactar opcionalmente en Shopware y, por ejemplo, actualizar el grupo de clientes. Esta dirección inversa se puede desactivar.
¿Qué sucede si una transferencia falla?
Cada transferencia se registra en el Panel de sincronización con el estado. Las transferencias fallidas aparecen en el registro de errores y se pueden reenviar manualmente (Retry).
¿Es el plugin conforme a GDPR?
Todos los datos transferidos permanecen en tu propia instancia de Zoho. La conexión se realiza exclusivamente a través del acceso Zoho OAuth oficial que has autorizado.
¿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 Zoho, se necesita una cuenta CRM activa y un cliente OAuth (ID de cliente y Secret).
🔧 Instalación¶
- Requisito previo : Plugin CNK Foundation (a partir de la versión 3.0.4)
- Requisito previo : Cuenta Zoho CRM activa con cliente OAuth
- Instalación a través del gestor de plugins de Shopware o por Composer
- Activar el plugin :
bin/console plugin:install --activate CnkPlatformZohoCrm - Realizar la configuración en el área de administración de Shopware
⚙️ Configuración¶
Acceso OAuth¶
| Ajuste | Descripción |
|---|---|
| Región Zoho | Centro de datos de tu cuenta Zoho : EU (.eu), COM (.com), IN (.in), AU (.com.au) |
| ID de cliente | ID de cliente del cliente OAuth de la consola de API de Zoho |
| Secreto de cliente | Secret correspondiente del cliente OAuth |
| Conectar a Zoho | Botón que inicia el flujo de autorización OAuth 2.0 y confirma la conexión en el administrador |
Creas el cliente OAuth en la consola de API de Zoho (api-console.zoho.eu) como una aplicación basada en servidor. La URL de redirección que se muestra en el plugin debe registrarse allí como redirección autorizada.
Asignación de Deal y Pipeline¶
| Ajuste | Descripción | Estándar |
|---|---|---|
| Pipeline de destino | Lista de selección de pipelines/diseños existentes en Zoho | Pipeline predeterminado |
| Fase inicial | Fase en la que se crean los nuevos deals | primera fase |
| Esquema de título del deal | Patrón para el título del deal (por ejemplo Pedido {orderNumber}) | Pedido {orderNumber} |
| Valor del deal | Aceptar la suma del pedido como valor del deal | Activado |
Selección de eventos¶
| Ajuste | Descripción | Estándar |
|---|---|---|
| Crear contacto | Transferir un nuevo cliente como contacto (+ cuenta para B2B) | Activado |
| Pedido → Deal | Crear un deal al recibir el pedido | Activado |
| Pago | Registrar la recepción del pago como actividad | Activado |
| Envío | Registrar el envío como actividad | Activado |
| Cancelación | Registrar la cancelación como actividad | Activado |
| Bidireccional | Reflejar el estado del deal de Zoho en Shopware | Desactivado |
🔄 Sincronizaciones en detalle¶
Sincronización de contactos y cuentas¶
En el evento seleccionado (por ejemplo, registro o primer pedido), el cliente se crea en Zoho CRM :
- El cliente se crea como contacto con nombre, correo electrónico y número de teléfono
- Para una empresa registrada (B2B), se crea una cuenta adicional y se vincula el contacto
- Los clientes ya transferidos se reconocen por el ID de Zoho almacenado y se actualizan (sin duplicados)
Creación de deal¶
Cada pedido crea un deal en el pipeline configurado :
- El deal se asigna al contacto/cuenta correspondiente
- El título y el valor se establecen según la configuración
- El ID del deal de Zoho se almacena en el pedido de Shopware para evitar duplicados
Actividades de estado¶
Los cambios de estado del pedido se registran como actividades en el deal – por ejemplo, «Pago recibido», «Enviado» o «Cancelado». Así, el equipo de ventas ve el historial completo directamente en Zoho CRM.
Sincronización bidireccional (opcional)¶
Si la dirección inversa está activada, las conciliaciones periódicas evalúan los cambios en Zoho. Ejemplo : Si un deal se configura como «ganado», el grupo de clientes del cliente Shopware correspondiente se puede ajustar automáticamente.
📊 Panel de sincronización¶
El panel de sincronización en el área de administración ofrece :
- Descripción general de todos los registros sincronizados (contactos, cuentas, deals, actividades)
- Estado para cada transferencia (exitosa / fallida)
- Registro de errores con mensaje detallado de la API de Zoho
- Botón de sincronización manual para relanzar transferencias individuales o fallidas
🛒 Casos de uso típicos¶
Ventas B2B¶
Los clientes B2B se gestionan como cuenta con contactos asignados en Zoho. Cada pedido llega como un deal en el pipeline y da al equipo de ventas una visión inmediata del comportamiento de compra.
Comercio mayorista y pequeño negocio¶
Los pedidos recurrentes crean deals rastreables incluyendo el historial de actividades. El equipo de ventas puede realizar Cross- y Up-Selling específicos.
Nutrición de leads¶
Los nuevos registros se crean como contactos y pueden ser calificados aún más en Zoho antes del primer pedido.
⭐ Ventajas para los operadores de tienda¶
- Sin transferencia manual de clientes y pedidos al CRM
- El equipo de ventas trabaja constantemente en Zoho CRM – con datos en tiempo real de la tienda
- Conexión segura OAuth 2.0 sin claves API manuales
- Trazabilidad completa a través de los ID de Zoho en Shopware
- Conforme a GDPR : Los datos permanecen en tu propia instancia de Zoho
🧩 Alcance de funciones¶
- Creación de clientes como contacto y – para B2B – como cuenta
- Creación de deal a partir de pedidos en el pipeline configurable
- Registro de pago, envío y cancelación como actividades
- Sincronización bidireccional opcional (estado del deal → grupo de clientes)
- Panel de sincronización con registro de errores y reintento manual
- Conexión segura OAuth 2.0 incluyendo la selección de región de Zoho
- Selección de eventos libremente configurable
- Registro de errores a través del registro de Shopware
📚 Documentación¶
El contenido de documentación adicional y las capturas de pantalla se proporcionarán con las próximas versiones del plugin.
Documentación técnica de la API de Zoho CRM : https://www.zoho.com/crm/developer/docs/api/v6/
📬 Support¶
Para preguntas, sugerencias de mejora o personalizaciones, contáctenos por correo electrónico en support@cnk-plugins.de.