What businesses are
building with SMS

// Express webhook handler
app.post('/webhooks/payment', async (req, res) => {
  const { event, transaction } = req.body;
  if (event !== 'payment.success')
    return res.sendStatus(200);

  const { amount, phone, ref, balance }
    = transaction;

  const message =
    `Duka Masta: Umepokea TZS ` +
    `${amount.toLocaleString()} ` +
    `kutoka ${ref}. ` +
    `Salio: TZS ${balance.toLocaleString()}.`;

  const sms = await mojawave.sms.send({
    to: phone, from: 'Duka Masta', message
  });
  await db.transactions.update(ref,
    { smsId: sms.id });
  res.sendStatus(200);
});

const TEMPLATES = {
  CONFIRMED: (o) =>
    `Habari ${o.name}! Oda #${o.ref} ` +
    `imekubaliwa.`,

  SHIPPED: (o) =>
    `Oda #${o.ref} imetumwa! ` +
    `ETA: ${o.eta}. Track: duka.co/t/${o.ref}`,

  OUT_FOR_DELIVERY: (o) =>
    `${o.name}, oda #${o.ref} ipo njiani! ` +
    `Itafika leo. Kuwa karibu.`,

  DELIVERED: (o) =>
    `✓ Oda #${o.ref} imefikia. Asante! ` +
    `Tathmini: duka.co/review/${o.ref}`
};

async function notifyStatus(order, status) {
  return mojawave.sms.send({
    to:      order.phone,
    from:    'Duka Masta',
    message: TEMPLATES[status](order),
    metadata: { orderId: order.ref, status }
  });
}

// 1. Opted-in list only
const phones = (await db.customers.findMany({
  where: { smsOptIn: true, smsOptOut: false },
  select: { phone: true }
})).map(r => r.phone);

// 2. Send bulk campaign
const campaign = await mojawave.sms.send({
  to:      phones,     // up to 10,000
  from:    'Duka Masta',
  message: 'Duka Masta: 20% off leo! ' +
           'duka.co/promo · Jibu STOP.',
  send_at: '2025-01-15T09:00:00+03:00'
});

// 3. Handle inbound STOP replies
app.post('/webhooks/inbound', async (req, res) => {
  const { from, message } = req.body;
  if (message.trim().toUpperCase() === 'STOP')
    await db.customers.update(
      { phone: from }, { smsOptOut: true }
    );
  res.sendStatus(200);
});