URLs de un solo uso
Al generar una URL y enviarla, la app les está indicando a otros que, para responder, envíen los datos a esta URL.
Esto es conveniente para recibir datos desde cualquier lugar y de cualquier persona. Sin embargo, como su nombre lo indica, la URL es de un solo uso. Deberás generar una nueva URL para cada futura recepción de datos. La URL vence después de usarse o al expirar el tiempo (5 a 60 mins, predeterminado: 10 mins).
Una URL de un solo uso consta de 3 partes,
| Parte |
| Descripción |
| --- |
| --- |
| Parámetros (opcional) |
| Para recibir datos y asignarlos a los campos de la app |
| Formularios web (opcional) |
| Para recopilar información adicional mediante un formulario web |
| Página web |
| Para mostrar mensajes de confirmación de las partes anteriores y llamar a un subflow |
Nota: las secciones de Parámetros y Formularios web son opcionales. Puedes tener una URL de un solo uso que solo reciba datos o que solo recopile datos mediante un formulario.
Crear URL de un solo uso
Sigue los pasos del 1 al 5 en la captura de pantalla anterior para editar la URL de un solo uso.
Parámetros
En la sección de parámetros, puedes ver el área Sample Json Payload. Aquí es donde le indicas a la app cómo se verán los datos que se van a recibir. De esa manera, podemos especificar con anticipación dónde guardar los datos recibidos.
Puedes completar el sample JSON payload de estas formas:
- ingresándolo manualmente
- escuchando datos en tiempo real
Por ejemplo, en la captura de pantalla anterior, los datos JSON con 3 valores incluidos se ingresaron manualmente.
Para obtener datos en tiempo real, haz clic en el botón Listen to data payload y copia la URL de ejemplo para hacer pruebas. La URL de un solo uso admite tanto el método GET como POST.
Haz una prueba en vivo y adjunta esta URL de ejemplo. Por ejemplo, en tu navegador, visita:
Verás una página en blanco al presionar Enter, ya que todavía no has diseñado la Página web de confirmación.
Vuelve a la ventana Listen to payload después de la prueba y haz clic en "Done":
Verás tus datos en tiempo real recibidos en el área sample JSON payload.
Haz clic en Preview Payload y asignémoslos a los campos de la app:
Para asignar datos:
1. haz clic en los datos en el área de datos de ejemplo del lado izquierdo
2. la ruta JSON se muestra en el lado derecho
3. crea un nuevo campo escribiendo un nombre nuevo y luego haz clic en ese nombre nuevo, o busca un campo existente
4. haz clic en el botón Add para agregarlo a la lista de asignación
Formularios web
Haz clic en Add Item para comenzar a agregar entradas del formulario web.
| Parámetros |
| Descripción |
| --- |
| --- |
| Unique Name |
| Debe ser único entre todas las entradas de autenticación; no puedes insertar espacios. Usa guiones bajos o guiones medios para separar palabras |
| Type |
| Elige String para texto sin saltos de línea, Number para números enteros o decimales, Text para texto con saltos de línea, Select para entrada con origen estático o dinámico |
| Title |
| El título se muestra en la interfaz de usuario |
| Required? |
| ¿Esta entrada es obligatoria? Si no lo es, desactívala y proporciona un valor predeterminado si es necesario |
| Save to App Field |
| Especifica dónde almacenar el valor. Crea un nuevo campo de la app aquí mismo escribiendo un nuevo nombre de campo y seleccionando un tipo de campo en la ventana emergente, o busca un campo existente |
| Placeholder |
| Texto de ayuda en gris que se muestra en el cuadro de entrada |
| Description |
| Texto de ayuda en negro que se muestra debajo del cuadro de entrada |
Agrega tantas entradas al formulario web como necesites y haz clic en Save cuando termines. Revisa el área Preview.
Página web
Diseña una página web sencilla para mostrar mensajes de confirmación.
Elige un tiempo de expiración de URL para tu enlace de un solo uso, de 5 a 60 minutos. De forma predeterminada, el enlace vence en 10 minutos.
Por último, selecciona un subflow para ejecutar después de que se muestre la página web.
Por lo general, disparamos un trigger en este subflow para notificar a los chatbots sobre la actualización.
Generar URL de un solo uso
Usa un Action Step para generar la URL y guardarla en un campo de la app para enviarla más tarde.