Saltar al contenido principal

Conexiones de integración

Automatizaciones → Conexiones

Una conexión es la puerta por la que un workflow habla con el exterior: un buzón de correo del que lee los pedidos, un número de WhatsApp por el que recibe y responde mensajes. Tu empresa puede tener varias de cada tipo, y cada workflow elige la que usa.

Solo pueden verlas y cambiarlas los usuarios con el rol Administración.

nota

Las contraseñas, tokens y claves que pide una conexión se guardan en un almacén de secretos de Azure (Key Vault), no en QUBEX. Una vez guardados no se vuelven a enseñar, ni siquiera a ti: la ficha solo dice si están guardados.

Tipos de conexión​

  • Correo de Microsoft 365: un buzón de tu Microsoft 365. Necesitas que quien administra vuestro Microsoft 365 registre una aplicación con permiso para leer solo ese buzón, y te dé el Id del directorio, el Id de la aplicación y un secreto de la aplicación.
  • Correo por IMAP: un buzón de cualquier otro servidor de correo. Necesitas el servidor, el puerto, el tipo de cifrado (TLS o STARTTLS; sin cifrar no se admite), el usuario y la contraseña. Si tu proveedor lo exige, usa una contraseña de aplicación.
  • WhatsApp Business: un número conectado con la Cloud API de Meta. Necesitas el identificador del número que da Meta, un token de acceso permanente, el secreto de la aplicación de Meta y un token de verificación que inventas tú.
  • Webhook: una dirección de QUBEX a la que otro programa llama para lanzar workflows. No pide datos: después de guardarla, pulsa Generar token nuevo para obtener su dirección, que solo se ve en ese momento. Consulta cómo se usa.

Dar de alta una conexión​

  1. Pulsa Nueva conexión.
  2. Elige el proveedor. No se puede cambiar después: para otro tipo, da de alta otra conexión.
  3. Escribe un nombre que la identifique, por ejemplo «Buzón de pedidos».
  4. Rellena sus datos. Debajo de cada campo tienes una explicación.
  5. Escribe sus secretos.
  6. Pulsa Guardar. La ficha se queda abierta y cada secreto pasa a Guardado.

Si la conexión recibe avisos —WhatsApp, por ejemplo—, la ficha enseña la dirección para el proveedor: cópiala en su configuración, que es adonde mandará sus avisos. Con Microsoft 365 no tienes que copiarla: QUBEX se suscribe solo a los correos nuevos del buzón.

consejo

Un número de WhatsApp solo puede estar conectado una vez. Si QUBEX te dice que ese identificador ya está en uso, es que hay otra conexión con él.

Preparar un buzón de Microsoft 365​

Esto lo hace quien administra el Microsoft 365 de tu empresa, una sola vez por buzón:

  1. En el centro de administración de Microsoft Entra, en Registros de aplicaciones, registra una aplicación nueva, por ejemplo «QUBEX - Buzón de pedidos».
  2. En Permisos de API, añade el permiso de aplicación Mail.Read de Microsoft Graph y pulsa Conceder consentimiento de administrador.
  3. Limita la aplicación a ese buzón con una directiva de acceso de aplicaciones de Exchange Online. Sin ella, la aplicación podría leer cualquier buzón de la empresa; con ella, solo los que indiques.
  4. En Certificados y secretos, crea un secreto de cliente y copia su valor: solo se ve al crearlo.
  5. En QUBEX, da de alta una conexión Correo de Microsoft 365 con la dirección del buzón, la carpeta, el Id del directorio, el Id de la aplicación y el secreto.
  6. Pulsa Probar conexión. Si dice que no tiene permiso, revisa los pasos 2 y 3.

En Carpeta, Inbox es la bandeja de entrada. Para otra carpeta, escribe su nombre tal cual, como Pedidos, o su ruta, como Inbox/Pedidos.

precaución

El secreto de cliente caduca en la fecha que se eligió al crearlo. Antes de que caduque, crea otro y escríbelo en la ficha de la conexión: si caduca, el buzón deja de leerse y el listado lo dice en Último error.

Conectar un buzón por IMAP​

Para un buzón de cualquier otro servidor de correo:

  1. Pide a tu proveedor de correo el servidor IMAP y su puerto, y si usa TLS (normalmente el puerto 993) o STARTTLS (normalmente el 143). Sin cifrar no se puede conectar.
  2. Si tu proveedor lo exige —Gmail, por ejemplo—, crea una contraseña de aplicación para QUBEX en vez de usar la tuya.
  3. En QUBEX, da de alta una conexión Correo por IMAP con el servidor, el puerto, el cifrado, el usuario y la contraseña.
  4. En Carpeta, INBOX es la bandeja de entrada. Para otra, escribe su nombre tal como lo da el servidor, por ejemplo INBOX/Pedidos o INBOX.Pedidos.
  5. Si quieres, escribe una carpeta de procesados que ya exista en el buzón: los correos que lancen algún workflow se moverán allí, y los demás se quedarán donde están.
  6. Pulsa Probar conexión.
nota

La primera vez que se lee el buzón no se procesa lo que ya había en él: solo los correos que lleguen desde ese momento.

Conectar un número de WhatsApp​

Para usar un número de WhatsApp Business con la Cloud API de Meta. Esto lo hace quien administra vuestra cuenta de Meta:

  1. En Meta for Developers, en tu aplicación con el producto WhatsApp, copia el identificador del número (Phone number ID) y crea un token de acceso permanente de un usuario del sistema.
  2. En la configuración básica de la aplicación, copia el secreto de la aplicación (App secret).
  3. Inventa un token de verificación: una palabra larga que solo conozcas tú.
  4. En QUBEX, da de alta una conexión WhatsApp Business con el identificador del número, el token de acceso, el secreto de la aplicación y el token de verificación, y guárdala.
  5. La ficha enseña la dirección para el proveedor. En la aplicación de Meta, en WhatsApp → Configuración → Webhook, pon esa dirección como URL de devolución de llamada y el mismo token de verificación, y suscríbete al campo messages.
  6. Pulsa Probar conexión en QUBEX.
consejo

Si tienes varios números en la misma aplicación de Meta, conecta cada uno en QUBEX y pon en Meta la dirección de cualquiera de ellos: QUBEX reparte cada mensaje a su número.

Cambiar una conexión​

Pulsa su fila en el listado. Puedes cambiar el nombre y los datos. Los secretos aparecen vacíos aunque estén guardados: déjalos vacíos para conservar los que hay, o escribe uno nuevo para sustituirlo.

Probar una conexión​

En la ficha de una conexión guardada, pulsa Probar conexión: QUBEX intenta entrar con sus datos y te dice si funciona o por qué no. El listado recuerda la última prueba y el último error.

Desactivar una conexión​

Pulsa Desactivar en su ficha. Sus disparadores dejan de escuchar y los workflows que la usan fallan en ese paso con un motivo claro, pero se conservan la conexión, sus secretos y todo lo que disparó. Pulsa Activar para volver a usarla. Las conexiones no se borran, porque un workflow publicado puede seguir apuntando a ella.

Usar una conexión en un workflow​

Los nodos que leen un buzón o envían por WhatsApp tienen un campo para elegir la conexión, que ofrece las activas del tipo que necesitan. Al publicar el workflow se comprueba que cada conexión que usa es de tu empresa, está activa y es del tipo correcto; si no, el nodo se marca en rojo con el motivo. Consulta cómo publicar un workflow.