Chat — Cookbook

// POST /api/chat-token  →  { token, conversation, expiresAt }
export async function mintChatToken(orgId: string) {
  const res = await fetch("https://engine.clutchcall.dev/v1/chat/tokens", {
    method: "POST",
    headers: {
      "authorization": `Bearer ${process.env.CLUTCHCALL_CREDENTIALS}`,
      "content-type": "application/json",
    },
    body: JSON.stringify({
      org: orgId,
      flow: "support",       // the flow/step program to run
      ttlSec: 900,           // token lifetime
    }),
  });
  if (!res.ok) throw new Error(`mint failed: ${res.status}`);
  return res.json(); // { token, conversation, expiresAt }
}

import os, requests

def mint_chat_token(org_id: str) -> dict:
    res = requests.post(
        "https://engine.clutchcall.dev/v1/chat/tokens",
        headers={"authorization": f"Bearer {os.environ['CLUTCHCALL_CREDENTIALS']}"},
        json={"org": org_id, "flow": "support", "ttlSec": 900},
        timeout=10,
    )
    res.raise_for_status()
    return res.json()  # { token, conversation, expiresAt }

curl -sX POST https://engine.clutchcall.dev/v1/chat/tokens \
  -H "authorization: Bearer $CLUTCHCALL_CREDENTIALS" \
  -H "content-type: application/json" \
  -d '{"org":"org_abc","flow":"support","ttlSec":900}'

// Returns the attachment meta to reference from a message envelope.
async function uploadAttachment(token: string, file: File) {
  const res = await fetch("https://engine.clutchcall.dev/v1/chat/upload", {
    method: "POST",
    headers: {
      "authorization": `Bearer ${token}`, // conversation-scoped session token
      "x-cc-filename": file.name,
      "content-type": file.type,           // must be an allowed MIME type
    },
    body: file,                            // raw bytes — NOT multipart
  });
  if (!res.ok) throw new Error(`upload rejected: ${res.status}`); // MIME/size
  return res.json(); // { id, name, size, mime, url }
}

import requests

def upload_attachment(token: str, path: str, mime: str) -> dict:
    with open(path, "rb") as f:
        res = requests.post(
            "https://engine.clutchcall.dev/v1/chat/upload",
            headers={
                "authorization": f"Bearer {token}",
                "x-cc-filename": path.rsplit("/", 1)[-1],
                "content-type": mime,
            },
            data=f,               # raw bytes
            timeout=30,
        )
    res.raise_for_status()        # 4xx if MIME/size not allowed
    return res.json()             # { id, name, size, mime, url }

# $CHAT_TOKEN is the conversation-scoped session token
curl -sX POST https://engine.clutchcall.dev/v1/chat/upload \
  -H "authorization: Bearer $CHAT_TOKEN" \
  -H "x-cc-filename: quote.pdf" \
  -H "content-type: application/pdf" \
  --data-binary @quote.pdf
# → {"id":"att_9f…","name":"quote.pdf","size":48213,
#    "mime":"application/pdf","url":"https://engine.clutchcall.dev/v1/chat/attachment/…"}

// `publish` is your client-track publisher — see the envelope protocol page.
async function sendFile(token: string, file: File, text = "") {
  const meta = await uploadAttachment(token, file); // step 1
  await publish({
    kind: "message",
    data: {
      text,                 // "" for an attachment-only message
      attachments: [meta],  // one or more { id, name, size, mime, url }
    },
  });
}

{
  "kind": "message",
  "data": {
    "text": "Here's the quote you asked for.",
    "attachments": [
      { "id": "att_9f…", "name": "quote.pdf", "size": 48213,
        "mime": "application/pdf", "url": "https://engine.clutchcall.dev/v1/chat/attachment/…" }
    ]
  }
}