Chat API

curl -X POST https://api.bothive.cloud/v1/bots/{bot_id}/chat \
  -H "Authorization: Bearer bh_sk_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "X-Session-ID: user_abc123" \
  -d '{
    "message": "What is my current subscription plan?",
    "context": {
      "user_name": "Jeremy",
      "company": "Acme Corp"
    }
  }'

{
  "response": "Your current plan is Pro. It renews on February 15, 2025. You have 8,432 runs remaining this month.",
  "session_id": "user_abc123",
  "run_id": "run_xyz789",
  "latency_ms": 423,
  "tokens_used": 312,
  "tools_called": ["billing.getSubscription"]
}

curl -X POST https://api.bothive.cloud/v1/bots/{bot_id}/chat \
  -H "Authorization: Bearer bh_sk_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "X-Session-ID: user_abc123" \
  -H "Accept: text/event-stream" \
  -d '{"message": "Summarize my last 5 invoices", "stream": true}'

data: {"delta": "Your last "}
data: {"delta": "5 invoices total "}
data: {"delta": "$1,247.50."}
data: {"event": "done", "run_id": "run_abc123", "latency_ms": 812}

// Non-streaming
const response = await fetch(
  `https://api.bothive.cloud/v1/bots/${BOT_ID}/chat`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.BOTHIVE_API_KEY}`,
      'Content-Type': 'application/json',
      'X-Session-ID': userId,
    },
    body: JSON.stringify({
      message: userMessage,
      context: { plan: user.plan, name: user.name },
    }),
  }
);

const { response: reply, run_id } = await response.json();

// Streaming with EventSource
const eventSource = new EventSource(
  `https://api.bothive.cloud/v1/bots/${BOT_ID}/chat/stream?session_id=${userId}`,
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);

eventSource.onmessage = (event) => {
  const { delta, event: type, run_id } = JSON.parse(event.data);
  if (type === 'done') {
    eventSource.close();
    console.log('Run ID:', run_id);
  } else {
    appendToUI(delta);
  }
};

{
  "message": "Do I qualify for a refund?",
  "context": {
    "user_plan": "pro",
    "last_payment": "2025-01-15",
    "support_tier": "priority"
  }
}

try {
  const res = await fetch('...', { ... });
  if (!res.ok) {
    const { error } = await res.json();
    if (error.code === 'rate_limit_exceeded') {
      // Wait and retry after error.retry_after seconds
      await sleep(error.retry_after * 1000);
    }
    throw new Error(error.message);
  }
  const data = await res.json();
} catch (err) {
  console.error('Bothive API error:', err);
}