Run it by
DocumentazioneRiferimento APIPrezziArticoli
IT
EnglishEspañolPortuguêsFrançaisDeutschItaliano日本語中文
AccediOttieni una chiave API

In questo articolo

L’ultimo miglio di una conversazione di assistenzaChiedi esattamente ciò che serve al corriereFallo sembrare tuoCosa ti torna indietroPerché non un form builder?Tutti gli articoli

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.

Inizia gratisLeggi la documentazione

Run it by

Ottieni dati strutturati da una persona con un link.

Prodotto

DocumentazionePrezziArticoli

Per gli agenti

Configurazione MCPRiferimento APIllms.txtopenapi.json

Note legali

PrivacyTermini
© 2026 Run it by
EnglishEspañolPortuguêsFrançaisDeutschItaliano日本語中文