Twilio SMS/ Implementation：Claude Code 实战指南

TwilioのSMS/通話機能を通过 Claude Code 实现

Twilioはプ日志ラマブルな通信APIを提供するプラット表单です。SMS发送、音频通話、二要素认证など、通信機能を应用に組み込めます。借助 Claude Code，TwilioのAPIを高效地活用可以。

SMS发送の基本

> TwilioでSMS发送するサービス类を作って。
> 模板支持とリトライ処理も含めて。

// src/services/sms.ts
import twilio from 'twilio';

const client = twilio(
  process.env.TWILIO_ACCOUNT_SID!,
  process.env.TWILIO_AUTH_TOKEN!
);

const FROM_NUMBER = process.env.TWILIO_PHONE_NUMBER!;

export class SmsService {
  async send(to: string, body: string): Promise<string> {
    try {
      const message = await client.messages.create({
        body,
        from: FROM_NUMBER,
        to,
      });
      console.log(`SMS sent: ${message.sid}`);
      return message.sid;
    } catch (error: any) {
      if (error.code === 21211) {
        throw new Error('無効な電話番号です');
      }
      throw error;
    }
  }

  async sendWithRetry(
    to: string,
    body: string,
    maxRetries = 3
  ): Promise<string> {
    for (let i = 0; i < maxRetries; i++) {
      try {
        return await this.send(to, body);
      } catch (error) {
        if (i === maxRetries - 1) throw error;
        await new Promise(r => setTimeout(r, 1000 * (i + 1)));
      }
    }
    throw new Error('Max retries exceeded');
  }
}

二要素认证（2FA）の实现

> Twilio Verify使用...的二要素认证实现。
> コードの发送と验证の両方を作って。

// src/services/verification.ts
import twilio from 'twilio';

const client = twilio(
  process.env.TWILIO_ACCOUNT_SID!,
  process.env.TWILIO_AUTH_TOKEN!
);

const VERIFY_SERVICE_SID = process.env.TWILIO_VERIFY_SERVICE_SID!;

export class VerificationService {
  // 认证コードの发送
  async sendCode(
    to: string,
    channel: 'sms' | 'call' | 'email' = 'sms'
  ): Promise<void> {
    await client.verify.v2
      .services(VERIFY_SERVICE_SID)
      .verifications.create({
        to,
        channel,
      });
    console.log(`Verification code sent to ${to} via ${channel}`);
  }

  // 认证コードの验证
  async verifyCode(to: string, code: string): Promise<boolean> {
    try {
      const check = await client.verify.v2
        .services(VERIFY_SERVICE_SID)
        .verificationChecks.create({
          to,
          code,
        });
      return check.status === 'approved';
    } catch (error: any) {
      if (error.code === 20404) {
        return false; // コードが期限切れ
      }
      throw error;
    }
  }
}

API端点の实现

// src/api/auth/verify.ts
import { VerificationService } from '../../services/verification';

const verifyService = new VerificationService();

// コード发送
export async function POST(req: Request) {
  const { phone } = await req.json();

  if (!phone) {
    return Response.json({ error: '電話番号が必要です' }, { status: 400 });
  }

  try {
    await verifyService.sendCode(phone);
    return Response.json({ success: true, message: '認証コードを送信しました' });
  } catch (error) {
    return Response.json({ error: '送信に失敗しました' }, { status: 500 });
  }
}

// コード验证
export async function PUT(req: Request) {
  const { phone, code } = await req.json();

  const isValid = await verifyService.verifyCode(phone, code);

  if (isValid) {
    return Response.json({ success: true, message: '認証成功' });
  }
  return Response.json({ error: '無効なコードです' }, { status: 400 });
}

通知システムの构建

> 注文ステータス更改時にSMS通知を送る仕組みを作って。

// src/services/notification.ts
import { SmsService } from './sms';

const smsService = new SmsService();

const TEMPLATES = {
  ORDER_CONFIRMED: (orderId: string) =>
    `ご注文 #${orderId} を承りました。準備が整い次第、発送いたします。`,
  ORDER_SHIPPED: (orderId: string, trackingUrl: string) =>
    `ご注文 #${orderId} を発送しました。配送状況: ${trackingUrl}`,
  ORDER_DELIVERED: (orderId: string) =>
    `ご注文 #${orderId} が配達されました。ご利用ありがとうございます。`,
};

export async function notifyOrderStatus(
  phone: string,
  orderId: string,
  status: 'confirmed' | 'shipped' | 'delivered',
  metadata?: { trackingUrl?: string }
) {
  let message: string;

  switch (status) {
    case 'confirmed':
      message = TEMPLATES.ORDER_CONFIRMED(orderId);
      break;
    case 'shipped':
      message = TEMPLATES.ORDER_SHIPPED(orderId, metadata?.trackingUrl || '');
      break;
    case 'delivered':
      message = TEMPLATES.ORDER_DELIVERED(orderId);
      break;
  }

  await smsService.sendWithRetry(phone, message);
}

总结

Twilioの通信APIを通过 Claude Code高效地实现し、SMS通知や二要素认证を快速应用に組み込めます。认证实现指南やWebhook实现也建议一并参考。

Twilio的详细信息请参阅Twilio官方文档。