API de JavaScript#

Varios bloques del chatbot ejecutan tu código JavaScript. El código hace cálculos, procesa las respuestas de servicios externos, cambia las variables y etiquetas del contacto, envía mensajes y decide hacia dónde sigue el flujo. Esta sección es una referencia para quien escribe ese código.

Dónde se ejecuta el código#

Qué contienen estos datos se describe en la página «Variables integradas». Las funciones son las mismas en todos los bloques:

Cómo se ejecuta el código#

1. El código se ejecuta entero en un servidor aparte. Las funciones no cambian al contacto de inmediato; anotan qué hacer: qué variables y etiquetas escribir, qué mensajes enviar, a qué bloque ir.
2. El código terminó sin error: el bot escribe las variables y etiquetas del contacto y las variables globales del bot y luego, en el orden de las llamadas, envía los mensajes y lleva al contacto al bloque de goToBlock. Después se activa la conexión «Continuar», salvo que el código la haya desactivado.
3. El código terminó con un error: no se aplica nada, ni siquiera lo que el código llamó antes del error.

Dentro de una misma ejecución, las funciones de lectura ya ven lo que el código escribió antes: después de setContactVariable('bouquet', 'Rosas'), una llamada a getContactVariable('bouquet') devuelve 'Rosas', aunque la variable todavía no se haya escrito en el contacto.

El código se inicia de nuevo cada vez que se pasa por el bloque. Las variables normales de JavaScript (var) no se conservan entre ejecuciones: escribe lo que haya que recordar en las variables del contacto o en las variables globales del bot.

Lenguaje#

El código se ejecuta como JavaScript del estándar ES5. De los estándares más recientes falta lo siguiente:

• let y const: declara las variables con var;
• funciones flecha: escribe function (x) { return x * 2; };
• plantillas literales entre comillas invertidas: une las cadenas con +;
• clases, desestructuración, Promise, async/await, setTimeout;
• métodos de estándares más recientes: includes, startsWith, padStart, find, Object.assign, Array.from y similares. Usa indexOf en lugar de includes y startsWith.

Todo lo de ES5 está disponible: JSON.parse y JSON.stringify, Math, Date, los métodos de cadenas y arrays split, replace, trim, map, filter, forEach, reduce, indexOf, sort. La directiva 'use strict' no hace daño, pero no activa el modo estricto.

El código no puede hacer solicitudes de red: fetch, XMLHttpRequest y require no están disponibles. Para las solicitudes, usa el bloque «Solicitud HTTP».

Fechas#

Date cuenta el tiempo en la zona horaria del servidor, así que para los cálculos usa los métodos UTC: getUTCHours(), getUTCDate(). Date no interpreta una cadena como 2026-01-31 12:00:00 (así es created_at): reemplaza el espacio por T y añade Z:

var created = new Date(created_at.replace(' ', 'T') + 'Z');
var days = Math.floor((new Date() - created) / 86400000);

Expresiones regulares#

Las expresiones regulares se ejecutan con el motor RE2, y algunas funciones de JavaScript no funcionan en él. El código con uno de estos patrones se detiene con el error Invalid regular expression:

\w, \b y \d solo entienden letras latinas sin acento y dígitos: /\w+/ no encontrará una palabra escrita en cirílico o con letras acentuadas, como «canción». Para esas letras, enuméralas explícitamente: /[a-záéíóúüñ]+/i.

Límites#

Errores y depuración#

Lo que pasó durante una ejecución se muestra en el «Registro de ejecución» de la configuración del bloque: el código fuente, el valor de la última expresión, las acciones realizadas y el texto del error.

El valor de la última expresión es la principal herramienta de depuración. Añade el nombre de una variable o una expresión al final del código y su valor aparecerá en el registro. Convierte antes un objeto o un array en cadena; si no, el registro muestra [object Object]:

var bouquet = { name: 'Rosas', count: 7 };
JSON.stringify(bouquet);

console.log no provoca un error, pero no escribe nada en el registro.

Adónde va un error depende del bloque:

En un mensaje de error de sintaxis, el número de línea es uno más que en el editor: el error Line 4:5 Unexpected identifier significa la línea cuatro menos uno, es decir, la línea tres.

También puedes provocar un error a propósito: throw new Error('Sin precio') detiene el código, y no se guarda nada de lo que hizo. En los bloques que envían el texto del error al chat, el contacto ve Error: Sin precio.

Consejo

Prueba el código en la vista previa del bot, con el botón «Probar el bot» del constructor. Así el error lo ves tú y no tus clientes.