Twilio SMS

Use Twilio when your SMS traffic should go through the Programmable Messaging Messages API. Wire TwilioSmsTransport into createSmsSender — Verify, Voice, and other Twilio products stay off this transport.

Quick start

import { createSmsSender } from "sently/sms";
import { TwilioSmsTransport } from "sently/transports/twilio-sms";

const sms = createSmsSender({
  transport: new TwilioSmsTransport({
    accountSid: process.env.TWILIO_ACCOUNT_SID!,
    apiKey: process.env.TWILIO_API_KEY!,
    authToken: process.env.TWILIO_API_KEY_SECRET!,
    from: "+15557654321",
  }),
});

const result = await sms.send({
  to: "+15551234567",
  body: "Your code is 123456",
});

console.log(result.messageId); // SM…
console.log(result.status); // e.g. queued

Configuration

Either from / options.from or messagingServiceSid is required for each send.

Messaging Service

When messagingServiceSid is set and From is omitted, Twilio picks a sender from the service pool. You may set both to pin a specific From inside that pool.

const sms = createSmsSender({
  transport: new TwilioSmsTransport({
    accountSid: process.env.TWILIO_ACCOUNT_SID!,
    authToken: process.env.TWILIO_AUTH_TOKEN!,
    messagingServiceSid: "MG…",
  }),
});

Verify and errors

verify() fetches GET /2010-04-01/Accounts/{AccountSid}.json with the same Basic credentials.

Failed Messages responses throw TwilioSmsError with Twilio’s message / code payload when present.

Troubleshooting

Learn more

• SMS channel — createSmsSender and hooks
• Transports — other SMS providers

Next