How to Integrate Replit with Twilio

1// Verify Twilio secrets at startup
2const required = ['TWILIO_ACCOUNT_SID', 'TWILIO_AUTH_TOKEN', 'TWILIO_PHONE_NUMBER'];
3for (const key of required) {
4  if (!process.env[key]) {
5    throw new Error(`Missing secret: ${key}. Add it in Replit Secrets (lock icon 🔒).`);
6  }
7}
8// Quick sanity checks
9if (!process.env.TWILIO_ACCOUNT_SID.startsWith('AC')) {
10  throw new Error('TWILIO_ACCOUNT_SID should start with AC');
11}
12if (!process.env.TWILIO_PHONE_NUMBER.startsWith('+')) {
13  throw new Error('TWILIO_PHONE_NUMBER must be in E.164 format, e.g., +15551234567');
14}
15console.log('Twilio credentials verified.');

1// twilio-send.js — Send SMS, MMS, and WhatsApp from Replit
2const twilio = require('twilio');
3
4const client = twilio(
5  process.env.TWILIO_ACCOUNT_SID,
6  process.env.TWILIO_AUTH_TOKEN
7);
8
9const FROM_NUMBER = process.env.TWILIO_PHONE_NUMBER;
10
11// Send a simple SMS
12async function sendSMS(to, message) {
13  const result = await client.messages.create({
14    from: FROM_NUMBER,
15    to: to,       // E.164 format: +15551234567
16    body: message
17  });
18  console.log(`SMS sent: ${result.sid} (status: ${result.status})`);
19  return result.sid;
20}
21
22// Send an MMS with an image (US/Canada only)
23async function sendMMS(to, message, imageUrl) {
24  const result = await client.messages.create({
25    from: FROM_NUMBER,
26    to: to,
27    body: message,
28    mediaUrl: [imageUrl]  // Must be a publicly accessible URL
29  });
30  return result.sid;
31}
32
33// Send a WhatsApp message
34async function sendWhatsApp(to, message) {
35  const result = await client.messages.create({
36    from: `whatsapp:${FROM_NUMBER}`,
37    to: `whatsapp:${to}`,
38    body: message
39  });
40  return result.sid;
41}
42
43// Check message delivery status
44async function getMessageStatus(messageSid) {
45  const message = await client.messages(messageSid).fetch();
46  return {
47    sid: message.sid,
48    status: message.status,      // queued, sent, delivered, failed
49    errorCode: message.errorCode,
50    errorMessage: message.errorMessage
51  };
52}
53
54// Example usage
55(async () => {
56  try {
57    // Replace with a verified number on Twilio trial accounts
58    const sid = await sendSMS('+15559876543', 'Hello from Replit + Twilio!');
59    console.log('Message SID:', sid);
60    
61    // Check delivery after a moment
62    setTimeout(async () => {
63      const status = await getMessageStatus(sid);
64      console.log('Delivery status:', status);
65    }, 3000);
66  } catch (err) {
67    console.error('Twilio error:', err.message);
68    console.error('Error code:', err.code);
69  }
70})();

1# twilio_client.py — Twilio SMS and MMS with Python on Replit
2import os
3from twilio.rest import Client
4from twilio.base.exceptions import TwilioRestException
5
6client = Client(
7    os.environ['TWILIO_ACCOUNT_SID'],
8    os.environ['TWILIO_AUTH_TOKEN']
9)
10FROM_NUMBER = os.environ['TWILIO_PHONE_NUMBER']
11
12def send_sms(to: str, message: str) -> str:
13    """Send an SMS and return the message SID."""
14    try:
15        result = client.messages.create(
16            from_=FROM_NUMBER,
17            to=to,
18            body=message
19        )
20        print(f'SMS sent: {result.sid} (status: {result.status})')
21        return result.sid
22    except TwilioRestException as e:
23        print(f'Twilio error {e.code}: {e.msg}')
24        raise
25
26def send_mms(to: str, message: str, media_url: str) -> str:
27    """Send an MMS with an image (US/Canada numbers only)."""
28    result = client.messages.create(
29        from_=FROM_NUMBER,
30        to=to,
31        body=message,
32        media_url=[media_url]  # Must be a publicly accessible URL
33    )
34    return result.sid
35
36def send_whatsapp(to: str, message: str) -> str:
37    """Send a WhatsApp message via Twilio."""
38    result = client.messages.create(
39        from_=f'whatsapp:{FROM_NUMBER}',
40        to=f'whatsapp:{to}',
41        body=message
42    )
43    return result.sid
44
45def get_message_status(message_sid: str) -> dict:
46    """Fetch current delivery status for a message."""
47    message = client.messages(message_sid).fetch()
48    return {
49        'sid': message.sid,
50        'status': message.status,
51        'error_code': message.error_code,
52        'error_message': message.error_message
53    }
54
55# Usage
56if __name__ == '__main__':
57    sid = send_sms('+15559876543', 'Hello from Replit + Twilio (Python)!')
58    print(f'Message SID: {sid}')

