Biblioteca › Portales e integraciones › Integraciones
Integraciones: qué está conectado de verdad
Al terminar vas a saber leer el centro de Conexiones Seguras sin engañarte: cuáles de sus 52 tarjetas hablan hoy con otro sistema, cuáles están por llegar, y dónde vive de verdad cada integración que ya funciona.
Antes de empezar
- Conexiones Seguras entra desde el plan Pro y solo lo abre el rol administrador. Cualquier otro rol ve un candado: «Conexiones Seguras es de acceso solo para administradores».
- La regla que ahorra tiempo: la integración que ya funciona vive en el módulo que la usa —Pedidos, Inventario, Agenda, Facturación, Correo—, no en su tarjeta del catálogo. Conexiones Seguras es el inventario y la vigilancia de todas ellas.
- Esta página documenta el presente. Donde algo esté a medias, lo dice con esas palabras.
Paso a paso
Míralo hecho. Los pasos de este tutorial, tal cual en el CRM: el cursor hace cada clic donde se hizo de verdad. Pulsa el número de un paso para ir a su cuadro.
Abre Conexiones Seguras y lee el panel
Barra lateral → Conexiones Seguras. El encabezado resume siete cifras: Conexiones, Activas, Con errores, Tokens por vencer, Webhooks activos, Sync pendientes y Eventos.
Debajo, Alertas de integración con su botón Evaluar ahora: revisa credenciales próximas a vencer, errores acumulados y permisos concedidos que nadie usa. Y luego el bloque CONEXIONES DESARROLLADAS POR DIGITALEK, con las dos que Digitalek mantiene: Digitalek Admin WooCommerce (solo lectura — Adelys lee el catálogo de WooCommerce que publica el plugin y nunca escribe en el sitio) y WooCommerce (bidireccional).
Recorre la biblioteca de integraciones
BIBLIOTECA DE INTEGRACIONES: 52 tarjetas con buscador y filtros por categoría —Productividad, Calendario, Correo, Comercio, Contabilidad, Pagos, Mensajería, Redes sociales, Almacenamiento, Cloud, Marketing, Automatización, Firma electrónica, CRM y ERP—.
Cada tarjeta trae el nombre, la categoría, una descripción de una línea, el nivel de seguridad y el método de autenticación (OAuth 2, API Key, Webhook entrante…), más el botón de documentación y un botón principal que dice la verdad sobre esa integración (paso 3).
Lee el botón de cada tarjeta: te dice dónde se conecta
El catálogo no te pide credenciales para conectores que todavía no existen: cada tarjeta lleva uno de tres botones, y ninguno promete lo que no hace.
- Próximamente (gris, sin pulsar) — la integración está descrita, pero el conector que habla con ese sistema todavía no existe. Son la mayoría.
- Se configura en … — funciona hoy y vive en su módulo: Google Calendar en Agenda, el correo en Correo, la facturación electrónica en Facturación, Meta Lead Ads en Leads, WhatsApp y las redes en Omnicanal. Al pulsarlo te lleva allí, para que no configures lo mismo dos veces.
- La configura el operador de Adelys — la administra Adelys por ti, no tu cuenta.
Conecta la que sí habla con otro sistema hoy: WordPress / WooCommerce
Es la integración terminada, y tiene un requisito que conviene saber antes de intentarlo: no se conecta a cualquier WooCommerce. Necesita que el WordPress tenga instalado el complemento Digitalek Admin (v2.1.0 o superior), que es quien publica la API que Adelys consume.
Se configura en Configuración → Digitalek Admin —o en la pestaña Conexión WooCommerce del módulo Pedidos— con tres datos: URL del sitio (HTTPS), Token API y, opcional, el Secreto del webhook. Al pulsar Conectar y validar, el token se cifra en el servidor y no vuelve a mostrarse; se puede rotar sin reiniciar nada.
Con la conexión viva, los tres botones de Sincronizar ahora: Productos → Inventario, Pedidos y Formularios → Leads. Debajo, Scopes y endpoints: solo se consumen los endpoints cuyo permiso autorizaste en Digitalek Admin.
Conecta el calendario: dos caminos, uno disponible siempre
En Agenda → Opciones ▾ → Conectar calendario hay dos mecanismos, y no son equivalentes:
- Google Calendar (bidireccional, OAuth) — «Importa tus eventos y empuja los de Adelys a Google. Las credenciales viven solo en el servidor». Es una integración real, pero necesita que Google esté dado de alta en el servidor. Mientras no lo esté, la pantalla lo dice sin inventar: «No configurado en el servidor». No es un error tuyo ni algo que se arregle desde el CRM.
- Importar por iCal (solo lectura) — este funciona hoy. En Google Calendar → Configuración → Integrar calendario copias la Dirección secreta en formato iCal, la pegas y pulsas Sincronizar ahora. La dirección se guarda cifrada del lado del servidor y en pantalla siempre se muestra enmascarada.
Ubica las integraciones terminadas que viven en otro módulo
No aparecen como tarjeta encendida en el catálogo, y sin embargo son las que más se usan:
- Correo (SMTP) — tu servidor de envío y tu marca en cada correo saliente. Recibir —la bandeja de entrada— llega con Adelys Desktop App, próximamente. Paso a paso en Correo: conectar tu cuenta.
- Facturación electrónica (PAC) — la emisión ante la DGI de Panamá con tu proveedor autorizado, su CUFE y su CAFE. En Facturación electrónica.
- Pagos — el cobro de tu propia suscripción a Adelys. En Pagar, renovar y reactivar.
- Inventario con la tienda — la otra mitad de la conexión Digitalek: existencias que viajan en los dos sentidos. En Inventario y almacenes.
Los formularios de anuncios de Facebook e Instagram (Lead Ads) son otra cosa y sí entran: no son una conversación sino un lead, y se conectan en Leads → Opciones ▾ → Facebook e Instagram Lead Ads, con tu propia app de Meta. Lo explica Conectar Facebook e Instagram Lead Ads.
Casos prácticos
Ferretería El Tornillo — la tienda que sí se conectó
La ferretería vende por WordPress y quiere que los pedidos entren solos. El requisito real no era «tener WooCommerce» sino instalar Digitalek Admin en su WordPress y generar ahí el token. Con eso, en Configuración → Digitalek Admin se pega la URL https://, el token y el secreto del webhook, se pulsa Conectar y validar y se autoriza solo los permisos que hacen falta: leer pedidos y productos. Desde entonces, cada pedido de la tienda aparece en el módulo Pedidos y cada movimiento de existencias viaja de vuelta.
Estudio Contable Vista Alegre — el calendario que sí se podía sincronizar
La contadora quería ver sus citas de Google dentro de Adelys. El botón de Google Calendar le decía «No configurado en el servidor», así que en vez de esperar usó el segundo camino: copió la dirección secreta en formato iCal de su calendario, la pegó en Agenda → Conectar calendario y pulsó Sincronizar ahora. Sus eventos aparecen en la Agenda del CRM. Es de solo lectura —lo que crea en Adelys no vuelve a Google— y para su caso eso alcanzaba.
Preguntas frecuentes
¿Por qué Stripe (o Mailchimp, o Notion) dice «Próximamente» y no me deja conectarlo?
Porque su conector todavía no existe, y pedirte una credencial que nadie va a usar sería guardar un secreto sin propósito. Cuando el conector esté escrito, la tarjeta cambiará su botón.
Entonces, ¿por qué está el catálogo si casi todo es «Próximamente»?
Porque dice qué se va a soportar y con qué método de autenticación, y porque las que ya funcionan te llevan a su módulo desde aquí. Las credenciales, los permisos, la auditoría y la vigilancia son la base común: agregar un conector nuevo es escribir su adaptador contra esa base, no rehacer el sistema.
¿Puedo conectar un WooCommerce que no tenga Digitalek Admin?
Hoy no. Adelys consume la API que publica ese complemento, no la API estándar de WooCommerce. Si tu tienda no lo tiene, hay que instalarlo primero.
¿Mis tokens quedan guardados en mi navegador?
No. Se envían al servidor, se cifran ahí y no vuelven: la pantalla solo muestra una máscara con los últimos caracteres. Y en el caso de WordPress, la credencial cifrada queda además atada al sitio para el que se emitió, así que fuera de ese sitio no sirve para nada.
¿Hay integración con la DGI para facturar?
Directa con la DGI, no —y no la va a haber. La facturación electrónica va por tu PAC, con tus credenciales, y se configura en Facturación → Configuración fiscal. Por eso el catálogo no ofrece un conector «DGI»: sugeriría una conexión que no existe.
Sigue con
- Webhooks y API — cómo sacar los eventos del CRM hacia tus propios sistemas, sin esperar a que haya conector.
- Pedidos y entregas — el módulo donde aterrizan los pedidos de la tienda.
- Correo: conectar tu cuenta — la integración terminada que más se usa a diario.