Configura una integración predefinida

Una integración predefinida es un conector con el que Transportial ya sabe comunicarse, como un sistema de ordenador de a bordo, un programa de contabilidad o un servidor de correo. Solo tienes que indicar dónde está el sistema, cómo iniciar sesión y qué funciones ejecutar. La lista de sistemas depende de lo que esté disponible para tu plataforma.

Antes de empezar

• Consigue la dirección (URL) del otro sistema y tus datos de acceso a través de ese sistema o de tu proveedor: un nombre de usuario y una contraseña, una clave de API, una clave y un secreto, o una cuenta con la que autorizas el acceso.
• Comprueba qué datos quieres intercambiar, por ejemplo posiciones, actividades, planificación o facturas.

Crea la integración

1. Abre el menú lateral (☰, arriba a la derecha), elige Integraciones y haz clic en + Crear integración.
2. Introduce un Nombre, por ejemplo el nombre del sistema.
3. En Selecciona el tipo de integración, elige Integración predefinida.
4. En Selecciona la integración implementada, elige el sistema. Se rellenan sus valores predeterminados.
5. En el segundo cuadro de selección, elige las funciones que se ejecutarán. Cada opción muestra una breve descripción de lo que hace, por ejemplo obtener posiciones o enviar viajes.
6. Fija la programación: elige una unidad (Segundos, Minutos, Horas o Días) e introduce un valor, por ejemplo cada 5 minutos.
7. Comprueba la URL y el Puerto del sistema. El puerto es 443, salvo que tu proveedor te indique otra cosa.
8. En Selecciona el método de inicio de sesión, elige cómo iniciar sesión y rellena los campos (consulta más abajo).
9. Pon Apagado/Encendido en encendido y haz clic en Guardar.

Métodos de inicio de sesión

Solo se ofrecen los métodos que admite el sistema elegido.

Método	Qué introduces
Básica	Nombre de usuario y Contraseña.
Claves de API	La Clave de API que te dio el sistema.
Clave de acceso y clave secreta	Una clave de acceso y una Clave secreta.
Token Bearer	Un token del otro sistema.
Cabeceras	Uno o varios nombres y valores de cabecera. Haz clic en Añadir encabezado para cada uno.
Autorización con una cuenta	Algunos sistemas usan una página de inicio de sesión en lugar de una contraseña. Haz clic en Autorizar, inicia sesión en el otro sistema y permite el acceso. Cuando termines, vuelves a Transportial.

Opciones del conector

Algunos conectores muestran una sección Opciones debajo de los datos de acceso. Son ajustes adicionales que acepta el conector, como qué datos incluir. Cada opción muestra lo que hace la integración actualmente. Si dejas una opción como está, el conector mantiene su propio valor predeterminado. Cuando una opción solo importa para determinadas funciones, se indica («Solo se aplica cuando está activada: …»).

Ejecuta con una programación cron

Para tener más control, elige Cron como unidad de programación. Introduce una Expresión cron con cinco campos (minuto, hora, día del mes, mes, día de la semana) y una Zona horaria. Por ejemplo, 0 6 * * 1-5 se ejecuta los días laborables a las 06:00. Debajo de los campos, Próximas ejecuciones muestra cuándo se ejecutará la integración, para que puedas comprobar la expresión.

Conectores de mensajería

En los conectores que reciben mensajes (por ejemplo, servicios de chat o mensajería), el formulario muestra una URL del webhook entrante. Cópiala e introdúcela en el proveedor como webhook para los mensajes entrantes. Los mensajes que llegan ahí se dirigen a chats en Transportial.

Comprueba que funciona

Abre la integración desde la lista y consulta las pestañas Registros y Solicitudes después de la primera ejecución programada. Consulta Supervisa una integración.