> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/hablla-docs-es/flujos-de-automatizaciones/todos-los-componentes/activadores-y-http/http.md).

# 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.<br>
  * `POST`: Para la creación de nuevos registros.<br>
  * `PUT` / `PATCH`: Para la actualización de datos existentes.<br>
  * `HEAD` / `OPTIONS` / `DELETE`: Para operaciones estructurales o eliminación de recursos.<br>
* **Autenticación:** Menú para cargar credenciales previamente guardadas en la plataforma (como *Bearer Tokens*, *Basic Auth* o claves de API).<br>
* **URL (\* Campo obligatorio):** La dirección web o endpoint de destino del servicio (ej: `https://api.sistema.com/v1/leads`).<br>
* **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`).<br>
* **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).<br>
* **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.<br>
* **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.<br>
* **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.<br>

### 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.<br>
* **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.<br>

### 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}}`).<br>
* **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).<br>
  * `http.body`: El contenido devuelto por el servidor asociado (generalmente estructurado en JSON o XML).<br>

### 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                          | <p><strong>Clave:</strong> <code>cpf</code><br><br><br><br><strong>Valor:</strong> <code>{{$data?.cpf}}</code></p>                                      | 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`           | <p>Enviar encabezados<br><br><br><br>Enviar cuerpo</p> | <p><strong>Encabezados:</strong> <code>Authorization</code><br><br><br><br><strong>Cuerpo (JSON):</strong> <code>{"valor": {{$data?.total}}}</code></p> | 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. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hablla.com/hablla-docs-es/flujos-de-automatizaciones/todos-los-componentes/activadores-y-http/http.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
