Adelys Docs

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.

Módulo: Conexiones Seguras Desde el plan: Pro Solo administrador ⏱ 12 min

Antes de empezar

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.

crm.adelys.app/conexiones
Cargando el flujo…
1

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).

Panel de Conexiones Seguras con las siete cifras del encabezado, el bloque ámbar de alertas de integración con tres avisos y su botón Evaluar ahora, y las dos tarjetas de conexiones desarrolladas por Digitalek: Digitalek Admin WooCommerce marcada como Solo lectura y WooCommerce marcada como Bidireccional, ambas con sus contadores de productos y tiempo de respuesta
Ojo con esta captura: sale de la demostración pública, y ahí las dos tarjetas y sus cifras son de ejemplo. En tu cuenta nacen en No conectada y sin números hasta que conectes de verdad.
2

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).

Biblioteca de integraciones con el filtro Todas y el buscador en «Google»: Google Workspace y Google Drive con la etiqueta Próximo y el botón gris Próximamente, y Google Calendar con la etiqueta Activa y el botón «Se configura en Agenda»
La etiqueta de arriba y el botón de abajo dicen lo mismo: Próximo y Próximamente, o Activa y dónde se configura.
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.
El buscador de la biblioteca con «Google Calendar» deja una sola tarjeta: Google Calendar, etiqueta Activa, categoría Calendario, «No conectada», Seg. Alto y OAuth 2, y el botón «Se configura en Agenda» junto al de documentación
Google Calendar funciona, pero no se conecta aquí: el botón te lleva a la Agenda, donde está su configuración.
4

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.

Configuración → Digitalek Admin v2.4.0 con el aviso de que esta integración se gestiona en Conexiones Seguras, la franja ámbar que dice que el backend está apagado en este entorno, el estado «Sin conexión», el bloque Conectar con URL del sitio (HTTPS), Token API y Secreto del webhook, el botón Conectar y validar con la nota de cifrado AES-256-GCM, y los botones Sincronizar ahora: Productos → Inventario, Pedidos y Formularios → Leads
La franja ámbar es de la demostración pública, que corre sin servidor. En tu cuenta el bloque Conectar funciona y el estado pasa a Conectado.
5

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.
Ventana «Conectar calendario» con la sección Google Calendar marcada como Bidireccional y el botón «Conectar con Google Calendar», debajo un aviso rojo de que el servicio de calendario no está disponible, y la sección «O importar por iCal (solo lectura)» con las instrucciones para copiar la dirección secreta, el campo Dirección iCal (secreta), el botón Sincronizar ahora y el bloque Calendarios conectados vacío
El aviso rojo de la captura es de la demostración pública. En tu cuenta, si Google no está configurado, el mensaje es el gris «No configurado en el servidor».
6

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.
El «Conectar» de Configuración → Integraciones de calendario no conecta nada. Esa lista de tres filas (Google Calendar, iCloud, Outlook) solo enciende una etiqueta que pasa de Conectar a Conectado: es un recordatorio tuyo, no una conexión. La conexión de verdad está en Agenda → Opciones ▾ → Conectar calendario, que es la del paso 5. La propia pantalla lo avisa arriba: «La importación .ics ya está disponible desde la Agenda; la sincronización bidireccional en vivo requiere autorización (OAuth)».
Omnicanal (desde el plan Pro) habla por TU cuenta de mensajería, no por una de Adelys. Hoy cubre dos canales: WhatsApp —con tu número de WhatsApp Business en Meta (WhatsApp Cloud API) o en Twilio— y SMS por tu cuenta de Twilio. Las credenciales se pegan en Omnicanal → Canales → Conecta tu propia cuenta de mensajería; viajan cifradas al servidor, se guardan selladas y nunca quedan en el navegador. El plan y los costos de mensajería son entre tu empresa y el proveedor. Para recibir, el mismo panel te da el bloque Recibir mensajes (entrada): una URL para Meta (WhatsApp Cloud API) con su Token de verificación (Meta) y una URL para Twilio, que pegas en tu proveedor; lo que tus clientes te escriban entra a la Bandeja. Con Meta hace falta además el App Secret de tu app: es con lo que el servidor comprueba que el mensaje lo mandó Meta, y sin él la entrada queda apagada. Facebook, Instagram y el resto de tarjetas de la pestaña no se conectan: el servidor solo guarda credenciales de WhatsApp y SMS, y esas tarjetas se quedan en «Sin conectar». Las conversaciones de ejemplo solo aparecen en la demostración pública; en tu cuenta, sin canal conectado, la bandeja está vacía. Lo que entra se conserva según tu plan —3 meses en Pro, 12 en Business— y lo anterior se borra solo; puedes descargarlo antes desde la Bandeja con «Mensajes».

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.

Aclaración que ahorra un malentendido: el módulo Instagram de Adelys —cuando tu cuenta lo tiene— no es una conexión con Instagram. Es un registro de turnos e ingresos por cuenta, deliberadamente aislado del resto del CRM, y no habla con la API de Instagram ni la necesita.

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