Colete dados de entrega e de agendamento dos clientes sem um criador de formulários

A última milha de uma conversa de suporte

Seu agente de suporte combinou de enviar uma peça de reposição. Agora precisa de um endereço, de um período de entrega e talvez de um telefone para o entregador. Pedir isso em texto livre significa validar depois. Construir um formulário significa alguém abrir um criador de formulários para uma pergunta que o agente inventou um minuto atrás.

Peça exatamente o que o entregador precisa

{
  "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" }
}

O schema é o formulário. Widgets como location, chips ou slots escolhem um controle melhor onde campos simples seriam desajeitados; a lista completa está nos tipos de campo.

sendEmail: true envia o link a Jordan por e-mail em nome da sua empresa, então o agente não precisa ter uma configuração de e-mail própria. Prefere SMS ou o seu próprio chat? Deixe desligado e mande você mesmo o link que vem na resposta.

Deixe com a sua cara

Um theme define cores, fontes, arredondamento dos cantos, um logo e o texto acima e abaixo do formulário, para que a página pareça parte do seu produto. layout: "single" mostra uma pergunta por vez, o que parece mais uma conversa no celular.

Antes de enviar um formulário a muitos clientes, chame previewRequest: ele devolve capturas de tela na largura de celular e de desktop e uma lista de tudo o que vai ficar ruim de ler, sem criar nada.

O que volta

Quando Jordan envia o formulário, seu webhook recebe response.created com os dados já conferidos com o schema, mais o seu metadata, para o handler anexar o endereço ao chamado T-1042 e chamar o entregador. Sem servidor? No Builder e no Pro, um agente conectado por MCP pode assinar a solicitação e é avisado no instante em que Jordan responde, e então chama o entregador por conta própria. Se Jordan não tiver respondido até amanhã, remind envia o link por e-mail de novo.

O link deixa de funcionar quando expira ou quando você encerra a solicitação, e as respostas são excluídas 30 ou 90 dias após a entrega nos planos Free e Builder.

Por que não um criador de formulários?

Os criadores de formulários são ótimos quando uma pessoa desenha um formulário uma vez e o compartilha muitas vezes. Aqui, o agente inventa a pergunta na hora, precisa de uma resposta de uma pessoa e a quer como dado tipado. É esse o caso para o qual o Run it by foi feito. O comparativo mais longo está em Run it by vs Typeform, Tally, Fillout e Google Forms.