La solicitud externa (función Pro) te permite establecer una conexión con cualquier integración a través de una solicitud HTTP en caso de que nuestras integraciones nativas no admitan tu caso particular. En este artículo cubriremos:
Tipos de datos y métodos admitidos
Esta función permite enviar a un servidor externo diferentes tipos de datos, incluidos datos de contacto, como:
- Estado del contacto
- Nombre
- Apellido
- Nombre completo
- Género
- Idioma
- Zona horaria
- URL de Live Chat
- Campos de usuario personalizados
Los métodos HTTP admitidos son POST, GET, PUT y DELETE.
Cómo configurar una solicitud externa
Para crear una solicitud externa, agrega un bloque de acción a tu automatización:
A continuación, ve a Automation (Automatización) → Make External Request (Realizar solicitud externa):
Una vez que hagas clic en Add your request (Agregar tu solicitud), se abrirá la ventana de configuración:
En la ventana de configuración, podrás seleccionar un tipo de solicitud (POST, GET, PUT, DELETE):
Después de especificar el tipo de solicitud, deberás ingresar la URL de solicitud y completar los encabezados si es necesario.
⚠️ Nota: sólo se permiten vínculos HTTPS.
Si vas a enviar una solicitud POST o PUT, el siguiente paso es completar el cuerpo de la solicitud en formato JSON. A continuación se muestra un ejemplo:
{
"id": 123456,
"first_name": "John",
"last_name": "Doe",
"email": "me@mail.com"
}
Una vez hecho esto, puedes probar tu solicitud seleccionando un contacto para probar, luego cambia a la pestaña Response (Respuesta) y haz clic en el botón Test Request (Probar solicitud):
Si todo está configurado correctamente, obtendrás un código HTTP 200 como este:
Ejemplo de un caso de uso
Hay un buen servicio gratuito de pruebas de API llamado SWAPI, así que vamos a crear una automatización de respuesta predeterminada para los fanáticos de Star Wars. Queremos obtener el título de la película y el rastreo de apertura enviando cualquier palabra en un mensaje a la página de Facebook. Si la palabra está en el título, la página responderá con la información mencionada.
En primer lugar, crea dos campos de usuario personalizados de tipo texto para el título y el texto de apertura. Luego, ve a la automatización de respuesta predeterminada, crea un bloque de acción y selecciona una solicitud externa.
Realizaremos una solicitud GET https://swapi.co/api/films/?search= para buscar una película con el último texto ingresado por un contacto adjunto al final del vínculo. Por último, debemos especificar las JSON Paths (rutas JSON) en la pestaña de mapeo de respuesta para guardar los valores del título de la película y el rastreo de apertura de la respuesta de los campos de usuario personalizados correspondientes.
Luego de guardar los cambios y poner en marcha la automatización, esto es lo que veremos en Facebook Messenger: