Azure Function to Read Incoming Message in Twilio

 

Introduction

In this tutorial, we will learn how to read incoming message in Twilio and respond to webhooks using Azure Functions.

We will learn what is webhooks, how to set up an Azure Function, and then use Azure Function app to respond to a Twilio SMS webhook and create a record in dynamic 365 in case entity when new message received.

Prerequisites:

  • A Twilio account. 
  • An Azure account with an active subscription.
  • Dynamic365 subscription.

What is webhook?

Webhook is an HTTP request triggered by an event in a source system and sent to a destination system. To enable this, you provide the source system with a URL where it can send the HTTP request.

A typical webhook setup involves the following:

  • A destination system that needs to be notified about a specific event.
  • A source system that sends a notification to the destination system when the event occurs. This system uses the provided webhook URL to make the HTTP request.

In your article, we will focus on responding to webhooks triggered by incoming SMS.

For Twilio SMS, two types of webhooks can be triggered:

Incoming Message: This webhook is triggered when your Twilio Phone Number receives a message. Twilio will send the details of this message to the webhook URL that you specify.

Status Callback: This webhook is triggered when the status changes of a message sent via Twilio. This webhook sends a message with the status of the message along with other details about the message.

Building the Azure Function:

·       Open visual studio and create azure function.


·       Select Azure function and click on Next.






·       Once function create rename Function1.cs to TwilioReceiveMessage.cs.

·       .NET APIs, but the Twilio SDK for .NET has dedicated APIs to generate TwiML. Add the Twilio NuGet package using the .NET CLI.

·     Navigate to Tools in visual studio à NuGet Package Manager à Manage Nuget Packages for solution and install below two packages.

o   Package Twilio

o   Twilio.AspNet.Core

o   Microsoft.PowerPlatform.Dataverse.Client ( To connect CRM service)



·       Now, update the TwilioReceiveMessage class with the following code:

using Microsoft.AspNetCore.Http;

using Microsoft.AspNetCore.Mvc;

using Microsoft.Azure.Functions.Worker;

using Microsoft.Extensions.Logging;

using Twilio.AspNet.Core;

using Twilio.TwiML;

using Microsoft.PowerPlatform.Dataverse.Client;

using Microsoft.Xrm.Sdk.Query;

using Microsoft.Xrm.Sdk;

using System.Security.Cryptography;

 

namespace TwilioMessage

{

    public class TwilioReceiveMessage

    {

        private readonly ILogger<TwilioReceiveMessage> _logger;

 

        public TwilioReceiveMessage(ILogger<TwilioReceiveMessage> logger)

        {

            _logger = logger;

        }

        private static ServiceClient service { get; set; }

 

        public static ServiceClient Service

        {

            get

            {

                if (service == null)

                {

                    service = new ServiceClient(

                        new Uri(Environment.GetEnvironmentVariable("CRMIntegrationTargetEnvironment")),

                        Environment.GetEnvironmentVariable("CRMIntegrationClientId"),

                        Environment.GetEnvironmentVariable("CRMIntegrationClientSecret"),

                        true);

                }

 

                return service;

            }

            set => service = value;

        }

 

        [Function("TwilioReceiveMessage")]

        public static async Task<IActionResult> Run([HttpTrigger(AuthorizationLevel.Function, "post")] HttpRequest req,

                                                    ILogger logger)

        {

            logger.LogInformation("C# HTTP trigger function processed a request.");

            var form = await req.ReadFormAsync();

            var body = form["Body"];

            logger.LogInformation("Message" + body);

 

            var fromNumber = form["From"].ToString();

            logger.LogInformation("From Number" + fromNumber);

 

            if (Service.IsReady)

            {

                CreateCase(fromNumber, body);

            }

 

            var response = new MessagingResponse();

            response.Message(

                $"You sent: {body}",

                action: new Uri("/api/MessageStatus", UriKind.Relative),

                method: Twilio.Http.HttpMethod.Post

            );

 

            return new TwiMLResult(response);

            //return new OkObjectResult("Welcome to Azure Functions!");

        }

        private static void CreateCase(string fromNumber string body)

        {

                Entity case = new Entity("cases");

   case.Attributes.Add("title", body );

                case.Attributes.Add("mobilephone", fromNumber);

                Service.Create(case);

           

        }

    }

}

Now let's Implement the Status Callback Webhook, right click on project àAdd àNew Azure Function.

Give function name as MessageStatus.cs and select Http trigger and click on Add as shown in below screens.




Update below code in MessageStatus.cs

using Microsoft.AspNetCore.Http;

using Microsoft.AspNetCore.Mvc;

using Microsoft.Azure.Functions.Worker;

using Microsoft.Extensions.Logging;

using Twilio.AspNet.Core;

using Twilio.TwiML;

using Microsoft.PowerPlatform.Dataverse.Client;

using Microsoft.Xrm.Sdk.Query;

using Microsoft.Xrm.Sdk;

 

namespace TwilioMessage

{

    public class MessageStatus

    {

        private readonly ILogger<MessageStatus> _logger;

 

        public MessageStatus(ILogger<MessageStatus> logger)

        {

            _logger = logger;

        }

 

        [Function("MessageStatus")]

        public async Task<IActionResult> Run([HttpTrigger(AuthorizationLevel.Function, "post")] HttpRequest req)

        {

            _logger.LogInformation("C# HTTP trigger function processed a request.");

            var form = await req.ReadFormAsync();

            string messageSid = form["MessageSid"];

            string messageStatus = form["MessageStatus"];

 

            _logger.LogInformation(

                "Status changed to {MessageStatus} for Message {MessageSid}",

                messageStatus,

                messageSid

);

            return new OkResult();

        }

    }

}

