Menu

Expand
Rate this page:

Build Masked Phone Numbers - Java

This Java Servlets sample application is modeled after the amazing rental experience created by AirBnB, but with more Klingons.

Host users can offer rental properties which other guest users can reserve. The guest and the host can then anonymously communicate via a disposable Twilio phone number created just for a reservation. In this tutorial, we'll show you the key bits of code to make this work.

To run this sample app yourself, download the code and follow the instructions on GitHub.

Legal implications of managing communications between users

If you choose to manage communications between your users, including voice calls, text-based messages (e.g., SMS), and chat, you may need to comply with certain laws and regulations, including those regarding obtaining consent. Additional information regarding legal compliance considerations and best practices for using Twilio to manage and record communications between your users, such as when using Twilio Proxy, can be found here.

Notice: Twilio recommends that you consult with your legal counsel to make sure that you are complying with all applicable laws in connection with communications you record or store using Twilio.

Read how Lyft uses masked phone numbers to let customers securely contact drivers.

Let's get started!

Create a Reservation

The first step in connecting a guest and host is creating a reservation. Here, we handle a form submission for a new reservation which contains the message. The guest's information is pulled out from the logged user.

Loading Code Sample...
        
        
        src/main/java/org/twilio/airtng/servlets/ReservationServlet.java

        Create a Reservation

        src/main/java/org/twilio/airtng/servlets/ReservationServlet.java

        Part of our reservation system is receiving reservation requests from potential renters. However, these reservations need to be confirmed. Let's see how we would handle this step.

        Confirm the Reservation

        Confirm the Reservation

        Before the reservation is finalized, the host needs to confirm that the property was reserved. Learn how to automate this process in our first AirTNG tutorial, Workflow Automation.

        Loading Code Sample...
              
              
              src/main/java/org/twilio/airtng/servlets/ReservationConfirmationServlet.java

              Confirm the Reservation

              src/main/java/org/twilio/airtng/servlets/ReservationConfirmationServlet.java

              Once the reservation is confirmed, we need to purchase a Twilio number that the guest and host can use to communicate.

              Purchase a Twilio Number

              Purchase a Twilio Number

              Here we use a Twilio Java helper library to search for and buy a new phone number to associate with the reservation. When we buy the number, we designate a Twilio Application that will handle webhook requests when the new number receives an incoming call or text.

              We then save the new phone number on our Reservation model, so when our app receives calls or texts to this number, we'll know which reservation the call or text belongs to.

              Loading Code Sample...
                    
                    
                    src/main/java/org/twilio/airtng/lib/phonenumber/Purchaser.java

                    Purchase a Twilio Number

                    src/main/java/org/twilio/airtng/lib/phonenumber/Purchaser.java

                    Now that each reservation has a Twilio Phone Number, we can see how the application will look up reservations as guest or host calls come in.

                    Find a Reservation

                    Find a Reservation

                    When someone sends an SMS or calls one of the Twilio numbers you have configured, Twilio makes a request to the URL you set in the Twiml app. In this request, Twilio includes some useful information including:

                    • The incomingPhoneNumber number that originally called or sent an SMS.
                    • The anonymousPhoneNumber Twilio number that triggered this request.

                    Take a look at Twilio's SMS Documentation and Twilio's Voice Documentation for a full list of the parameters you can use.

                    In our servlet we use the to parameter sent by Twilio to find a reservation that has the number we bought stored in it, as this is the number both hosts and guests will call and send SMS to.

                    Loading Code Sample...
                          
                          
                          src/main/java/org/twilio/airtng/servlets/BaseExchangeServlet.java

                          Find a Reservation

                          src/main/java/org/twilio/airtng/servlets/BaseExchangeServlet.java

                          Next, let's see how to connect the guest and the host via SMS.

                          Connect Via SMS

                          Connect Via SMS

                          Our Twilio application should be configured to send HTTP requests to this controller method on any incoming text message. Our app responds with TwiML to tell Twilio what to do in response to the message.

                          If the initial message sent to the anonymous number was sent by the host, we forward it on to the guest. Conversely, if the original message was sent by the guest, we forward it to the host.

                          To find the outgoing number we'll use the gatherOutgoingPhoneNumberAsync helper method.

                          Loading Code Sample...
                                
                                
                                src/main/java/org/twilio/airtng/servlets/ExchangeSmsServlet.java

                                Connect Via SMS

                                src/main/java/org/twilio/airtng/servlets/ExchangeSmsServlet.java

                                Let's see how to connect the guest and the host via phone call next.

                                Connect Via Phone Call

                                Connect Via Phone Call

                                Our Twilio application will send HTTP requests to this method on any incoming voice call. Our app responds with TwiML instructions that tell Twilio to Play an introductory MP3 audio file and then Dial either the guest or host, depending on who initiated the call.

                                Loading Code Sample...
                                      
                                      
                                      src/main/java/org/twilio/airtng/servlets/ExchangeVoiceServlet.java

                                      Connect Via Phone Call

                                      src/main/java/org/twilio/airtng/servlets/ExchangeVoiceServlet.java

                                      That's it! We've just implemented anonymous communications that allow your customers to connect while protecting their privacy.

                                      Where to Next?

                                      Where to Next?

                                      If you're a Java developer working with Twilio, you might want to check out these other tutorials:

                                      IVR: Phone Tree

                                      Create a seamless customer service experience by building an IVR Phone Tree for your company.

                                      Click To Call

                                      Allow your company to convert web traffic into phone calls with the click of a button.

                                      Did this help?

                                      Thanks for checking out this tutorial! If you have any feedback to share with us, we'd love to hear it. Tweet @twilio to let us know what you think.

                                      Brianna DelValle
                                      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 by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

                                      Loading Code Sample...
                                            
                                            
                                            

                                            Thank you for your feedback!

                                            Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

                                            Sending your feedback...
                                            🎉 Thank you for your feedback!
                                            Something went wrong. Please try again.

                                            Thanks for your feedback!

                                            thanks-feedback-gif