Este paso permite enviar solicitudes HTTP y guardar sus respuestas como variables.
Este paso solo está disponible para el plan Business y superiores.
Configuración
Hay dos configuraciones clave en el paso de solicitud HTTP:
Método de solicitud HTTP
El método específico requerido para la solicitud. Elige el método apropiado de la lista desplegable.
URL
En el campo URL, ingrese el punto final de la URL de la API externa para recuperar datos. Para incluir variables, utilice el prefijo "$" para admitir la interpolación de texto estático y variables.
Ahora puede utilizar direcciones IP y números de puerto en el paso de solicitud HTTP, lo que le brinda acceso directo a los servidores y flexibilidad para acceder a servicios en puertos no estándar.
Tenga en cuenta que tanto respond.io como los dominios de marca blanca están en la lista negra. No está permitido enviar una llamada API a estos dominios, ya que podría causar problemas de bucle.
Cuerpo
Para garantizar una decodificación correcta por parte del destinatario de la solicitud, expanda la sección Cuerpo e incluya un cuerpo junto con el encabezado Content-Type.
Encabezados
En la sección Encabezado, puedes agregar encabezados a la solicitud HTTP en pares. La clave representa el nombre del encabezado y el valor representa el valor del encabezado. Puede utilizar variables como encabezados agregando el prefijo "$". Sin embargo, recuerda que solo se permiten hasta 10 encabezados.
Mapeo de respuestas
Para las respuestas de API JSON con pares clave-valor, puede guardar elementos de respuesta específicos como variables. En la sección Mapeo de respuesta, ingrese la clave del objeto JSON a la izquierda y asigne un nombre a la variable a la derecha. Tenga en cuenta que solo se pueden guardar respuestas JSON y que puede tener un máximo de 10 configuraciones de mapeo de respuestas.
Ejemplos:
Para guardar una respuesta en diferentes formatos, complete 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, utilice $.phone como 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": "zy@respond.io",
"id_cliente": "1"
},
"creado_en": 1575618542
}Para guardar el número de teléfono de la respuesta anterior, use $.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, use $.data.contacts[1].firstName.
Guardar estado de respuesta como variable
Para guardar el estado de respuesta de la solicitud HTTP como una variable, active el interruptor Guardar estado de respuesta como variable . Luego, nombre la Variable en el campo provisto.
Cómo funciona
Cuando se activa, este paso enviará una solicitud HTTP a la URL especificada, utilizando el cuerpo y el encabezado definidos.
Puede guiar el flujo de trabajo en función del estado de la respuesta. Por ejemplo, puedes crear una rama para el "código de estado igual a 200". Si se recibe cualquier otro código de estado de respuesta, un paso de salto podría devolver los contactos al paso de solicitud HTTP. Alternativamente, el contacto podría ser dirigido a la Rama de Fallas si no se cumplen las condiciones de la Rama. Si no hay pasos configurados en la rama de fallos, el flujo de trabajo concluirá.
Si tu solicitud HTTP excede los 10 segundos, se producirá un tiempo de espera, haciendo que la solicitud falle.
Falla potencial
Para evitar posibles fallos en la ejecución de solicitudes HTTP, asegúrese de que se cumplan las siguientes condiciones:
Utilice el método HTTP y el encabezado Content-Type correctos.
Asegúrese de incluir el protocolo requerido
http://ohttps://en su URL según lo que admita su sistema para evitar fallas en la solicitud.Asegúrese de que el tipo de contenido sea válido.
Excluir el número de puerto de la URL.
Evite utilizar un certificado autofirmado en la URL.
Verificar que la autorización sea 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 no se cumple alguna de las condiciones anteriores, el Contacto omitirá este paso y continuará con el resto del viaje.
Al verificar las salidas de solicitudes HTTP con variables dinámicas, recuerde que las variables sin un valor regresarán como null y undefined.
Mejores prácticas
A continuación se muestran algunas prácticas recomendadas para este paso que puede seguir para optimizar su flujo de trabajo:
Cuando la solicitud HTTP es exitosa
Guardar el estado de respuesta como una variable:
Asegúrese de que el primer paso sea guardar el estado de respuesta como variable para futuras acciones.
Paso de rama:
Agregue un paso de rama para evaluar el estado de la solicitud HTTP.
Si el estado es
200, la solicitud es exitosa.En caso contrario, configure una alerta para notificar al administrador sobre la solicitud fallida.
Hoja de cálculo de Google para monitoreo:
Registre el estado de respuesta en una hoja de Google para tener una visibilidad clara del éxito o el fracaso de las solicitudes.
Comentario:
Agregue un comentario en su flujo de trabajo para documentar el estado de respuesta. Esto le ayudará a rastrear y revisar errores de manera más eficiente.
Cuando falla la solicitud HTTP
Guardar el estado de respuesta como una variable:
De manera similar a la solicitud exitosa, guarda el estado de respuesta como variable para el manejo de errores.
Usar esperar o saltar paso para reintentos:
Implemente el paso de espera para hacer una pausa antes de volver a intentar una solicitud fallida.
Como alternativa, utilice el paso de salto para regresar al paso de solicitud HTTP e intentar la solicitud nuevamente.
Comentario:
Documente el error creando un comentario para registrar el error de solicitud HTTP
Incluya datos de contacto y etiquete a la persona a cargo.
Hoja de cálculo de Google para monitoreo:
Utilice Google Sheet Step para registrar la información de contacto y los detalles de errores para su seguimiento y revisión.
Asignación de tarea:
Asignar la tarea a un usuario específico para iniciar otro proceso dentro del flujo de trabajo e intentarlo nuevamente.
Casos de uso sugeridos
A continuación se muestran algunas formas en las que puede utilizar el paso de 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, lo que permite una experiencia personalizada del cliente y los distingue de los contactos que no son VIP.
