Table of Contents

REST Services

Esta funcionalidad permite definir llamadas a servicios externos (APIs) que se ejecutarán automáticamente ante una tipificación específica durante la interacción de una campaña, por lo que cada servicio debe asociarse previamente a una regla de tipificación.

Configurar REST Services

"Desde el módulo de Campañas V2, acceda a la configuración global haciendo clic en el botón Acciones situado en la parte superior de la pantalla.

Definición del Servicio (Pestaña "General")

Esta sección constituye la configuración base de la petición HTTP que se enviará al servicio externo.

  • Nombre: Identificador único y descriptivo del servicio dentro de la plataforma.
  • URL del endpoint: Dirección web (URL) del servidor destino donde se realizará la petición.
  • Método HTTP: Verbo de la petición que define la acción a realizar (GET, POST, PUT, DELETE, etc.).
  • Cuerpo (Body): Campo de texto donde se define el payload o contenido de la solicitud.
  • Parámetros query: Permite añadir pares clave-valor que serán incluidos automáticamente en la cadena de consulta (query string) de la URL (ejemplo: ?id=123&tipo=contacto).

Configuración de Petición (Pestañas "Encabezados" y "Auth")

  • Encabezados (Headers): Permite añadir pares clave-valor necesarios para la API (ej: Content-Type: application/json, Accept: application/json).
  • Auth (Autenticación): Permite configurar los métodos de seguridad para acceder al endpoint (ej: None, API Key, Bearer Token, Basic Auth). El formulario se ajusta automáticamente según el Tipo de autorización seleccionado.

Parámetros de Ejecución (Pestaña "Runtime")

Permite definir variables dinámicas o configuraciones adicionales que el motor de ejecución utilizará al invocar el servicio, asegurando que el servicio pueda procesar el contexto de la interacción.

Configuración de Resiliencia (Pestaña "Reintentos")

Esta sección define el comportamiento del sistema cuando una llamada a un REST Service falla, permitiendo establecer políticas automáticas de recuperación.

  1. Timeout (Tiempos de espera)**

    Define los umbrales máximos de tiempo (en milisegundos) antes de considerar que una petición ha fallado:

    • Conexión (ms): Tiempo máximo para establecer la conexión inicial con el servidor destino.
    • Lectura (ms): Tiempo máximo permitido para recibir una respuesta tras haber conectado.
    • Total (ms): Tiempo máximo acumulado de toda la operación (conexión + lectura).

  2. Política de Reintentos

    Determina cuándo y cómo se repetirán las peticiones fallidas:

    • Intentos máximos: Número total de intentos de ejecución adicionales tras el fallo inicial.
    • Backoff base (ms): Tiempo inicial de espera antes del primer reintento.
    • Estrategia: Define el algoritmo de incremento del tiempo de espera entre intentos:
      • Exponential: El tiempo de espera aumenta exponencialmente (ej: 1s, 2s, 4s, 8s...). Es la más recomendada para no saturar servidores que están caídos.
      • Linear: El tiempo de espera aumenta de forma constante (ej: 1s, 2s, 3s, 4s...).
      • Fixed: El tiempo de espera es siempre el mismo (ej: 1s, 1s, 1s...).
    • Reintentar en códigos HTTP: Lista de códigos de estado de respuesta (separados por comas) ante los cuales el sistema debe intentar nuevamente la ejecución (ej: 500,502,503,504 para errores de servidor).
    • Reintentar en errores de red: Al activarse, el sistema reintentará la petición ante problemas de conectividad física, DNS o timeouts de red, incluso si no se recibió un código HTTP.