Documentation

// PostgreSQL connection
postgres://readonly_user:password@db.yourhost.com:5432/yourdb?sslmode=require

// MongoDB connection URI
mongodb+srv://readonly_user:password@cluster0.mongodb.net/yourdb

// Supabase (project API instead of direct Postgres)
project_url: "https://xyzcompany.supabase.co"
api_key: "YOUR_SUPABASE_KEY"

POST https://yoursystem.com/api/ussd-amount
Content-Type: application/json

{ "phone": "233241234567", "service_id": "...", "item_id": "..." }

{ "amount": 12.50 }

// Your webhook URL
POST /api/inbound/<token>
Content-Type: application/json

{ "name": "Efua", "order_id": "8f2a1c" }

// Template: "Hi {name}, your order {order_id} has shipped."
// Sends:    "Hi Efua, your order 8f2a1c has shipped."

POST /api/inbound/<token>
Content-Type: application/json

{ "phone": "+233241234567", "usage": "90%" }

// Template: "Quota alert: {usage} used"
// Sends:    "Quota alert: 90% used" to +233241234567

POST /api/inbound/<token>
Content-Type: application/json

{ "phone": "+233241234567", "message": "Your order has shipped!" }

// Sends exactly that text to +233241234567 — no template involved.

// Single contact
POST /api/customer/contacts
Authorization: Bearer <your key>
{ "name": "Jane Doe", "phone": "+233241234567", "group_name": "shopify" }

// Bulk — up to 10,000 per call
POST /api/customer/contacts/bulk
Authorization: Bearer <your key>
{ "group_name": "shopify", "contacts": [{ "name": "Jane", "phone": "+233241234567" }, ...] }

// Keep the key server-side only — an env var, never in browser/client JS,
// since anyone who can read it could add contacts to your account.
const TUNNELO_API_KEY = process.env.TUNNELO_API_KEY;
const TUNNELO_URL = 'https://your-domain.com/api/customer/contacts';

async function addContactToTunnelo({ name, phone, groupName }) {
  const res = await fetch(TUNNELO_URL, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${TUNNELO_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ name, phone, group_name: groupName }),
  });

  if (!res.ok) {
    const err = await res.json();
    throw new Error(`Tunnelo contact sync failed: ${err.error ?? res.status}`);
  }

  return res.json(); // { contact: { id, name, phone, network, group_name, created_at } }
}

// e.g. inside your own "customer created" event
await addContactToTunnelo({
  name: newCustomer.fullName,
  phone: newCustomer.phone,
  groupName: 'shopify',
});