Reservas en línea para desarrolladores web
Cómo el sitio web de una empresa manda pedidos de limpieza a Glue. El enlace, el código para insertar, y el endpoint, los campos y la prueba humana para un sitio con su propio formulario.

Escrito para: la persona que hace o mantiene el sitio web de una empresa. La guía del dueño es la página de reservas en línea.
La tercera de tres formas de recibir pedidos: un sitio con su propio formulario, quizá una calculadora de precios, mandando sus respuestas directo a Glue. Las otras dos no necesitan código: compartir el enlace y poner el formulario en el sitio. La empresa primero elige un nombre corto en su pestaña Booking, explicado en esas páginas. Tu formulario funciona esté o no activa su página alojada.
Enviar desde tu propio formulario
POST https://useglueapp.com/nodejs/book/<slug>
Content-Type: application/json
Los nombres de campo y valores son los del inglés; la tabla es la misma.
| Field | Required | Values |
|---|---|---|
name |
yes | the visitor's name, 2 to 80 characters |
email |
yes | a valid e-mail; a known customer's e-mail attaches the request to them |
phone |
no | digits, spaces, parentheses and dashes |
address |
one of address or zipcode |
street and number |
unit |
no | apartment or suite |
city |
no | |
zipcode |
one of address or zipcode |
|
serviceType |
no | residential (default), commercial, rental |
cleaningType |
no | regular (default), deep |
serviceDate |
no | YYYY-MM-DD, today or later. With a day, the request also becomes an order on the calendar; without one, only the customer and the quote facility are created |
bedrooms, bathrooms |
no | numbers; bathrooms accepts halves |
rooms |
no | number, for commercial places |
squareFeet |
no | number |
pet |
no | yes or no |
frequency |
no | one_time, weekly, biweekly, monthly |
timePreference |
no | morning, afternoon |
estimatedPrice |
no | the price the site's own calculator showed, in dollars; it lands on the facility as its estimate |
note |
no | up to 500 characters |
humanCheck |
in production | the ALTCHA solution, see below |
website |
no | honeypot: leave it out or empty; anything in it is treated as a bot |
Respuestas:
| Status | Body | Meaning |
|---|---|---|
| 200 | { "success": true } |
received; the company was notified |
| 400 | { "code": "VALIDATION_ERROR", "message": "…" } |
show message to the visitor as is |
| 400 | { "code": "CAPTCHA_FAILED", "message": "…" } |
the human check failed; solve a fresh one and retry |
| 404 | { "code": "NOT_FOUND" } |
unknown slug |
| 429 | too many requests from one address; wait |
Dos límites dejan la basura afuera: un email puede mandar 3 pedidos por día, y la página de una empresa recibe 40 por día; después responde 400 con un mensaje hasta el día siguiente y la empresa se entera. Un pedido nunca es una orden: la empresa confirma el precio y el día primero.
Estos endpoints responden a cualquier origen, así que no hace falta configurar nada del lado de Glue para un sitio nuevo: la prueba humana y el límite de frecuencia son la barrera. No mandes cookies con el pedido.
La prueba humana
Glue rechaza un pedido que no demuestra que un navegador hizo el trabajo, la misma barrera que usa su propio login. No hay widget, ni casilla, ni nada que el visitante vea. Tu código hace tres cosas:
- Pide un desafío a Glue cuando el visitante empieza a llenar el formulario.
- Lo resuelve con la librería
altcha-lib. Tarda más o menos un segundo en una laptop y corre en segundo plano mientras el visitante escribe. - Manda el resultado en el campo
humanCheckjunto con el resto del formulario.
Esto corre en el navegador del visitante, así que la librería va en el frontend del sitio, junto al formulario: npm install altcha-lib, o una etiqueta <script type="module"> desde un CDN. El navegador manda el formulario directo a Glue. Si tu formulario pasa primero por tu propio backend, deja la resolución en el navegador y pasa la cadena humanCheck tal cual: resolverla en un servidor no demuestra nada y gasta el límite de pedidos de tu propio servidor. Después:
import { solveChallenge } from "altcha-lib";
import { deriveKey } from "altcha-lib/algorithms/web/pbkdf2";
const base = "https://useglueapp.com/nodejs";
// Lo que junta el formulario. Obligatorios: name y email. El resto decide qué crea Glue.
const form = {
name: "Rana Duarte",
email: "rana@example.com",
phone: "(954) 555-0101", // opcional
address: "1200 SE 17th Street", // opcional; con calle o código postal se crea o se encuentra la casa
city: "Fort Lauderdale", // opcional
zipcode: "33316", // opcional
serviceType: "residential", // opcional: residential, commercial, rental
cleaningType: "regular", // opcional: regular, deep
serviceDate: "2026-10-24", // opcional, YYYY-MM-DD; con él el pedido entra al calendario
timePreference: "morning", // opcional: morning, afternoon
note: "Gate code 1234", // opcional
};
// 1. Ask Glue for a challenge. Do it when the visitor starts filling the form.
const challenge = await (
await fetch(`${base}/humanCheck/challenge?action=booking`)
).json();
// 2. Solve it. About a second, in the background.
const solution = await solveChallenge({ challenge, deriveKey, timeout: 60_000 });
// 3. Pack both into one string and send it with the form.
const humanCheck = btoa(JSON.stringify({ challenge, solution }));
await fetch(`${base}/book/<slug>`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ ...form, humanCheck }),
});
Reglas a tener en cuenta:
- Un desafío sirve una sola vez y durante diez minutos. Si el visitante tarda más, o toca Enviar dos veces, pide uno nuevo. Uno usado o vencido responde
400con el códigoCAPTCHA_FAILED; muestra el mensaje y reintenta con un desafío nuevo. - El desafío está firmado para el formulario
booking; uno pedido para otro formulario se rechaza. - Fuera de producción la prueba está apagada y
humanCheckse puede omitir, lo que ayuda mientras desarrollas contra una empresa de prueba. - El campo
websitees un señuelo: no lo muestres como campo real, y no lo mandes, o mándalo vacío.
Mensajes desde un formulario de contacto
La misma dirección con /contact recibe un mensaje simple y no crea nada en Glue: ni cliente ni prospecto. Los gerentes reciben una notificación, un email del tipo "Pedidos del sitio web" y un texto, y responden desde su propia bandeja.
POST https://useglueapp.com/nodejs/book/<slug>/contact
Content-Type: application/json
| Campo | Obligatorio | Valores |
|---|---|---|
name |
sí | de 2 a 80 caracteres |
email |
sí | un email válido, adonde va la respuesta |
phone |
no | |
message |
sí | hasta 1000 caracteres |
humanCheck |
en producción | la misma solución ALTCHA de arriba |
Mismas respuestas, misma prueba humana, mismos topes diarios, compartidos con los pedidos.
Qué pasa en Glue
Una llamada hace hasta tres cosas, según lo que trae:
- El cliente. Se busca por email, o se crea como un cliente activo normal; solo la casa lleva el estado "cotización". No puede iniciar sesión hasta que la empresa le da la bienvenida. Solo nombre y email crean un contacto al que la empresa llama.
- La casa. Con calle o código postal: la casa que el cliente ya tiene en esa calle y código, si la tiene; si no, una casa nueva con estado "cotización" con el nombre del visitante ("Casa de Rana"), marcada en el mapa cuando Google conoce la dirección. Manda el número junto con la calle ("1200 SE 17th Street"); Glue los separa. Sin lugar, un cliente conocido con una sola casa recibe esa.
- La orden. Con día y casa, una orden "Pedida" espera en el calendario; planificarla (equipo y hora) la confirma al cliente. Sin día, la empresa crea las órdenes después de confirmar la cotización.
De todas formas los gerentes reciben una notificación en la campana que abre el lugar correcto (el cliente con "Confirmar cotización", la orden o la casa), un email del tipo "Pedidos del sitio web" y un mensaje al teléfono de notificaciones. El email va a las direcciones de la tarjeta "Who gets booking requests" de la pestaña Booking, o a la dirección de la empresa si no se agregó ninguna; al responderlo le llega al visitante. Cada pedido queda registrado con lo que creó.