> 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/transformacion-de-datos/codigo.md).

# Código

### Visión General

El **Componente de código ejecutable de JavaScript** (identificado internamente como `código`) es un nodo de acción avanzado diseñado para ampliar las capacidades nativas de la plataforma mediante programación activa. Su función principal es ejecutar scripts personalizados en un entorno aislado (*sandbox*), permitiendo realizar cálculos matemáticos complejos, limpiar o reformatear cadenas de texto, manipular arreglos de datos e integrarse con sistemas externos.

**Reglas obligatorias de desarrollo:** 1. **Consumo de APIs externas:** Siempre que sea necesario realizar solicitudes HTTP/HTTPS (como métodos `GET`, `POST`, `PUT` o `DELETE`) a servidores de terceros dentro del script, es obligatorio el uso de la biblioteca **Axios** (inyectada de forma nativa en el ámbito global del nodo).

2. **Persistencia de datos en el flujo:** El uso de la instrucción `return` es estrictamente obligatorio al final del script. Sin la devolución explícita de un objeto o variable, el motor de ejecución descarta el procesamiento y no pasa los datos calculados a los bloques subsiguientes de la automatización.

### Parámetros de Configuración

La parametrización del nodo es simplificada y se concentra en la ventana de codificación directa:

* **Código:** Área con resaltado de sintaxis (*resaltado de sintaxis*) donde el desarrollador o administrador escribe el bloque de script en JavaScript (ECMAScript moderno) que será enviado a la compilación del motor.<br>

### Constructor Visual

La interfaz gráfica se centra en el aislamiento y la autonomía técnica del desarrollador dentro del constructor de flujos:

* **Editor de código integrado:** El constructor ofrece un terminal textual limpio con numeración de líneas y recortes rápidos para facilitar el pegado y la validación de algoritmos. Prescinde de selectores de canales o archivos multimedia, operando puramente en el núcleo lógico del sistema.<br>
* **Mapeo de salidas de carga útil:** En el mapa visual de automatización, el bloque presenta una puerta de entrada y una de salida continua. Al guardar el script estructurado con el `return`, el editor pone a disposición la variable resultante del componente como metadato legible para los nodos vecinos en el árbol de decisión.<br>

### Operadores especiales

Las propiedades lógicas de este componente gestionan la captura de variables locales y llamadas asíncronas:

* **Inyección de contexto global (`$data`):** El intérprete JavaScript del componente concede acceso total al objeto `$data`. Esto permite que el código lea cualquier variable almacenada previamente en el flujo (por ejemplo: `$data.nome`, `$data.telefone`, o cargas útiles de respuestas de preguntas anteriores) directamente dentro de las expresiones del script.<br>
* **Resolución asíncrona mediante promesas (`async/await`):** Para garantizar el correcto procesamiento de solicitudes externas sin congelar el motor, el nodo está preparado para interpretar ámbitos asíncronos. El desarrollador puede estructurar funciones con `async` y utilizar el operador `await` en las llamadas de Axios, garantizando que el `return` final espere la respuesta de la API externa.<br>

### Ejemplos prácticos

La tabla siguiente muestra escenarios clásicos de aplicación del componente utilizando la sintaxis correcta con Axios y retorno de datos:

| **Objetivo del script**            | **Código JavaScript configurado en el constructor**                                                                                                                                                     | **Comportamiento del motor de la plataforma**                                                                                  | **Caso de Uso Práctico**                                                                                            |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- |
| **Manipulación de cadena local**   | <p>const nome = $data.nome;<br><br><br><br>const nomeMaiusculo = nome.toUpperCase();<br><br><br><br>return { nome\_formatado: nomeMaiusculo };</p>                                                      | Captura la variable del CRM, transforma las letras en mayúsculas usando JS nativo y devuelve el nuevo formato al flujo.        | Estandarizar nombres de leads en la base de datos antes de enviar una notificación formal por correo electrónico.   |
| **Integración externa con Axios**  | <p>const cep = <span class="math">data.cep;\<br>\<br> \<br>\<br>const resposta = await axios.get(`https://viacep.com.br/ws/</span>{cep}/json/`);<br><br><br><br>return { endereco: resposta.data };</p> | Realiza una llamada externa síncrona usando Axios basada en el CEP del cliente y devuelve el objeto completo de dirección.     | Localizar la calle y el barrio de un cliente de forma 100% autónoma después de que escriba el CEP en el Webchat.    |
| **Cálculo matemático condicional** | <p>const valorTotal = $data.total\_carrinho;<br><br><br><br>const desconto = valorTotal \* 0.10;<br><br><br><br>return { valor\_desconto: desconto, total\_final: valorTotal - desconto };</p>          | Realiza ecuaciones matemáticas en la memoria del servidor e inyecta los dos resultados como variables utilizables en el flujo. | Calcular dinámicamente un descuento del 10% en la jornada y reenviar el valor exacto al enlace de pago del cliente. |


---

# 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/transformacion-de-datos/codigo.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.
