Skip to content

Crear un flujo de comunicación low code con solicitud HTTP ​

Acceso

Ruta: Configuraciones → Flujo de comunicación → Añadir nuevo

Visión general ​

Un flujo low code permite que el agente virtual converse con sistemas que no tienen integración lista con ¡Hola! Suite: consultar un pedido, enviar una factura, registrar un lead en un CRM. Armas la automatización con cards, sin programar el flujo entero, y usas JavaScript solo donde necesites tratar datos.

El ejemplo de esta página tiene tres etapas: preguntar un dato al contacto, consultar una API con ese dato y seguir un camino según la respuesta.

Requisitos previos ​

  • Una integración HTTP instalada con la dirección y la autenticación de la API. Consulta Integración HTTP.
  • Los datos de la API: dirección (endpoint), método, encabezados y el formato de la respuesta.

Paso a paso ​

1. Crear el flujo ​

  1. Accede a Configuraciones → Flujo de comunicación y haz clic en Añadir nuevo.
  2. Completa los campos:
    • Nombre: identificación del flujo.
    • País: país del flujo. Define el idioma de la atención.
    • Intención (opcional): describe a quién debe llevar a este flujo el reconocimiento de intención. Consulta Identificar intención.
    • Variables (opcional): variables que el flujo recibe de otro flujo a través del card Ejecutar flujo. El nombre debe estar en lowercase (nomevariavel), camelCase (nomeVariavel) o snake_case (nome_variavel).
  3. Guarda el flujo.
  4. En la lista, haz clic en Acción → Abrir flujo.

2. Preguntar el dato al contacto ​

  1. Haz clic en el + debajo del card inicial.
  2. En Tipo, marca Interacciones y, en Herramienta, elige Enviar pregunta.
  3. En Respuesta esperada, elige Esperar interacción.
  4. Escribe la Pregunta (por ejemplo, "Informa el número de tu pedido").
  5. Marca Generar variable con respuesta del usuario y ponle un nombre en Variable (por ejemplo, numero_pedido).
  6. En Tipo de validación, elige el formato esperado (Número, por ejemplo) y completa el Mensaje de error y los intentos.
  7. Haz clic en Guardar.

3. Consultar la API ​

  1. Haz clic en el + debajo de la pregunta.
  2. En Tipo, marca Herramientas del sistema y, en Herramienta, elige Solicitud HTTP.
  3. Completa la sección Configuración:
    • Integración: la integración HTTP de la API.
    • Endpoint: la ruta a llamar. Usa variables entre llaves dobles, como /pedidos/.
    • Método: GET, POST, PUT, PATCH o DELETE.
    • Headers (JSON), Body (JSON) y Query Params (JSON), según lo pida la API.
    • Utilizar Pre-request Script y Utilizar Pos-request Script (opcionales): scripts en JavaScript ejecutados antes y después de la llamada. Usa SETVARS({}) para crear variables en el script.
  4. En la sección Respuesta, completa Asignación de propiedades de respuesta a variables (JSON), indicando dónde está cada dato en la respuesta. Ejemplo: { "status_pedido": "data.status" }.
  5. Haz clic en Probar request para ver el resultado de la llamada en la ventana Resultado de la prueba.
  6. Haz clic en Guardar.
Lista de opciones a partir de la respuesta

Marca Generar pregunta de elección con la respuesta para transformar una lista devuelta por la API en un menú de opciones para el contacto. Informa la Propiedad de la respuesta que contiene el array de datos, el Mensaje de la pregunta, la Descripción de la opción de elección (con los atributos entre llaves, como Pedido {id}) y la Asignación de propiedades de la elección a variables (JSON).

4. Decidir el camino ​

  1. Haz clic en el + debajo de la solicitud.
  2. En Herramientas del sistema, elige Condicional.
  3. En Si, elige Variable dinámica.
  4. Elige la Variable asignada en la respuesta (por ejemplo, status_pedido), la Condición y el Valor (por ejemplo, Igual a "entregue").
  5. Haz clic en Guardar y configura los caminos verdadero y falso con mensajes o transferencias.

Resultado esperado ​

El flujo pregunta el dato, consulta la API y responde al contacto según el resultado. Las variables asignadas pueden usarse en los cards siguientes, como Enviar mensaje y Enviar notificación.

Problemas comunes ​

SíntomaQué verificar
La variable no aparece en la lista de otro cardLa variable debe crearse en un card anterior. Las respuestas de preguntas marcadas como Campo con información sensible solo aparecen para el card Solicitud HTTP.
La solicitud no trae los datos esperadosUsa Probar request y verifica el endpoint, el método y la ruta informada en la asignación de la respuesta.
El nombre de la variable es rechazadoUsa lowercase, camelCase o snake_case, sin espacios ni acentos.

Buenas prácticas ​

  • Prueba cada solicitud con Probar request antes de publicar el flujo.
  • Trata el camino de error con un Condicional, para que el contacto no se quede sin respuesta cuando la API falle.
  • Usa nombres de variables que digan lo que guardan, como status_pedido.
  • Marca Campo con información sensible cuando pidas datos personales.

Contenidos relacionados ​