Skip to content

Configurar la integración HTTP ​

Acceso

Ruta: ¡Hola! Store → Http → Instalar

Visión general ​

La app HTTP conecta ¡Hola! Suite con un sistema externo que tiene API, sin necesidad de desarrollo en ¡Hola! Suite. Registras la dirección del sistema y la forma de autenticación. Después, usas esa integración en la tarjeta Solicitud HTTP del flujo de comunicación, para consultar y enviar datos.

Puedes instalar tantas integraciones HTTP como necesites, una para cada sistema. La app es gratuita en ¡Hola! Suite.

Requisitos previos ​

  • Permiso para visualizar ¡Hola! Store en tu grupo de permisos.
  • La dirección (URL) del sistema externo y la forma de autenticación de su API.

Paso a paso ​

  1. Accede a ¡Hola! Store → Http y haz clic en Instalar. Se abre la ventana Agregar aplicación HTTP, con dos etapas.
  2. En la etapa Informaciones principales, completa:
    • Nombre: nombre para identificar la integración.
    • Permitir conexión no segura: actívala solo si la dirección no tiene un certificado SSL válido, como una dirección con IP.
    • URL: la dirección del sistema externo. Debe ser una URL válida.
    • Headers: opcional. Los encabezados que exige la API en cada solicitud, en formato JSON.
    • Definir el tiempo máximo de respuesta de la aplicación: opcional. El tiempo, en segundos, que ¡Hola! Suite espera la respuesta. El valor predeterminado y mínimo es 30 segundos. Pasado ese tiempo, la conexión se interrumpe.
  3. Haz clic en Continuar.
  4. En la etapa Autenticación, en Método de autenticación, elige una opción:
    • Sin autenticación: la API no pide credenciales.
    • Basic: informa Username y Password.
    • Token: elige cómo se obtiene el token. Consulta abajo.
  5. Haz clic en Instalar.

Autenticación por token ​

En Token, eliges entre dos formas:

  • Token fijo: deja Renovar automáticamente desactivado e informa el Token. ¡Hola! Suite envía ese valor como Bearer token en cada solicitud. Sirve para tokens de larga validez.
  • Renovación automática: activa Renovar automáticamente. ¡Hola! Suite pide un token nuevo antes de cada solicitud. Completa:
    • Método: GET o POST, según lo que exija la API.
    • URL token: la dirección que genera el token.
    • Username y Password: opcionales, si la API de token pide credenciales.
    • Headers, Body y Parámetros de consulta: opcionales, en JSON, con lo que exige la API de token.
    • Mapeo del token: la ruta del token en la respuesta de la API (ej.: data.token).
Campos obligatorios

Con Basic, el Username es obligatorio, y la Password también en la instalación. Con token fijo, el Token es obligatorio. Con renovación automática, la URL token y el Mapeo del token son obligatorios.

Resultado esperado ​

La integración aparece en la lista de la app, con las columnas Nombre, Url y Método de autenticación (Sin autenticación, Usuario y contraseña o Token). Queda disponible para elegirla en la tarjeta Solicitud HTTP del flujo de comunicación. Consulta Crear un flujo de comunicación low code con solicitud HTTP.

Configuraciones disponibles ​

Haz clic en la integración para ver las secciones Datos de integración y Autenticación. En cada una, edita los campos y guarda. Para cambiar una contraseña o token, escribe el nuevo. En blanco, se mantiene el actual.

Para eliminarla, accede a ¡Hola! Store → Http → Acceder, abre el menú de acciones de la integración y haz clic en Desinstalar, o usa el botón Desinstalar App dentro de ella. ¡Hola! Suite pide confirmación, porque la conexión se interrumpe.

Problemas comunes ​

SíntomaQué verificar
Aparece Url no válidaInforma la URL completa, con https://.
Aparece JSON inválidoLos Headers (y el Body y los Parámetros de consulta de la renovación) deben estar en JSON válido.
El tiempo máximo es rechazadoEl tiempo mínimo es 30 segundos.
La solicitud del flujo falla con la autenticación correctaSi el certificado del sistema externo no es válido, activa Permitir conexión no segura. Con renovación automática, verifica la URL token y el Mapeo del token.

Buenas prácticas ​

  • Prefiere direcciones con HTTPS y certificado válido, y deja Permitir conexión no segura desactivado.
  • Mantén las credenciales y los tokens seguros y actualízalos aquí cuando cambien.
  • Crea una integración por sistema, con un nombre fácil de reconocer.

Contenidos relacionados ​