Your SaaS Product
├── Your Backend (Next.js, Rails, Django...)
│   └── Calls Bothive API: POST /v1/bots/{bot_id}/chat
│       ├── Headers: Authorization, X-Session-ID (your user ID)
│       └── Body: { message, context }
│
└── Bothive Runtime
    ├── Resolves session by (bot_id, user_id)
    ├── Loads memory for this user
    ├── Executes tools with user's credentials
    └── Returns response + trace

swarm SaaSSupport {
  description: "Multi-tenant customer support for ProductName SaaS"

  agent ContextAgent {
    role: "Load user account details and history"
    capabilities {
      crm.getUser
      billing.getSubscription
    }
  }

  agent SupportAgent {
    role: "Resolve the user's support request"
    capabilities {
      knowledgebase.search
      support.createTicket
      billing.issueRefund
    }
  }

  on input {
    user_context = delegate to ContextAgent with { user_id: session.user_id }
    delegate to SupportAgent with {
      query: input,
      context: user_context
    }
  }
}

// In your Next.js API route or backend endpoint
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,  // Your user's ID — this scopes memory
  },
  body: JSON.stringify({
    message: userMessage,
    context: {
      // Inject any user context your product has
      plan: user.plan,
      company: user.company,
    }
  })
});

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