Integraciones
Videos tutoriales
Los videos se reproducen si la carpeta media/ está disponible en el servidor.
¿Para qué sirve este módulo?
El módulo Integraciones conecta Ecobelleza con servicios externos: correo, pagos en línea, transportadoras, medición de campañas, marketplaces, WhatsApp, inteligencia artificial y más.
La pantalla inicial suele ser Correo. Desde la barra de iconos arriba elija el bloque que necesite.
Cómo configurar cualquier integración
- Elija el bloque en el menú (Correo, Pagos, Transportadoras, etc.).
- Entre al proveedor concreto (tarjeta o enlace en pantalla).
- Complete las credenciales que le entregó el proveedor y pulse Guardar.
- Active «Activo en web» cuando aplique (pagos y transportadoras).
- Pruebe en ambiente de prueba antes de pasar a producción.
Seguridad: las claves, tokens y contraseñas son sensibles. Solo personal autorizado debe acceder a este módulo.
Relación con otros módulos
| Módulo | Relación |
|---|---|
| Catálogo web / Web | Usa pasarelas de pago, transportadoras, Pixel/Analytics e Instagram configurados aquí. |
| Pedidos | Los pedidos web pagados pasan por las pasarelas; los envíos usan las transportadoras activas. |
| Parámetros (compañía) | Datos de la empresa; no reemplaza las credenciales de cada integración. |
| Programación / Citas | Puede sincronizar con Google Calendar si está conectado. |
| Restaurante | Delivery (Rappi, DiDi) cuando la operación incluye domicilios por plataforma. |
Inicio rápido — tienda web operativa
- Correo → Gmail (contraseña de aplicación) o SMTP → elija proveedor activo → pruebe conexión.
- Pagos → configure una pasarela (ej. Wompi o Bold en Colombia) → marque «Activo en web».
- Transportadoras → credenciales del operador contratado → «Activo en web».
- Rastreo → Pixel ID y/o Google Analytics para medir campañas.
- Notificaciones email → revise plantillas de confirmación de pedido.
- Realice una compra de prueba en el catálogo web y verifique pago, correo y envío.
Parámetros del menú
Icono Parámetros (engranaje). Solo visible si su perfil tiene permiso especial.
Desde ahí puede activar u ocultar:
- Cada bloque principal (Correo, Pagos, Transportadoras, Rastreo, Mastershop, Calendario, Delivery, Notificaciones, Instagram, ChatCenter, IA).
- Cada proveedor dentro del bloque (ej. solo Wompi y Bold en Pagos; solo Coordinadora en Transportadoras).
Oculte lo que su empresa no usa para que el menú quede más claro.
Bloque Correo
Envía notificaciones del sistema (registro, validación, pedidos, etc.) por correo electrónico.
Proveedor activo
Arriba del formulario elija Gmail, SMTP o Desactivado y pulse Guardar.
Gmail
- Correo Gmail y contraseña de aplicación (no la contraseña normal de la cuenta).
- Active verificación en 2 pasos en Google → Contraseñas de aplicaciones.
- Complete correo, contraseña de aplicación, «Enviar desde» y «Responder a».
- Pulse Probar conexión antes de salir.
SMTP genérico
- Host, puerto, seguridad (TLS/SSL), usuario, contraseña y remitente.
- Útil para Outlook, servidor propio, SendGrid SMTP, etc.
Bloque Pagos
Epayco
Región: Colombia / LATAM
Qué completar: Claves pública y privada, identificador de comercio, modo prueba o producción.
Consejo: Pasarela colombiana muy usada. Configure las URLs de respuesta en el panel de Epayco.
PayU Latam
Región: Colombia y LATAM
Qué completar: Merchant ID, Account ID, API Key, API Login y URLs de respuesta y confirmación.
Consejo: Registre la URL de confirmación en PayU para que los pedidos se actualicen solos.
PayPal
Región: Internacional
Qué completar: Client ID, Client Secret, modo prueba (Sandbox) o producción, moneda.
Consejo: Pruebe con cuenta sandbox antes de cobrar en vivo.
Mercado Pago
Región: LATAM
Qué completar: Public Key, Access Token, país, moneda, modo sandbox y webhooks.
Consejo: Configure los webhooks en el panel de Mercado Pago según indique su proveedor.
Addi
Región: Colombia
Qué completar: Client ID, Client Secret y URLs de confirmación.
Consejo: Crédito «compra ahora, paga después».
Sistecredito
Región: Colombia
Qué completar: Credenciales API del comercio, ambiente de prueba o producción.
Consejo: Financiación en web según contrato con Sistecredito.
Wompi
Región: Colombia
Qué completar: Claves pública y privada, URL de eventos e integridad.
Consejo: Configure los eventos en el dashboard de Wompi.
Bold
Región: Colombia
Qué completar: API Key, Secret Key, Commerce ID, Webhook Secret y URLs de confirmación.
Consejo: Ideal para pagos con tarjeta en Colombia.
Bloque Transportadoras
Cada operador tiene su propia pantalla con credenciales del web service o API. Igual que en Pagos, use Activo en web para el checkout.
| Operador | Qué completar | Notas |
|---|---|---|
| Coordinadora | NIT remitente, id cliente, usuario y clave del web service, ambiente prueba o producción. | Credenciales entregadas por Coordinadora. |
| Envía Colvanes | Usuario, contraseña, código cliente y ambiente. | Cotizador y guías según contrato Colvanes. |
| Servientrega | Login, clave, id cliente y código de acuerdo. | Una de las transportadoras más usadas en Colombia. |
| Interrapidísimo | Usuario API, clave e id cliente. | Guías y seguimiento Interrapidísimo. |
| TCC | Usuario, clave y cuenta comercial. | Transportes de Carga Consolidada. |
| 99minutos | API Key, client id y ambiente. | Entregas urbanas y última milla. |
| Domina | Credenciales API del operador. | Operador logístico regional. |
| DHL | Site ID, contraseña, número de cuenta y ambiente. | Envíos nacionales e internacionales DHL Express. |
Pruebe siempre en ambiente de pruebas antes de emitir guías reales. Las credenciales las entrega el comercial de cada transportadora.
Bloque Rastreo
Facebook Pixel
Mide conversiones de campañas en Facebook e Instagram.
Identificador principal: Pixel ID
Google Tag Manager
Contenedor central para etiquetas de marketing sin tocar la web a mano.
Identificador principal: Container ID (GTM-XXXX)
Google Analytics 4
Análisis de tráfico y comportamiento en la tienda web.
Identificador principal: Measurement ID (G-XXXX)
Los scripts se aplican en la tienda web pública. Guarde el identificador que le entrega Meta o Google en la pantalla correspondiente.
Bloque Mastershop
Panel para conectar con el marketplace Mastershop. Pestañas principales:
- Conexión — probar credenciales API.
- Productos — ver catálogo Mastershop (filtros y búsqueda).
- Pedidos — pedidos importados o consultados desde la API.
- Crear pedido — enviar un pedido de prueba.
- Reporte Sync — últimas sincronizaciones.
- Actualizar estado — cambiar estado de un pedido en Mastershop.
- Reporte pedidos — exportar listado.
Si su proveedor le entregó documentación de la API, consúltela desde los enlaces de la pantalla de conexión.
Bloque Calendario
Integración con Google Calendar:
- Cree credenciales «Aplicación web» en Google Cloud Console.
- Copie la URL de redirección que muestra la pantalla de Ecobelleza.
- Guarde Client ID y Client Secret.
- Pulse Conectar con Google y autorice la cuenta.
Use Desconectar si debe revocar el acceso.
Bloque Delivery
Rappi
Configure credenciales API según contrato con Rappi. Active o desactive la integración en el formulario.
DiDi Food
Integración con DiDi Food para restaurantes y domicilios. Complete tokens y datos del comercio.
Relacionado con módulos de restaurante cuando opera domicilios por plataforma.
Bloque Notificaciones email
Gestión de plantillas de correo por proceso de negocio:
- Listado con nombre, proceso y estado activo/inactivo.
- Nueva plantilla o Editar para personalizar el contenido HTML.
- El envío real usa el proveedor configurado en el bloque Correo.
Revise plantillas de confirmación de pedido, recuperación de clave, etc., según lo que use su empresa.
Bloque Instagram
Tres formas de mostrar Instagram en la web:
- Enlace al perfil — usuario sin @ y estado Activo.
- API oficial — ID de cuenta Business y Access Token (cuenta profesional vinculada a Página de Facebook).
- Widget externo (opcional) — código embed de SnapWidget, Elfsight u otro servicio.
La API oficial es la opción más estable a largo plazo.
Bloque ChatCenter
Integración con El Chat Center para WhatsApp Business:
- Configuración — URL API, tokens, sucursal/vendedor por defecto, prefijo de pedidos.
- Estado — interruptor Activo/Inactivo tras guardar.
- Webhooks — URL pública y eventos de inventario, producto y pedido.
- Pruebas WhatsApp — envío de texto, plantillas Meta, imagen, video, audio, ubicación y documento.
- Mensajes automáticos — respuestas configurables por evento.
- API Key — para conectar sistemas externos con Ecobelleza.
Coordine con Meta Business verificado y con su proveedor El Chat Center.
Bloque IA
Configure uno o más proveedores de inteligencia artificial:
| Proveedor | Obtener clave API |
|---|---|
| OpenAI (ChatGPT) | Sitio del proveedor |
| Google Gemini | Sitio del proveedor |
| Anthropic (Claude) | Sitio del proveedor |
| Mistral AI | Sitio del proveedor |
| DeepSeek | Sitio del proveedor |
En cada proveedor: pegue la API Key, active o desactive y elija modelo por defecto si la pantalla lo permite.
Asistente IA — chat interno que usa el proveedor activo configurado.
Solo personal autorizado debe manejar claves de IA; tienen costo por uso.
Permisos
- Quién ve Integraciones depende del perfil del empleado en el menú lateral.
- Parámetros del módulo requiere permiso especial de administrador.
- Credenciales de pago y transportadoras: solo administrador o responsable de comercio electrónico.
- ChatCenter WhatsApp: coordinar con proveedor Meta Business verificado.
Preguntas frecuentes
No veo un icono del menú (ej. Mastershop).
Actívelo en Parámetros de Integraciones o pida al administrador que lo habilite.
La pasarela no aparece en la web.
Debe tener credenciales guardadas y el interruptor «Activo en web» encendido en la tarjeta de la pasarela.
Gmail no envía correos.
Use contraseña de aplicación, no la contraseña normal. Verifique que Gmail esté seleccionado como proveedor activo en Correo.
¿Puedo tener varias pasarelas activas?
Sí; el checkout mostrará todas las que tengan «Activo en web».
Pedido pagado pero el estado no se actualiza.
Revise la URL de confirmación o webhook en el panel de la pasarela (PayU, Bold, Mercado Pago, etc.).
¿Dónde configuro datos de la empresa?
En el módulo Parámetros (NIT, logo, facturación), no aquí.
Ejemplos prácticos
Ejemplo 1 — Tienda Colombia básica
Gmail + Wompi (pruebas) + Coordinadora (pruebas) + Google Analytics → compra test → activar producción.
Ejemplo 2 — Solo catálogo sin pago online
Oculte el bloque Pagos en Parámetros; mantenga Correo y Rastreo.
Ejemplo 3 — Marketplace Mastershop
Conexión OK → sincronizar productos → recibir pedidos → revisar listado importado.
Ejemplo 4 — Atención WhatsApp
ChatCenter configurado → plantilla Meta aprobada → mensaje automático de bienvenida.
Ejemplo 5 — Asistente interno
API Key de OpenAI guardada → probar Asistente IA para consultas del equipo.
Buenas prácticas
- Pruebe siempre en sandbox o ambiente de pruebas antes de producción.
- Registre URLs de webhook y confirmación exactas (HTTPS en producción).
- No comparta API keys por correo ni chat; rote claves si hay sospecha de fuga.
- Oculte integraciones no usadas en Parámetros del menú.
- Documente qué pasarela y transportadora usa cada canal de venta.
- Revise plantillas de email tras cambiar logo o datos de compañía.
- Ante fallos de pago o WhatsApp, revise con su proveedor los logs y webhooks.