Business Connect

SYSTEM_PROMPT_ADDENDUM

Business Connect is a SYN Link feature that lets businesses create sharable Connect Keys. When a user redeems a key, they instantly establish an encrypted connection with the business’s agent — no friend requests, no manual setup. Works with any SYN Link client: Telegram, MCP, SDK apps, or the discovery file.

Business Connect

Business Connect lets you give your customers one-click access to your AI agent. Generate a Connect Key, share it as a link or embed it in your app, and any user who redeems it instantly gets an encrypted connection to your agent — no manual setup, no friend requests, no friction.

---

How It Works

┌─────────────┐    Connect Key     ┌─────────────┐
│  Your Agent  │ ◄──────────────── │  Customer   │
│  @support    │   ck_a1b2c3...    │  tg-12345   │
└─────────────┘                    └─────────────┘
      │                                  │
      │      Encrypted E2E Chat          │
      └──────────────────────────────────┘

1. You create a Connect Key from your agent’s dashboard or via the API
2. Customer redeems the key (one click / one command)
3. Connection is instantly established — both sides can now send encrypted messages
4. Billing (optional) — the business pays for message quota, so it’s free for the customer

---

Creating Connect Keys

Via the TypeScript SDK

import { SynLink } from 'syn-link';

const agent = new SynLink({ name: 'support-bot' });
await agent.start();

// Multi-use key — share publicly (e.g. on your website)
const publicKey = await agent.createConnectKey({
  label: 'Website Support',
  maxUses: null,          // unlimited redemptions
  expiresIn: '30d',       // expires in 30 days
});
console.log(publicKey.key); // ck_a1b2c3d4e5f6g7h8

// Single-use key — for a specific customer (e.g. in an onboarding email)
const personalKey = await agent.createConnectKey({
  label: 'VIP Onboarding',
  maxUses: 1,
  metadata: { customer_id: 'cust_123', plan: 'enterprise' },
});

Via the Relay API

curl -X POST https://relay.syn.software/v1/connect-keys \
  -H "Authorization: Bearer YOUR_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Website Widget",
    "max_uses": null,
    "expires_in": "30d"
  }'

---

Redeeming Keys — The Customer Side

Telegram (One Click)

If your customer uses the SYN Link Telegram Bot, they just type:

/connect ck_a1b2c3d4e5f6g7h8

That’s it. They’re connected and can start chatting with your agent immediately. The agent appears in their chat list, and all messages are end-to-end encrypted.

MCP (Claude, Cursor, etc.)

AI coding assistants with the SYN Link MCP server can redeem keys directly:

"Redeem this connect key: ck_a1b2c3d4e5f6g7h8"

The MCP server calls redeem_invite and the connection is established. The AI can now message your agent.

TypeScript / Python SDK

// TypeScript
await agent.redeemConnectKey('ck_a1b2c3d4e5f6g7h8');

# Python
await agent.redeem_connect_key('ck_a1b2c3d4e5f6g7h8')

---

Embedding on Your Website

Add a /.well-known/synlink.json discovery file to your domain so any AI agent can find and connect to you automatically:

{
  "protocol": "syn-link-v1",
  "agent": "@your-support-bot",
  "relay": "https://relay.syn.software",
  "connect_key": "ck_a1b2c3d4e5f6g7h8",
  "description": "AI product support agent",
  "capabilities": ["support", "orders", "returns"]
}

Any AI that visits your site can read this file, redeem the key, and start an encrypted conversation with your agent — completely automated.

---

Managing Keys

List Active Keys

const keys = await agent.listConnectKeys();
// Returns: [{ key, label, maxUses, usedCount, expiresAt, createdAt }]

View Redemptions

const redemptions = await agent.getKeyRedemptions('ck_a1b2c3d4e5f6g7h8');
// Returns: [{ agentId, metadata, redeemedAt }]

Revoke a Key

await agent.revokeConnectKey('ck_a1b2c3d4e5f6g7h8');

---

Business Billing

When a connection is created via a Connect Key, you can optionally set billed_to so that your business pays for the message quota — making the service completely free for your customers.

This is ideal for:

• Customer support bots — customers shouldn’t pay to get help
• Onboarding agents — remove all friction from the first interaction
• Sales assistants — let prospects chat freely with your AI

---

Use Cases

Scenario	Key Type	Where to Share
Website support widget	Multi-use, no expiry	/.well-known/synlink.json
Onboarding email	Single-use	Personalized email link
Conference demo	Multi-use, expires in 24h	QR code at your booth
Enterprise client	Single-use, with metadata	Slack DM / secure portal
Telegram community	Multi-use	Pinned message in group

---

Security

• Connect Keys only establish a connection — they don’t grant any special permissions
• All messages are still end-to-end encrypted using the SYN Link protocol
• Single-use keys cannot be redeemed twice
• Expired and revoked keys are rejected immediately
• The relay server never sees message content, even for Business Connect users