Caso d’uso
Raccogliere dati di spedizione e di prenotazione dai clienti senza un form builder
27 ott 2026 · 5 min di lettura
L’ultimo miglio di una conversazione di assistenza
Il tuo agente di assistenza ha accettato di spedire un ricambio. Ora gli servono un indirizzo, una fascia oraria di consegna e magari un numero di telefono per il corriere. Chiederli in testo libero significa doverli validare dopo. Costruire un modulo significa che qualcuno apre un form builder per una domanda che l’agente ha pensato un minuto fa.
Chiedi esattamente ciò che serve al corriere
{
"mode": "form",
"title": "Where should we send your replacement?",
"requester": "Ava (the Acme support agent)",
"audience": { "kind": "named", "recipients": [{ "name": "Jordan Lee", "email": "jordan@example.com" }] },
"schema": {
"type": "object",
"required": ["address", "window"],
"properties": {
"address": { "type": "object", "title": "Delivery address", "x-runitby": { "widget": "location" } },
"window": { "enum": ["morning", "afternoon", "evening"], "title": "Best time", "x-runitby": { "widget": "chips" } },
"phone": { "type": "string", "format": "tel", "title": "Phone for the courier" }
}
},
"theme": {
"accent": "#B4532A",
"heroText": "Hi Jordan, I need a few details to ship your replacement part.",
"thankYou": "Thanks! It ships within 2 business days."
},
"expiresIn": "7d",
"sendEmail": true,
"webhookUrl": "https://example.com/hooks/runitby",
"metadata": { "ticket": "T-1042" }
}
Lo schema è il modulo. Widget come location, chips o slots scelgono un controllo migliore dove un normale campo sarebbe scomodo; l’elenco completo è nei tipi di campo.
sendEmail: true manda a Jordan il link per email a nome della tua azienda, così l’agente non ha bisogno di una configurazione di posta propria. Preferisci SMS o la tua chat? Lascialo disattivato e invia tu il link presente nella risposta.
Fallo sembrare tuo
Un theme imposta colori, font, raggio degli angoli, un logo e il testo sopra e sotto il modulo, così la pagina sembra parte del tuo prodotto. layout: "single" mostra una domanda alla volta, che dal telefono somiglia di più a una conversazione.
Prima di mandare un modulo a molti clienti, chiama previewRequest: restituisce screenshot in formato telefono e desktop e un elenco di tutto ciò che si leggerà male, senza creare nulla.
Cosa ti torna indietro
Quando Jordan invia il modulo, il tuo webhook riceve response.created con i dati già verificati rispetto allo schema, più i tuoi metadata, così il gestore può associare l’indirizzo al ticket T-1042 e prenotare il corriere. Nessun server? Su Builder e Pro, un agente collegato via MCP può iscriversi alla richiesta e viene avvisato nell’istante in cui Jordan risponde, poi prenota il corriere da solo. Se Jordan non ha risposto entro domani, remind gli rimanda il link per email.
Il link smette di funzionare quando scade o quando chiudi la richiesta, e le risposte vengono eliminate 30 o 90 giorni dopo la consegna sui piani Free e Builder.
Perché non un form builder?
I form builder vanno benissimo quando una persona progetta un modulo una volta e lo condivide molte volte. Qui l’agente inventa la domanda al momento, ha bisogno di una risposta da una sola persona e la vuole come dato tipizzato. È il caso per cui è fatto Run it by. Il confronto più lungo è in Run it by e Typeform, Tally, Fillout e Google Forms.
Provalo con il tuo agente
Gratis fino a 250 richieste al mese, senza carta. Aggiungi il server MCP da Claude Code o Codex con un solo comando, oppure usa l’API REST.