Deploy the Azure Function to Azure.

Navigate to https://portal.azure.com/ and search for function app.



Select resource group in which you want to create function app and give function name and click on Review + create.


Note:

Make sure you create your Environment Variables in azure function what ever your using in app.cofig file.


·       Azure function will get created.

·       New let’s publish function app to azure right click on project and click on publish.





Once azure function is published get URL.


Configure the webhook URL in Twilio:

Now that we have Azure function app URL let’s configure the webhook URL in twilo.

Log in to the Twilio console and select your Account.

Click on the Explore Products and select Phone Numbers. Then in the left side navigation, click on Phone Numbers àManage àActive Numbers. 

Click the active number you'd like to use which will take you to the configuration page.

On the configuration page, scroll down to the Messaging Section. Under ‘A MESSAGE COMES IN’, set the first dropdown to Webhook, then into the text box, enter the azure function app URL as the path, and lastly, set the second dropdown to HTTP POST.




Navigate to Messaging à Servicesà select your Messaging Services and click à Integration and paste your azure function app your in send a webhook.


Click Save and then send an SMS to your Twilio Phone Number.


Thank you..!









 














 






























Comments

Post a Comment

Popular posts from this blog

How to implement approval in Teams using Adaptive Cards

Image
  Adaptive Cards are self-contained user interface components that transcend platform boundaries. Crafted in JSON format, these snippets of UI can be seamlessly exchanged between applications. Upon reaching a particular application, the JSON content is dynamically rendered into native UI elements, seamlessly blending with the app's aesthetic. This approach facilitates the creation and seamless integration of lightweight UI elements across diverse platforms and frameworks. User Story: We're preparing to implement a leave approval workflow in Teams utilizing adaptive cards. Employees will submit their leave requests, and line managers will receive notifications within Teams. Step 1 – Design the Adaptive Card Prior to establishing the flow, let's initiate the card design process using the designer tool to ensure readiness. Visit https://adaptivecards.io/designer/   to access the designer interface and adjust the 'host app' setting to Microsoft Teams – Light /...
Read more

Open canvas app with Customize the command bar using command designer

Image
  This topic guides you through creating and editing modern commands using the command designer and Power Fx. Create a new model-driven app using modern app designer 1.      Sign into  Power Apps 2.      On the left navigation pane, select  Solutions  and then open or create a solution to contain the new model-driven app. 3.      Select  New  >  App  >  Model-driven app 4.      Select  Modern app designer , and then select  Create .    Enter a  Name  for your app, and then select  Create . More information:  Create a model-driven app that has an account table page 1.      On the left navigation pane, select  Solutions , and then open the solution containing the existing model-driven app. 2.      Select the model-driven app, and then select --  >  Edit ...
Read more

Create email templates in dynamic 365 and send email using Power Automate

Image
We can utilize email templates with Power Automate to send emails. Follow these steps to use email templates with Power Automate. ·         Create Email Template in dynamic 365. ·         Configure Power Automate to Email Template. Create Email Template in dynamic 365: Navigate to Power Platform admin center, navigate to the Environments tab, and select your environment you wish to create email template refer below screen short. Click on setting and look for Templets and click on Email Template. Click on new on tool bar. The Email Template Type dialog box will open. Select the desired entity and then click OK. On the template form, provide a name for your email template and, if desired, add a description. Note that the email template name and description will not be visible to the recipient. Enter the text you want to send in the message. Use the formatting toolbar to edit and style your...
Read more

HTTP Request Methods

Image
  1. 𝗚𝗘𝗧 : GET Method is used to request information from a website, Server or from API. Example: GET/api/employee/{employee-id}   2. 𝗣𝗢𝗦𝗧 : POST Method is used to create a new resource in server. We can send data to the server in the request body. Example: POST/api/employee/department   3. 𝗣𝗨𝗧 : PUT Method is used to update an existing record by sending the updated data as the content to request body to the server. Example: POST/api/employee/55445   4. 𝗗𝗘𝗟𝗘𝗧𝗘 : DELETE Method is used to remove resources from the server. Example: DELETE/api/employee/55445   5. 𝗣𝗔𝗧𝗖𝗛 : PATCH and PUT are similar use to updates a resource, but it will update data partially but not fully. Example: PATCH/api/employee/55445{"Name: Employee Name"}   6. 𝗛𝗘𝗔𝗗 : HEAD Method is like the GET but it doesn't have any response body. Example: HEAD/api/employee   7. 𝗢𝗣𝗧𝗜𝗢𝗡𝗦 : OPTIONS Method is used to get the informatio...
Read more

Duplicate Detection in Dynamics 365 using power apps.

Image
  User Case: When setting up a contact in Dynamics 365, verify if a contact with the same email address already exists. If it does, prompt an error message indicating a duplicate email address. Step 1 :  Navigate to make.powerapps.com, screen 1 à Create a Blank Canvas App à Connect with Dynamics 365 Data Source à Connect Contact Entity as Dataset (You can connect other entity also as per your requirement) Step 2:   Screen 2 - Insert a new Blank Screen to show Duplicate Detection Dialog Step 3:   Add few Text Input and Button Controls in Screen 1 or design as per your need. Step 4:  Add below formula on Button Control (onSelect property) to find Duplicate Record. If ( IsBlank ( LookUp ( Contacts , emailaddress1 = Emailaddress_Text . Text )), UpdateContext ({ result: "Duplicates Record not found" }), Navigate ( DuplicateDetectionDailogbox , ScreenTransition . CoverRight ) ) ; You can use following formula also on Button Control (onSelect property...
Read more