HTTP

Visión General

El Componente de solicitud HTTP es un nodo de acción avanzado diseñado para realizar integraciones estructuradas con sistemas externos (como CRMs propietarios, ERPs, pasarelas de pago o plataformas de logística). Su función principal es disparar llamadas síncronas a endpoints y webhooks de terceros usando la arquitectura REST. Permite enviar payloads personalizados y capturar las respuestas (estado de respuesta y body) para condicionar y ramificar el recorrido del usuario dentro del chatbot en tiempo real.

Parámetros de Configuración

La parametrización del componente ofrece control completo sobre las capas del protocolo HTTP:

• Método: Menú desplegable utilizado para seleccionar el verbo HTTP de la solicitud de acuerdo con la operación deseada en la API de destino. Las opciones incluyen:

  • GET: Para lectura o consulta de datos.

  • POST: Para la creación de nuevos registros.

  • PUT / PATCH: Para la actualización de datos existentes.

  • HEAD / OPTIONS / DELETE: Para operaciones estructurales o eliminación de recursos.

• Autenticación: Menú para cargar credenciales previamente guardadas en la plataforma (como Bearer Tokens, Basic Auth o claves de API).

• URL (* Campo obligatorio): La dirección web o endpoint de destino del servicio (ej: https://api.sistema.com/v1/leads).

• Enviar parámetros de consulta (clave de alternancia): Cuando está activada, abre la sección Especificar parámetros de consulta con la opción Usando campos para construir pares clave-valor que se anexarán a la URL como cadenas de consulta (ej: ?status=activo).

• Enviar encabezados (clave de alternancia): Cuando está activada, abre la sección Especificar encabezados y el repetidor Parámetros de encabezado para inyectar propiedades personalizadas en los metadatos de la solicitud (como Content-Type o tokens personalizados).

• Enviar cuerpo (clave de alternancia): Desbloqueado principalmente para métodos de escritura (POST, PUT, PATCH). Habilita el campo Tipo de contenido del cuerpo (como JSON o form-data) para el llenado del payload principal.

• skipSslCertificateValidation (clave de alternancia): Cuando se activa, indica al motor de automatización que ignore errores de certificados SSL inválidos o caducados en el servidor de destino.

• Tiempo límite de la solicitud: Campo numérico para determinar la ventana máxima de espera (timeout) en segundos antes de que el sistema aborte el intento.

Constructor Visual

La interfaz del constructor fue diseñada bajo una lógica modular adaptativa (diseño de acordeón):

• Expansión condicional de menús: Como se muestra en la image_452fc2.png, la interfaz se expande de forma inteligente. Al activar los interruptores (interruptores), el panel libera los botones interactivos + Añadir parámetro, permitiendo apilar campos de clave-valor de forma ordenada, ocultándolos cuando se desactivan para mantener la pantalla limpia.

• Validación de destino: El asterisco (*) en el campo URL sirve como un bloqueo sintáctico en el editor. El flujo de automatización no puede publicarse si la ruta HTTP está vacía.

Operadores Especiales

Las propiedades lógicas de este componente manejan solicitudes asíncronas y herencia de payloads JSON:

• Interpolación de cadenas en la URL y el body: Todos los campos de texto del componente (URL, Parámetros, Encabezados y Cuerpo) admiten de forma nativa el uso de llaves dobles {{...}}. Esto permite construir llamadas dinámicas inyectando datos del contacto recopilados en el flujo (ej: https://api.com/user/{{$data?.id_person}}).

• Inyección del objeto de respuesta en el ámbito: Al completar la solicitud con éxito, el motor de automatización almacena la respuesta en el objeto local del contacto ($data). El payload devuelto queda disponible para los siguientes nodos mediante subvariables estructuradas:

  • http.status: Código numérico de retorno (ej: 200 para éxito, 404 para no encontrado).

  • http.body: El contenido devuelto por el servidor asociado (generalmente estructurado en JSON o XML).

Ejemplos Prácticos

La tabla a continuación muestra escenarios tradicionales de cómo completar las propiedades del nodo para conectar el flujo con APIs externas:

Método seleccionado	URL configurada	Claves activadas	Formato de entrada	Caso de Uso Práctico
GET	https://api.exemplo.com/v1/cliente	Enviar parámetros de consulta	Clave: cpf Valor: {{$data?.cpf}}	Consultar la solvencia o el registro de un cliente en una base de datos interna a partir del CPF recopilado en el chatbot.
POST	https://api.gateway.com/v2/pix	Enviar encabezados Enviar cuerpo	Encabezados: Authorization Cuerpo (JSON): {"valor": {{$data?.total}}}	Integrar el chatbot con una API de pagos para generar una clave PIX dinámica de cobro y devolver el código copiar y pegar en el chat.
PATCH	https://meucrm.com/api/leads/{{lead_id}}	Enviar cuerpo	Cuerpo (JSON): {"status": "En atención"}	Actualizar automáticamente la etapa del embudo de un lead dentro del CRM corporativo de la empresa en cuanto el contacto elige hablar con una persona.