Envía una solicitud HTTP desde un flujo

Para agentes

Guía: Envía una solicitud HTTP desde un flujo

Esta página: https://commentwatchdog.com/help/http-requests/send-an-http-request-from-a-flow

Tema: Solicitudes HTTP

Tiempo: unos 5 minutos

Quién puede hacerlo: Propietario, Administrador o Gestor

Autor: https://anantgupta.xyz (Anant Gupta, fundador de CommentWatchDog)

Empieza en la app: https://app.commentwatchdog.com/es/inbox

Resultado al terminar: Tu flujo envía datos a otro sistema, o los lee de él, y va por el camino Éxito o Error.

Contexto: El paso Solicitud HTTP llama a la API de otro sistema en medio de una conversación: consultar un pedido, revisar un código postal, enviar un lead nuevo a tu CRM. Corre en cualquier punto de un flujo, en Instagram y Facebook. Un solo formulario lo tiene todo: el método y la dirección, la autenticación, un body, parámetros de consulta y headers, con todo lo que sabes de la persona insertado mediante variables. Una buena respuesta va por Éxito; un error, un timeout o ninguna respuesta va por Error, así que la persona nunca se queda esperando.

Antes de empezar

1. El paso Solicitud HTTP viene con el constructor de flujos, en Starter y superiores (y en el pase de DM de 7 días en Mini y Lite).

2. El paso solo llama hacia afuera: otros sistemas no pueden llamar a un flujo.

3. La autenticación es un Bearer token, Basic auth o una API key; las claves se guardan cifradas y no se vuelven a mostrar.

Pasos

Paso 1 de 5: Añade un paso Solicitud HTTP.

Dónde: Abre el flujo en el lienzo. En el panel Pasos de la izquierda, escribe HTTP en Buscar pasos y arrastra Solicitud HTTP al lienzo, o haz clic para añadirlo después del paso seleccionado. En un teléfono, Añadir paso y luego Solicitud HTTP.

Enlace: https://app.commentwatchdog.com/es/inbox (Abrir la app)

Captura de pantalla: https://commentwatchdog.com/media/shots/dm-node-http.es.webp (El paso Solicitud HTTP en el lienzo, con sus ajustes abiertos a la derecha.)

Captura de pantalla: https://commentwatchdog.com/media/shots/dm-node-http-phone.es.webp (Los ajustes del paso en un teléfono.)

Deberías ver: El paso en el lienzo con dos salidas, Éxito y Error, y sus ajustes abiertos al lado.

Paso 2 de 5: Elige el método y escribe la dirección.

Dónde: Debajo de Dirección, cerca de la parte de arriba de los ajustes: el método a la izquierda (GET, que se despliega en POST, PUT, PATCH y DELETE), luego el campo de dirección y luego el botón de variables {x}, que inserta valores que cambian según la persona, por ejemplo https://api.zippopotam.us/mx/{{zip}}. Una variable en la dirección se codifica por ti.

Captura de pantalla: https://commentwatchdog.com/media/shots/dm-node-http.es.webp (La dirección, con la variable {{zip}} dentro; el método a su izquierda, el botón de variables a su derecha.)

Captura de pantalla: https://commentwatchdog.com/media/shots/dm-node-http-phone.es.webp (Lo mismo en un teléfono.)

Deberías ver: El paso en el lienzo muestra el método y la dirección.

Paso 3 de 5: Llena lo que pide la API: autenticación, body, parámetros, headers.

Dónde: El formulario sigue debajo de la dirección, una sección tras otra. Autenticación: Sin autenticación, Bearer token, Basic auth o API key (enviada en un header o en la cadena de consulta). Body (no para GET; un GET envía sus valores como parámetros de consulta): JSON con hasta 40 campos, cada uno enviado como Texto, Número, Verdadero/falso o JSON (un punto en una clave la anida), Formulario, En bruto (JSON, texto plano o XML) o Ninguno. Parámetros de consulta: hasta 20 filas, añadidas a la dirección como key=value. Headers: hasta 20 filas; bloquea una fila para mantener su valor en secreto. Enviar esta fila apaga una fila sin borrarla.

Captura de pantalla: https://commentwatchdog.com/media/shots/dm-node-http.es.webp (Autenticación, la primera sección debajo de la dirección.)

Captura de pantalla: https://commentwatchdog.com/media/shots/dm-node-http-phone.es.webp (Lo mismo en un teléfono.)

