# 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.
4. Create a new service and add new Function within it.
5\. Add function (press on add and edit the name of the path)
6. 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 = '+1234567890'; // Replace with your mobile number
const twilioNumber = '+1987654321'; // 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 = '+972542205056'; // 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 = '+12405234667'; // Replace with your Twilio number
```
7. Make sure that your function is globally available - tap on the lock icon and modify from protected to global.
8. 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
## 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
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.monogoto.io/hub/faq/sms-integration-with-twilio.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
