Menu

Expand
Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Instant Lead Alerts with Java and Servlets

You probably already have landing pages or product detail views which you're using to generate some excellent leads for your business. Would you like to let the sales team know when you've got a new qualified lead?

In this tutorial, we'll use Twilio Programmable SMS with Java and Servlets to send a message when a new lead is found. In this example, we'll be implementing instant lead alerts for a fictional real estate agency.

We'll create a landing page for a new house on the market and a form for web surfers to request additional information. The form will trigger notifications to our agents in the field, who can follow up and hopefully close the deal.

Learn how Porch uses Twilio SMS to send home contractors instant alerts when they are selected for a new project.

Let's see how it works! Click the button below to begin.

Let's Qualify Some Leads

Populate Landing Page Data

To display a landing page for the house, we need to have some information to show the user. For demonstration purposes, we've hard-coded the information we'd like to show.

        
        
        
        
        src/main/java/com/twilio/leadalerts/HomeServlet.java

        GET request handler that returns data for a listing

        src/main/java/com/twilio/leadalerts/HomeServlet.java

        Now we have a method to serve the house data.

        Next up, let's see how to use this data to render the Landing Page.

        Fetch Me a Page

        Render the Landing Page

        In our landing page we'll insert the data about the house. We'll also add a sidebar form for the user to enter in their contact information and request additional information.

              
              
              
              
              src/main/webapp/home.jsp

              Template for the landing page

              src/main/webapp/home.jsp

              Our landing page template is ready (and looks great).

              Now let's see how to initialize the Twilio REST Client to send messages.

              Next

              Create a Twilio REST API Client

              Here we create a helper class with an authenticated Twilio REST API client that we can use anytime we need to send a text message.

              We initialize it with our Twilio Account Credentials stored as environment variables. You can find the Auth Token and Account SID in the console:

              console credentials

                    
                    
                    
                    
                    src/main/java/com/twilio/leadalerts/lib/MessageSender.java

                    Twilio REST Client wrapper to simplify sending messages

                    src/main/java/com/twilio/leadalerts/lib/MessageSender.java

                    Our Twilio Client is now ready to send messages! Next up, let's see how to handle incoming leads.

                    Next

                    Handle Incoming POST Requests

                    This code handles the HTTP POST request from our landing page when a browser expresses interest through our form.

                    It uses our MessageSender class to send an SMS message to the real estate agent's phone number, which is stored as an environment variable. We include the lead's name, phone number, and inquiry directly in the body of the text message we send to the agent.

                    Now the agent has all the information he or she needs to quickly follow up with the new lead.

                          
                          
                          
                          
                          src/main/java/com/twilio/leadalerts/NotificationsServlet.java

                          Handle incoming sales leads and notify an agent

                          src/main/java/com/twilio/leadalerts/NotificationsServlet.java

                          That's a wrap! We've just implemented an application to instantly route leads to salespeople using text messages.

                          On the next page, we'll point out a few other useful features that are perfect for your application.

                          Next

                          Where to Next?

                          Java and Twilio go oh so well together. We'll prove it; here are a couple of our favorite Java tutorials:

                          Click-To-Call

                          Click-to-call enables your company to convert web traffic into phone calls with the click of a button.

                          IVR: Phone Tree

                          Easily route callers to the right people and information with an IVR (interactive voice response) system.

                          Did this help?

                          Thanks for checking out this tutorial... tweet @twilio to let us know what you're building!

                          Agustin Camino Jose Oliveros Paul Kamp Andrew Baker Kat King
                          Rate this page:

                          Need some help?

                          We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.