YeboLink

Send SMS, WhatsApp, and Email via one API.

Status: ✅ Live

---

What is YeboLink?

YeboLink is Yebo's communication infrastructure. It powers:

• SMS delivery across Africa
• WhatsApp messaging
• Email delivery
• Voice calls (coming)

Every Yebo product uses YeboLink. External developers can too.

---

How It Works

Single API, Multiple Channels

// Send via any channel
const response = await fetch('https://api.yebolink.com/api/v1/messages/send', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'ybk_your_api_key'
  },
  body: JSON.stringify({
    to: '+254712345678',
    channel: 'sms',  // or 'whatsapp' or 'email'
    content: {
      text: 'Your order has shipped!'
    }
  })
});

Channels

Channel	Format	Cost
SMS	Phone number	~$0.02/msg
WhatsApp	Phone number	~$0.01/msg
Email	Email address	~$0.001/msg

---

Use Cases

OTP Delivery

{
  "to": "+254712345678",
  "channel": "sms",
  "content": {
    "text": "Your Yebo code is: 123456. Valid for 5 minutes."
  }
}

Order Notifications

{
  "to": "+254712345678",
  "channel": "whatsapp",
  "content": {
    "text": "Your order #1234 has shipped! Track: https://..."
  }
}

Invoices

{
  "to": "client@company.com",
  "channel": "email",
  "content": {
    "subject": "Invoice from @laslie",
    "from_name": "Laslie via Yebo",
    "html": "<h1>Invoice #001</h1>..."
  }
}

---

Agent Integration

User: "Send invoice to TechCorp for the website"

Agent:
→ Creates invoice (KES 50,000)
→ Sends via YeboLink (email + WhatsApp)
→ "Invoice sent to john@techcorp.com and +254..."

---

API Reference

Send Message

POST /api/v1/messages/send

Request:

{
  "to": "+254712345678",
  "channel": "sms",
  "content": {
    "text": "Hello from Yebo!"
  }
}

Response:

{
  "success": true,
  "data": {
    "messageId": "msg_abc123",
    "status": "sent",
    "cost": 0.02
  }
}

Send Email

{
  "to": "recipient@example.com",
  "channel": "email",
  "content": {
    "subject": "Your Subject",
    "from_name": "YeboShops",
    "html": "<h1>HTML content</h1>",
    "text": "Plain text fallback"
  }
}

Bulk Send

{
  "messages": [
    { "to": "+254...", "channel": "sms", "content": { "text": "..." } },
    { "to": "+255...", "channel": "sms", "content": { "text": "..." } }
  ]
}

---

Webhooks

Receive delivery status updates:

// Your webhook endpoint
app.post('/webhooks/yebolink', (req, res) => {
  const { messageId, status, timestamp } = req.body;
  
  // status: sent, delivered, failed, read
  
  await updateMessageStatus(messageId, status);
  res.sendStatus(200);
});

---

Pricing

Channel	Per Message
SMS (Kenya)	KES 2.0
SMS (Nigeria)	NGN 4.0
WhatsApp	KES 1.0
Email	KES 0.1

Credit packs:

• $10 = 500 SMS
• $25 = 1,500 SMS
• $100 = 7,500 SMS

---

Internal Usage

YeboLink powers all Yebo communications:

Product	Uses YeboLink For
YeboID	OTP delivery
YeboShops	Order notifications
YeboJobs	Application updates
YeboSafe	Payment confirmations
Orchestrator	Agent responses

---

Status

Feature	Status
SMS	✅ Live
Email	✅ Live
WhatsApp	✅ Live
Voice	📋 Planned
Bulk API	✅ Live
Webhooks	✅ Live