twilio

# Node.js
npm install twilio

# Python
pip install twilio

// lib/twilio.ts — Client initialization
import twilio from 'twilio'

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

// sms.ts — Send and receive SMS messages
import twilio from 'twilio'

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

// Send SMS
const message = await client.messages.create({
  body: 'Your order #1234 has shipped! Track it at: https://track.example.com/1234',
  from: process.env.TWILIO_PHONE_NUMBER,    // your Twilio number
  to: '+15551234567',                        // recipient (E.164 format)
})

console.log(message.sid)    // SM1234567890abcdef

// Send MMS (with image)
await client.messages.create({
  body: 'Check out this photo!',
  from: process.env.TWILIO_PHONE_NUMBER,
  to: '+15551234567',
  mediaUrl: ['https://example.com/photo.jpg'],
})

// lib/verify.ts — Phone number verification / 2FA
// Uses Twilio Verify — handles code generation, delivery, and validation

const client = twilio(process.env.TWILIO_ACCOUNT_SID, process.env.TWILIO_AUTH_TOKEN)
const VERIFY_SERVICE_SID = process.env.TWILIO_VERIFY_SERVICE_SID!    // create in Twilio console

export async function sendVerificationCode(phoneNumber: string) {
  /**
   * Send a 6-digit verification code via SMS.
   * Twilio handles code generation, expiry (10 min), and rate limiting.
   */
  const verification = await client.verify.v2
    .services(VERIFY_SERVICE_SID)
    .verifications.create({
      to: phoneNumber,
      channel: 'sms',    // or 'call', 'email', 'whatsapp'
    })
  return verification.status    // 'pending'
}

export async function checkVerificationCode(phoneNumber: string, code: string) {
  /**
   * Verify a code entered by the user.
   * Returns 'approved' if correct, 'pending' if wrong.
   */
  const check = await client.verify.v2
    .services(VERIFY_SERVICE_SID)
    .verificationChecks.create({
      to: phoneNumber,
      code,
    })
  return check.status    // 'approved' or 'pending'
}

// whatsapp.ts — Send WhatsApp messages via Twilio
// Requires WhatsApp Business API setup in Twilio console

await client.messages.create({
  body: 'Your appointment is confirmed for tomorrow at 2 PM.',
  from: 'whatsapp:+14155238886',    // Twilio WhatsApp sandbox number
  to: 'whatsapp:+15551234567',
})

// WhatsApp with template (required for initiating conversations)
await client.messages.create({
  from: 'whatsapp:+14155238886',
  to: 'whatsapp:+15551234567',
  contentSid: 'HXb5b62575e6e4ff6129ad7c8efe1f983e',    // approved template SID
  contentVariables: JSON.stringify({ '1': 'John', '2': 'March 15' }),
})

// app/api/webhooks/twilio/route.ts — Handle incoming SMS/WhatsApp messages
import { NextRequest, NextResponse } from 'next/server'
import twilio from 'twilio'

const { MessagingResponse } = twilio.twiml

export async function POST(req: NextRequest) {
  const formData = await req.formData()
  const from = formData.get('From') as string
  const body = formData.get('Body') as string
  const messageSid = formData.get('MessageSid') as string

  console.log(`Incoming from ${from}: ${body}`)

  // Auto-reply with TwiML
  const response = new MessagingResponse()

  if (body.toLowerCase().includes('status')) {
    response.message('Your order is on its way! Expected delivery: tomorrow.')
  } else if (body.toLowerCase().includes('help')) {
    response.message('Available commands: STATUS, HELP, CANCEL')
  } else {
    response.message('Thanks for your message! Reply HELP for options.')
  }

  return new NextResponse(response.toString(), {
    headers: { 'Content-Type': 'text/xml' },
  })
}

// voice.ts — Make automated phone calls
// TwiML controls what happens during the call

await client.calls.create({
  url: 'https://myapp.com/api/voice/greeting',    // TwiML endpoint
  from: process.env.TWILIO_PHONE_NUMBER!,
  to: '+15551234567',
})

// Voice webhook endpoint
// app/api/voice/greeting/route.ts
import twilio from 'twilio'
const { VoiceResponse } = twilio.twiml

export async function POST() {
  const response = new VoiceResponse()
  response.say({ voice: 'alice' }, 'Hello! Your appointment is confirmed for tomorrow at 2 PM.')
  response.say('Press 1 to confirm, or 2 to reschedule.')

  const gather = response.gather({ numDigits: 1, action: '/api/voice/handle-input' })
  gather.say('Please make your selection.')

  return new Response(response.toString(), {
    headers: { 'Content-Type': 'text/xml' },
  })
}