SMS Integration with Twilio

The Workflow

1. Your IoT device sends an outgoing message

2. The message is captured by the webhook (defined in Monogoto integration)

3. The webhook is defined in Twilio as a service with a function that triggers SMS send to any device

1. Use Twilio Functions for the Webhook

Twilio Functions is a serverless environment that allows you to write code to process incoming webhooks without hosting your own server.

Steps:

1. Log in to your Twilio account.

2. Upgrade your account (to send SMS to private numbers - it's mandatory)

3. Navigate to Functions & Assets > Services.

1. Create a new service and add new Function within it.

5. Add function (press on add and edit the name of the path)

1. It will generate a default code. Overwrite it with the following code for the Function:

exports.handler = async function (context, event, callback) {
    const client = context.getTwilioClient();


    // Your mobile number and Twilio phone number
    const yourMobileNumber = '[phone]'; // Replace with your mobile number
    const twilioNumber = '[phone]';    // Replace with your Twilio number


    try {
        // Log the incoming webhook data
        console.log('Received webhook:', event);


        // Forward the message to your mobile number
        const message = await client.messages.create({
            body: `IoT Alert: ${event.text  || 'No message received'}`,
            from: twilioNumber,
            to: yourMobileNumber,
        });


        console.log(`Message sent: ${message.sid}`);
        callback(null, 'Message forwarded successfully!');
    } catch (error) {
        console.error('Error forwarding message:', error);
        callback(error);
    }
};

Modify the MSISDNs

Destination MSISDN:

 const yourMobileNumber = '[phone]'; // Replace with your mobile number

From MSISDN (must be a Twillio number - look in your account for your number) - you can find it in the account dashboard.

    const twilioNumber = '[phone]';    // Replace with your Twilio number

1. Make sure that your function is globally available - tap on the lock icon and modify from protected to global.

1. Save & Deploy the Function and note the generated URL.

---

2. Validate that your destination number is allowed by setting the geolocation permission in your account

https://console.twilio.com/us1/develop/sms/settings/geo-permissions

3. Point Your Webhook to the Twilio Function

Press on "copy URL" to get your Twilio URL - should be like: https://sendsms-6806.twil.io/sendSMS

Use this webhook URL in Monogoto hub webhook integration

View all messages sent in Twilio