Run it by
DocumentationRéférence de l’APITarifsArticles
FR
EnglishEspañolPortuguêsFrançaisDeutschItaliano日本語中文
Se connecterObtenir une clé API

Dans cet article

Le problèmeLe principe : un schéma en entrée, un lien en sortie, du JSON en retourExemple : un devis de plombierUne personne, plusieurs, ou n’importe quiOù cela s’appliqueTous les articles

Cas d’usage

Comment obtenir des données structurées d’une personne que votre agent ne peut pas joindre par chat

27 oct. 2026 · 6 min de lecture

Le problème

La plupart des agents ne parlent qu’à une personne : celle qui tape dans le chat. Les vraies tâches demandent plus de monde. Un agent de gestion locative a besoin des disponibilités et du devis d’un plombier. Un agent de recrutement a besoin de la date de début d’un candidat. Un agent de support a besoin de la nouvelle adresse d’un client. Aucun d’eux n’est dans la conversation, et aucun ne veut installer quoi que ce soit ni s’inscrire pour répondre à une seule question.

Les contournements habituels : un fil d’e-mails que l’agent doit analyser (« mardi ça marche, peut-être mercredi, autour de 300 ? »), un Google Form que quelqu’un monte à la main pour chaque nouvelle question, ou une page sur mesure que votre équipe construit puis doit maintenir.

Le principe : un schéma en entrée, un lien en sortie, du JSON en retour

Run it by transforme la question en lien. Votre agent décrit ce dont il a besoin sous forme de JSON Schema, le format qu’il utilise déjà pour les appels d’outils, et reçoit une URL. La personne l’ouvre sur son téléphone, remplit un court formulaire sans inscription, et la réponse revient à votre agent en JSON déjà conforme au schéma.

  1. Demandez. Appelez createRequest (outil MCP ou POST /v1/requests) avec un schéma et les personnes qui doivent répondre.
  2. Envoyez. La réponse contient un lien par personne. Passez sendEmail: true et nous envoyons à chacun son propre lien par e-mail en votre nom, ou transmettez-le par un canal que vous avez déjà : SMS, WhatsApp, Slack.
  3. Récupérez la réponse. Avec Builder et Pro, MCP push prévient votre agent à l’instant où elle arrive, pour qu’il poursuive tout seul. Elle arrive aussi sur votre webhook, dans un e-mail pour vous, ou l’agent la lit avec getStatus. Voir laisser votre agent agir dès que quelqu’un répond.

Exemple : un devis de plombier

Un agent de gestion immobilière doit faire réparer une fuite. Il demande au plombier la première date possible, un prix et tout ce qu’il devrait savoir :

{
  "mode": "form",
  "title": "Leak at 14 Elm St, unit 3",
  "requester": "Ava (the Elm Properties maintenance agent)",
  "audience": { "kind": "named", "recipients": [{ "name": "Sam Ortiz", "phone": "+1 415 555 0100" }] },
  "schema": {
    "type": "object",
    "required": ["earliestDate", "quote"],
    "properties": {
      "earliestDate": { "type": "string", "format": "date", "title": "Earliest day you can come" },
      "quote": { "type": "number", "minimum": 0, "title": "Estimate (USD)" },
      "notes": { "type": "string", "title": "Anything we should know?", "x-runitby": { "widget": "textarea" } }
    }
  },
  "expiresIn": "48h",
  "webhookUrl": "https://example.com/hooks/runitby"
}

Sam reçoit un lien par SMS, voit qui demande (le nom vérifié du compte figure sur chaque page, quel que soit le nom que se donne l’agent), choisit une date, saisit un nombre et envoie. Votre webhook reçoit :

{
  "event": "response.created",
  "recipient": { "name": "Sam Ortiz" },
  "response": { "data": { "earliestDate": "2026-11-03", "quote": 280, "notes": "Bring access to the basement." } }
}

Pas d’analyse de texte, pas de relance « pardon, quel mardi ? ». La date est une date et le devis est un nombre, parce que le formulaire n’accepterait rien d’autre.

Une personne, plusieurs, ou n’importe qui

  • Les destinataires nommés (de 1 à 50) reçoivent chacun leur propre lien, si bien que chaque réponse est attribuée à une personne. Ajoutez une adresse e-mail et l’agent peut envoyer des relances.
  • Un lien ouvert accepte les réponses de toute personne qui l’a, jusqu’à maxSubmissions. Utilisez-le pour des inscriptions ou une enquête rapide dans l’équipe.
  • Les approbations sont la version oui ou non, avec une règle sur le nombre de personnes qui doivent être d’accord. Voir les approbations avant que votre agent dépense de l’argent.

Où cela s’applique

  • Devis et disponibilités de prestataires, de fournisseurs ou de lieux.
  • Informations manquantes auprès de clients : adresse de livraison, préférences de commande, description d’un problème sans photo.
  • Informations d’intégration d’un nouvel employé ou d’un nouveau client : date de début, pays du numéro fiscal, matériel préféré.
  • Accord d’un propriétaire, d’un parent ou d’un responsable qui n’ouvrira jamais votre appli.
  • Recueillir les mêmes quelques réponses auprès d’une équipe, sans outil d’enquête.

Si la personne dont vous avez besoin est celle qui discute déjà avec votre agent, vous n’avez peut-être pas besoin de lien : certains clients MCP peuvent lui poser la question directement. Nous comparons les deux dans Run it by face au fait maison et à l’élicitation MCP.

Essayez avec votre agent

Gratuit jusqu’à 250 demandes par mois, sans carte. Ajoutez le serveur MCP depuis Claude Code ou Codex en une commande, ou utilisez l’API REST.

Commencer gratuitementLire la documentation

Run it by

Obtenez des données structurées d’une personne grâce à un lien.

Produit

DocumentationTarifsArticles

Pour les agents

Configuration MCPRéférence de l’APIllms.txtopenapi.json

Mentions légales

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