Public API

curl https://justagoodguy.us/api/public/config -H "X-GG-Key: pk_your_key"

{
  "business": { "name": "Joe's Plumbing", "slug": "joes-plumbing", "phone": "+15555550100", "timezone": "America/Chicago", "bookingPageUrl": "https://justagoodguy.us/b/joes-plumbing" },
  "widget": { "color": "#3346D3", "position": "right", "label": "Book or ask a question", "showOnMobile": true },
  "assistantName": "Assistant",
  "greeting": "Hi! I’m Joe's Plumbing’s assistant. I can answer questions or book you in.",
  "ai": true,
  "openNow": true,
  "callNow": false,
  "allowPickStaff": true,
  "turnstileSiteKey": null,
  "siteId": null,
  "practiceAi": false,
  "hours": {
    "booking": [{ "weekday": 1, "label": "Monday", "ranges": [{ "startMin": 480, "endMin": 1020, "label": "8:00 AM – 5:00 PM" }] }],
    "calls": []
  },
  "address": "12 Main St, Springfield, IL, 62701"
}

{
  "services": [
    { "id": "svc_2n4p6r8t0v1x3z5b", "name": "Drain cleaning", "description": null, "kind": "visit", "durationMin": 60, "priceLabel": "From $120", "staff": [{ "id": "stf_9h7f5d3b1z0x8v6t", "name": "Joe" }] }
  ]
}

{
  "timezone": "America/Chicago",
  "days": [
    { "date": "2026-11-03", "label": "Tuesday, Nov 3", "slots": [{ "start": 1793718000000, "staffIds": ["stf_9h7f5d3b1z0x8v6t"], "label": "9:00 AM" }] }
  ]
}

{
  "serviceId": "svc_2n4p6r8t0v1x3z5b",
  "staffId": "stf_9h7f5d3b1z0x8v6t",
  "start": 1793718000000,
  "sessionId": null,
  "customer": { "name": "Sam Lee", "phone": "+15555550123", "email": "" },
  "notes": "Side gate is open",
  "address": { "line1": "12 Oak Ave", "postal": "62704" },
  "source": "widget"
}

{
  "booking": {
    "id": "bkg_8f3k2m9q1x7w4r6t",
    "status": "confirmed",
    "whenLabel": "Tuesday, Nov 3 at 9:00 AM",
    "serviceName": "Drain cleaning",
    "staffName": "Joe",
    "manageUrl": "https://justagoodguy.us/m/…"
  }
}

{ "callNow": false, "windows": [{ "start": 1793725200000, "end": 1793732400000, "label": "Tuesday, Nov 3 at 11:00 AM – 1:00 PM" }] }

{ "callback": { "id": "cbk_3j5l7n9q1s3u5w7y", "windowLabel": "Tuesday, Nov 3 at 11:00 AM – 1:00 PM" } }

navigator.sendBeacon('https://justagoodguy.us/api/public/events', JSON.stringify({ key: 'pk_your_key', type: 'page_view', url: location.href, referrer: document.referrer }));

event: start
data: {"type":"start","conversationId":"cnv_5b7d9f1h3k5m7p9r","messageId":""}

event: status
data: {"type":"status","text":"Checking open times…"}

event: delta
data: {"type":"delta","text":"Here are the next open times"}

event: card
data: {"type":"card","card":{"type":"slots","serviceId":"svc_2n4p6r8t0v1x3z5b","serviceName":"Haircut","staffId":null,"timezone":"America/New_York","days":[]}}

event: done
data: {"type":"done","messageId":"msg_0a2c4e6g8j0l2n4q"}

async function chat({ message, visitorToken, conversationId }, onEvent) {
  const res = await fetch('https://justagoodguy.us/api/public/chat', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'X-GG-Key': 'pk_your_key' },
    body: JSON.stringify({ message, visitorToken, conversationId }),
  });
  if (!res.ok) throw new Error((await res.json()).error);

  const reader = res.body.pipeThrough(new TextDecoderStream()).getReader();
  let buffer = '';
  for (;;) {
    const { value, done } = await reader.read();
    if (done) break;
    buffer += value;
    let end;
    while ((end = buffer.indexOf('\n\n')) >= 0) {
      const block = buffer.slice(0, end);
      buffer = buffer.slice(end + 2);
      const data = block.split('\n').filter((l) => l.startsWith('data:')).map((l) => l.slice(5).trim()).join('\n');
      if (!data) continue;
      const event = JSON.parse(data);
      if (event.type !== undefined) onEvent(event);
    }
  }
}

{
  "conversationId": "cnv_5b7d9f1h3k5m7p9r",
  "humanTakeover": false,
  "messages": [
    { "id": "msg_…", "role": "user", "content": "Do you have anything Saturday?", "cards": [], "createdAt": 1793700000000 },
    { "id": "msg_…", "role": "assistant", "content": "Saturday has a few times open.", "cards": [{ "type": "slots", "...": "..." }], "createdAt": 1793700002000 }
  ]
}

event: message
data: {"id":"msg_…","role":"owner","content":"Hi Sam, yes we can fit you in at 10.","author":"Joe"}