Documentation

Examples

Practical BSOS integration examples for common business workflows: email triage, customer requests, sales opportunities, support messages, and internal operations.

Email Triage

Use BSOS to analyze incoming emails and decide which messages require attention, reply, routing, or follow-up.

{
  "workspace_id": "workspace_123",
  "source": "email",
  "subject": "Invoice correction needed",
  "body": "Hi, the invoice total looks incorrect. Can you check this today?",
  "sender": "client@example.com",
  "received_at": "2026-07-04T12:30:00Z"
}
{
  "priority": "high",
  "category": "financial",
  "requires_reply": true,
  "recommended_action": "Review the invoice and reply to the client today."
}

Customer Support

Support tools can use BSOS to detect urgent customer issues and route them to the right team member or queue.

{
  "workspace_id": "workspace_123",
  "source": "support",
  "subject": "Cannot access my account",
  "body": "I cannot log in and I have a customer meeting in one hour.",
  "sender": "customer@example.com"
}
{
  "priority": "urgent",
  "category": "client",
  "requires_reply": true,
  "recommended_action": "Escalate and respond immediately."
}

Sales Opportunity

CRM systems can use BSOS to identify potential opportunities and separate them from low-value noise.

{
  "workspace_id": "workspace_123",
  "source": "crm",
  "subject": "Interested in Business plan",
  "body": "We are evaluating tools for a 20-person team. Can you send pricing details?",
  "sender": "prospect@example.com"
}
{
  "priority": "high",
  "category": "opportunity",
  "requires_reply": true,
  "recommended_action": "Send pricing information and offer a follow-up call."
}

Internal Operations

Internal systems can use BSOS to prioritize operational requests, approvals, admin tasks, and time-sensitive internal messages.

{
  "workspace_id": "workspace_123",
  "source": "internal",
  "subject": "Approval needed before Friday",
  "body": "Please approve the vendor contract before Friday so we can proceed."
}
{
  "priority": "medium",
  "category": "documents",
  "requires_reply": false,
  "recommended_action": "Review and approve the vendor contract before Friday."
}

Typical Integration Pattern

1

Capture the signal

Your product receives a message, task, event, ticket, note, or customer interaction.

2

Send it to BSOS

Submit the normalized signal to the API from your backend.

3

Receive the decision

BSOS returns priority, category, reply requirement, recommended action, and reasoning.

4

Act inside your system

Display the result, route work, trigger workflows, notify users, or store the decision.

Next Step

Continue with FAQ for common product, API, and integration questions.

Continue to FAQ