Channels

import { Channels, CHANNEL_SEND_CHANNELS } from 'lua-cli';

import { Channels } from 'lua-cli';

const sent = await Channels.send({
  channel: 'whatsapp',
  to: { phoneNumber: '+15551234567' },
  text: 'Your order has shipped.',
});

const delivery = await Channels.getStatus(sent.deliveryId);

Channels.send(input: ChannelSendInput): Promise<ChannelSendOutput>

import { LuaJob, Data, Channels } from 'lua-cli';

export default new LuaJob({
  name: 'renewal-reminders',
  description: 'Remind customers whose plan renews tomorrow',
  schedule: { type: 'cron', expression: '0 9 * * *', timezone: 'Europe/London' },
  async execute() {
    const due = await Data.get('renewals', { status: 'due-tomorrow' }, 1, 100);
    for (const renewal of due.data) {
      await Channels.send({
        channel: 'sms',
        to: { phoneNumber: renewal.data.phone },
        text: 'Your plan renews tomorrow. Reply STOP to cancel.',
      });
    }
    return { sent: due.data.length };
  },
});

Channels.whatsapp.sendTemplate(input: WhatsAppTemplateSendInput): Promise<ChannelSendOutput>

import { Channels } from 'lua-cli';

await Channels.whatsapp.sendTemplate({
  to: { phoneNumber: '+15551234567' },
  templateName: 'appointment_reminder',
  languageCode: 'en_US',
  components: [{ type: 'body', parameters: [{ type: 'text', text: 'Tuesday at 3pm' }] }],
  messageContext: 'Reminded the customer about their Tuesday 3pm appointment',
});

Channels.whatsapp.sendReaction(input: WhatsAppReactionSendInput): Promise<ChannelSendOutput>

import { Channels } from 'lua-cli';

await Channels.whatsapp.sendReaction({
  to: { userId: 'user_abc123' },
  messageId: 'wamid.HBgLMTU1NTU1NTU1NTUVAgARGBI5QTNDQTVCM0Q0RUQ5RTU3RgA=',
  emoji: '👍',
});

Channels.whatsapp.requestPhoneNumber(input: WhatsAppPhoneRequestInput): Promise<ChannelSendOutput>

import { Channels } from 'lua-cli';

await Channels.whatsapp.requestPhoneNumber({
  to: { userId: 'user_abc123' },
  text: 'To book a table, please share your phone number.',
});

Channels.email.send(input: EmailSendInput): Promise<ChannelSendOutput>

import { Channels } from 'lua-cli';

const rootMessageId = '[email protected]';
await Channels.email.send({
  to: { email: '[email protected]' },
  subject: 'Re: Porch light (MT-2026-184)',
  richBody: 'Your technician is booked for **Thursday at 09:00**.',
  inReplyTo: rootMessageId,
  references: [rootMessageId],
  attachments: [
    { filename: 'work-order.pdf', contentType: 'application/pdf', url: 'https://example.com/work-order.pdf' },
  ],
});

Channels.getStatus(deliveryId: string): Promise<DeliveryView>

import { Channels } from 'lua-cli';

const sent = await Channels.send({ channel: 'whatsapp', to: { phoneNumber: '+15551234567' }, text: 'Your order has shipped.' });
const delivery = await Channels.getStatus(sent.deliveryId);
if (delivery.status === 'failed' && delivery.error?.category === 'window_closed') {
  await Channels.whatsapp.sendTemplate({ to: { phoneNumber: delivery.recipient }, templateName: 'order_update' });
}

Channels.listDeliveries(filter?: DeliveryListFilter): Promise<DeliveryView[]>

import { Channels } from 'lua-cli';

const failures = await Channels.listDeliveries({
  status: 'failed',
  since: new Date(Date.now() - 24 * 60 * 60 * 1000),
  limit: 100,
});
const billing = failures.filter((d) => d.error?.category === 'billing');