Producto · Reservas en línea · Para desarrolladores

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.

La notificación en Glue cuando un sitio web manda un pedido: el cliente y la casa, listos para confirmar

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:

  1. Pide un desafío a Glue cuando el visitante empieza a llenar el formulario.
  2. 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.
  3. Manda el resultado en el campo humanCheck junto 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 400 con el código CAPTCHA_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 humanCheck se puede omitir, lo que ayuda mientras desarrollas contra una empresa de prueba.
  • El campo website es 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ó.