1// webhook-server.js — Receive and respond to Twilio SMS webhooks
2const express = require('express');
3const twilio = require('twilio');
4const { MessagingResponse } = require('twilio').twiml;
5
6const app = express();
7// Parse URL-encoded bodies (Twilio sends form data, not JSON)
8app.use(express.urlencoded({ extended: false }));
9app.use(express.json());
10
11const client = twilio(process.env.TWILIO_ACCOUNT_SID, process.env.TWILIO_AUTH_TOKEN);
12
13// Validate Twilio request signature (prevents spoofed webhook requests)
14function validateTwilioSignature(req, res, next) {
15  const authToken = process.env.TWILIO_AUTH_TOKEN;
16  const signature = req.headers['x-twilio-signature'];
17  // Full URL including protocol and host
18  const url = `${req.protocol}://${req.get('host')}${req.originalUrl}`;
19  
20  const isValid = twilio.validateRequest(authToken, signature, url, req.body);
21  if (!isValid) {
22    return res.status(403).send('Invalid Twilio signature');
23  }
24  next();
25}
26
27// Incoming SMS webhook — Twilio POSTs here when your number receives an SMS
28app.post('/sms', validateTwilioSignature, (req, res) => {
29  const { From, Body, To, NumMedia } = req.body;
30  
31  console.log(`Incoming SMS from ${From}: ${Body}`);
32  
33  // Build a TwiML response
34  const twiml = new MessagingResponse();
35  
36  // Simple keyword-based auto-responder
37  const message = Body.trim().toUpperCase();
38  if (message === 'HELP') {
39    twiml.message('Available commands: STATUS, STOP, HELP');
40  } else if (message === 'STATUS') {
41    twiml.message('All systems operational. Reply HELP for options.');
42  } else if (message === 'STOP') {
43    // Twilio handles STOP automatically for opt-out compliance
44    twiml.message('You have been unsubscribed. Reply START to resubscribe.');
45  } else {
46    twiml.message(`Thanks for your message: "${Body}". Reply HELP for options.`);
47  }
48  
49  res.type('text/xml');
50  res.send(twiml.toString());
51});
52
53// Incoming voice call webhook
54app.post('/voice', (req, res) => {
55  const { VoiceResponse } = require('twilio').twiml;
56  const twiml = new VoiceResponse();
57  twiml.say('Hello! You have reached a Replit application. Goodbye.');
58  twiml.hangup();
59  res.type('text/xml');
60  res.send(twiml.toString());
61});
62
63app.listen(3000, '0.0.0.0', () => {
64  console.log('Twilio webhook server running on port 3000');
65  console.log('Configure Twilio phone number webhook to: https://yourapp.replit.app/sms');
66});

1# webhook_server.py — Twilio SMS webhook receiver with Flask on Replit
2from flask import Flask, request, Response
3from twilio.twiml.messaging_response import MessagingResponse
4from twilio.request_validator import RequestValidator
5import os
6
7app = Flask(__name__)
8validator = RequestValidator(os.environ['TWILIO_AUTH_TOKEN'])
9
10def validate_twilio_request(f):
11    """Decorator to validate Twilio webhook signatures."""
12    from functools import wraps
13    @wraps(f)
14    def decorated_function(*args, **kwargs):
15        url = request.url
16        post_data = request.form
17        signature = request.headers.get('X-Twilio-Signature', '')
18        if not validator.validate(url, post_data, signature):
19            return Response('Invalid Twilio signature', status=403)
20        return f(*args, **kwargs)
21    return decorated_function
22
23@app.route('/sms', methods=['POST'])
24@validate_twilio_request
25def incoming_sms():
26    from_number = request.form.get('From')
27    body = request.form.get('Body', '').strip().upper()
28    num_media = int(request.form.get('NumMedia', 0))
29    
30    print(f'Incoming SMS from {from_number}: {body}')
31    
32    twiml = MessagingResponse()
33    
34    if body == 'HELP':
35        twiml.message('Available commands: STATUS, STOP, HELP')
36    elif body == 'STATUS':
37        twiml.message('All systems operational. Reply HELP for options.')
38    elif num_media > 0:
39        # Received an MMS with media
40        media_url = request.form.get('MediaUrl0', '')
41        twiml.message(f'Got your image! URL: {media_url[:50]}...')
42    else:
43        twiml.message(f'Thanks! You said: "{request.form.get("Body")}". Reply HELP for options.')
44    
45    return Response(str(twiml), mimetype='text/xml')
46
47@app.route('/voice', methods=['POST'])
48def incoming_call():
49    from twilio.twiml.voice_response import VoiceResponse
50    twiml = VoiceResponse()
51    twiml.say('Hello! You have reached a Replit application. Goodbye.')
52    twiml.hangup()
53    return Response(str(twiml), mimetype='text/xml')
54
55if __name__ == '__main__':
56    app.run(host='0.0.0.0', port=3000)