Deberías ver: Cada sección se llena conforme avanzas: Agregar un parámetro y Agregar un header cuentan sus filas (0/20, 1/20). Una clave que escribes se guarda cifrada y después dice Guardado y oculto, con Reemplazar.

Paso 4 de 5: Abre Más opciones para el éxito, el límite de tiempo y los reintentos.

Dónde: Más opciones, plegado al final del formulario; su línea muestra las opciones actuales (por ejemplo Solo una respuesta 2xx · 8 s · Una vez). Cuenta como éxito: Solo una respuesta 2xx, o Cualquier respuesta (entonces revisa el código de estado en una Condición). Límite de tiempo: 3, 5, 8 o 10 s (8 por defecto). Reintentar si hay errores: No reintentar, Una vez o Dos veces, cuando no hay respuesta o hay un 5xx, solo para solicitudes que es seguro enviar dos veces.

Captura de pantalla: https://commentwatchdog.com/media/shots/dm-node-http-more.es.webp (Más opciones, al final del formulario, con las opciones actuales en su línea.)

Captura de pantalla: https://commentwatchdog.com/media/shots/dm-node-http-more-phone.es.webp (Lo mismo en un teléfono.)

Deberías ver: La línea de Más opciones muestra lo que elegiste.

Paso 5 de 5: Conecta Éxito y Error.

Dónde: Arrastra desde el punto de Éxito hasta el siguiente paso (un mensaje que usa la respuesta), y desde Error hasta lo que debe pasar en su lugar (avisar a tu equipo, pasar a una persona o un mensaje amable). En un teléfono, elige cada paso en Siguientes pasos, al final de los ajustes. Un camino Error sin nada conectado termina la ejecución como fallida, y la barra te avisa.

Captura de pantalla: https://commentwatchdog.com/media/shots/dm-node-http.es.webp (Los dos caminos del paso, Éxito y Error, cada uno conectado a su siguiente paso.)

Captura de pantalla: https://commentwatchdog.com/media/shots/dm-node-http-more-phone.es.webp (En un teléfono: Éxito y Error debajo de Siguientes pasos, cada uno con el paso al que lleva.)

Deberías ver: Los dos caminos conectados; la barra dice Listo para activar cuando ya no queda nada por corregir.

Si algo no va bien

Problema: Bloqueada

Solución: La dirección apunta a una red privada (o a loopback o a una dirección de metadatos de la nube), así que se rechaza por seguridad. Usa la dirección pública de la API.

Problema: Tiempo agotado

Solución: La API tardó más que el límite de tiempo de Más opciones (10 segundos como máximo). La ejecución fue por el camino Error.

Problema: En pausa tras fallos

Solución: La dirección falló 5 veces seguidas, así que las llamadas se pausan un minuto y luego se vuelve a intentar.

Problema: Dirección no válida

Solución: La dirección no es un enlace http o https válido una vez llenas sus variables. Revisa que la variable tenga un valor en este punto del flujo.

Preguntas frecuentes

Pregunta: ¿Un flujo puede llamar a cualquier API?

Respuesta: Sí, a cualquier API accesible en la internet pública con GET, POST, PUT, PATCH o DELETE, sin autenticación o con un Bearer token, Basic auth o una API key. Las direcciones dentro de redes privadas se rechazan por seguridad.

Pregunta: ¿Otro sistema puede enviar datos a un flujo?

Respuesta: No. El paso Solicitud HTTP solo llama hacia afuera desde un flujo; no hay un webhook entrante que inicie o alimente uno.

Pregunta: ¿Cuánto es lo máximo que puede esperar una solicitud HTTP?

Respuesta: 10 segundos, lo máximo que permite el límite de tiempo (8 por defecto). La gente está a mitad del chat, así que menos es más amable.

Pregunta: ¿Mis claves de API están seguras?

Respuesta: Los valores de autenticación y cualquier fila marcada como secreta se cifran al guardar, quedan ligados a tu cuenta y no se vuelven a mostrar, ni siquiera en el historial de ejecuciones.

Guías relacionadas

Usa la respuesta en tu flujo: https://commentwatchdog.com/help/http-requests/use-the-answer-in-your-flow

Pega un comando cURL: https://commentwatchdog.com/help/http-requests/paste-a-curl-command

Crea la solicitud con IA: https://commentwatchdog.com/help/http-requests/build-the-request-with-ai

Texto plano de esta guía: https://commentwatchdog.com/help/http-requests/send-an-http-request-from-a-flow.md

Todas las guías para asistentes: https://commentwatchdog.com/help/llms.txt