Este paso permite enviar peticiones HTTP y guardar sus respuestas como Variables.
Este paso solo está disponible para el plan 'Business' y más.
Hay dos configuraciones de clave en el paso de petición HTTP:
El método específico requerido para la solicitud. Seleccione el método apropiado de la lista desplegable.
En el campo URL, introduzca el extremo URL de la API externa para recuperar datos. Para incluir variables, utilice el prefijo "$" para soportar la interpolación de texto estático y variables.
Ahora puede utilizar direcciones IP y números de puerto en el paso de petición HTTP, dándole acceso directo a los servidores y flexibilidad para acceder a los servicios en puertos no estándar.
Tenga en cuenta que tanto los dominios respond.io como las etiquetas blancas están en la lista negra. Enviar una llamada API a estos dominios no está permitido, ya que podría causar problemas de bucle.
Para asegurar una correcta decodificación por parte del destinatario de la solicitud, amplíe la sección del Cuerpo e incluya un cuerpo junto con el Encabezado Tipo de Contenido.
En la sección de Encabezado, puede añadir cabeceras a la petición HTTP en pares. La clave representa el nombre de cabecera, y el valor representa el valor de cabecera. Puedes usar Variables como encabezados agregando el prefijo "$". Sin embargo, recuerde que sólo se permiten hasta 10 cabeceras.
Para las respuestas de la API JSON con pares clave-valor, puede guardar elementos de respuesta específicos como variables. En la sección de Mapeo de Respuestas, ingrese la clave del objeto JSON a la izquierda y asigne un nombre a la variable a la derecha. Ten en cuenta que sólo las respuestas JSON pueden ser guardadas, y puedes tener un máximo de 10 opciones de mapeo de respuestas.
Ejemplos:
Para guardar una respuesta en diferentes formatos, rellene la clave JSON correspondiente a los datos que desea guardar.
{
"nombre": "Jason",
"códigos postales": "12345",
"teléfono": "123123"
}Para guardar el número de teléfono de la respuesta anterior, usa $.teléfono como la clave JSON.
{
"campos_personalizados": {
"nombre": "Juan",
"apellido": "Doe",
"configuración regional": "en_GB",
"zona horaria": "5",
"género": "masculino",
"teléfono": "123123",
"correo electrónico": "[email protected]",
"id_cliente": "1"
},
"creado_en": 1575618542
}Para guardar el número de teléfono de la respuesta anterior, usa $.custom_fields.phone
{
"datos": {
"id":"1776025372480910",
"contactos": [
{
"nombre":"Juan",
"apellido":"Doe",
"configuración regional": "en_GB"
},
{
"nombre":"Juana",
"apellido":"Doe",
"configuración regional": "en_GB"
}
]
}
}Para guardar el nombre 'Jane' de la respuesta anterior, usa $.data.contacts[1].firstName.
Para guardar el estado de respuesta de la solicitud HTTP como una variable, activa la opción Guardar estado de respuesta como variable. Luego, nombre la variable en el campo proporcionado.
Cuando se activa, este paso enviará una petición HTTP a la URL especificada, usando el cuerpo definido y la cabecera.
Puede guiar el flujo de trabajo basado en el estado de la respuesta. Por ejemplo, puedes crear una rama para "código de estado es igual a 200". Si se recibe cualquier otro código de estado de respuesta, un paso de salto puede devolver Contactos al paso de petición HTTP. Alternativamente, el Contacto podría ser dirigido a la rama fallida si las condiciones de la rama no se cumplen. Si no hay pasos configurados bajo la rama de fracaso, el flujo de trabajo concluirá.
Si su petición HTTP excede los 10 segundos, resultará en un tiempo de espera que la solicitud falle.
Para evitar posibles fallos en la ejecución de peticiones HTTP, asegúrese de que se cumplen las siguientes condiciones:
Utilice el método HTTP correcto y el Encabezado Content Type.
Asegúrese de incluir el protocolo requerido http:// o https:// en su URL basado en lo que su sistema soporta para evitar el fallo de la solicitud.
Asegúrese de que el Tipo de Contenido es válido.
Excluir el número de puerto de la URL.
Evite usar un certificado autofirmado en la URL.
Verificar que la autorización es válida.
Asegúrese de que nuestras direcciones IP (52.74.35.155, 18.138.31.163, 54.169.155.20) no están bloqueadas.
Si alguna de las condiciones anteriores no se cumple, el Contacto saltará este paso y procederá con el resto del viaje.
Al verificar las salidas de peticiones HTTP con variables dinámicas, recuerda que las variables sin un valor devolverán como nulo y indefinido.
Aquí están algunas buenas prácticas para este paso que puede seguir para optimizar su flujo de trabajo:
Guardar estado de respuesta como una variable:
Asegúrate de que el primer paso es guardar el estado de respuesta como variable para más acciones.
Paso de la rama:
Añadir un paso de rama para evaluar el estado de la petición HTTP.
Si el estado es 200, la solicitud será exitosa.
Si no es así, configure una alerta para notificar al administrador sobre la solicitud fallida.
Google Sheet para monitorear:
Registre el Estado de respuesta en una hoja de Google para una visibilidad clara del éxito o fracaso de las solicitudes.
Comentario:
Añade un comentario en tu flujo de trabajo para documentar el estado de respuesta. Esto le ayudará a rastrear y revisar los errores de forma más eficiente.
Guardar estado de respuesta como una variable:
Similar a la solicitud exitosa, guardar el estado de respuesta como variable para el manejo de errores.
Usa la espera o el salto de paso para reintentos:
Implementar el paso de espera para pausar antes de volver a intentar una solicitud fallida.
Alternativamente, utilice el paso de salto para volver al paso de la solicitud HTTP e intentar la solicitud de nuevo.
Comentario:
Documentar el error creando un comentario para registrar el error de petición HTTP
Incluye los datos de contacto y etiqueta a la persona a cargo.
Google Sheet for Monitoring:
Utilice el paso de la hoja de Google para registrar la información de contacto y los detalles del error para monitorear y revisar.
Tarea:
Asigne la tarea a un usuario específico para iniciar otro proceso dentro del flujo de trabajo y vuelva a intentarlo.
Estas son algunas formas en las que puedes usar el paso de la solicitud HTTP:
Enrutar contactos VIP: utilice el paso de solicitud HTTP para obtener detalles de contacto de un almacén de datos como un CRM. Esto le permite identificar contactos VIP, permitiendo una experiencia personalizada del cliente y distinguiéndolos de contactos no VIP.
Artículos relacionados 👩💻