In the " article, I documented the foundation for a new SaaS solution that I am building (initially for my sister-in-law) — utilizing the Heroku ecosystem. At the end of that article, I had planned to write about the core technologies (Spring Boot, Angular 9, ClearDB, Okta, GitLab and Heroku) in place, as we raced for the 1.0.0 release of the solution. "Using Heroku to Quickly Build a Multi-Tenant SaaS Product However, things have been moving fast around here, and I largely attribute the speed of development and end-user adoption to everything that Heroku brings to the table for this service. As I have noted before, using Heroku as the destination for my service and GitLab's built-in CI/CD pipelines — updates that are merged from a feature branch into the master branch of the client or service are automatically deployed into production (Heroku) without any further intervention. Instead of starting the 1.0.1 release, the project is actually finishing up the 1.0.3 release.  Below is an updated feature map: Progress Via Screenshots Since using Spring JPA to create the initial schema, which it did without any issues, I have been keeping the fitness.sql up to date manually as model updates have been required.  Using IntelliJ IDEA and built in database tooling (including yFiles), I was able to quickly create the following diagram of the current MySQL/ClearDB database structure: As noted in the prior article, everything ties back to the ID of the tenant (or fitness trainer) - which is also enforced in the base JPA Specifications employed at the service level. These changes, along with screens for Client configuration and Workout configuration, allowed the Session screen to be introduced: The Sessions (which is an instance of a workout and at least one client) are presented in an optional calendar view to give the trainer a view which is easy to comprehend at a glance: In the example above, there is only one event scheduled - since the screen shot is from my test account in the production instance of the SaaS solution. There is also a training-mode version of the Session screen, which is mainly a read-only adaptation and consolidates data for quick reference. The icons on this screen are still active, so that that trainer can not only check-in clients, but also provide session information (score and comments) too: Along the Way ... Twilio Was Discovered One of items which was slated for the 1.0.4 release was referred to as Client Check-In.  We soon realized the having a mechanism for the trainer to communicate with the clients was an important aspect, which needed to be handled next. Below are the requirements that were employed for this feature: send reminders to clients ~24 hours before their scheduled session send a workout summary after their workout resend a reminder for a session allow trainer to send a broadcast text message (e,g, "I am going to be on vacation") provide a link to allow client to confirm/cancel their session (planned for a future article) Since the concept of a mobile client is beyond the current feature roadmap, I needed to find a solution that would work with most clients. Knowing that each client was communicating with my sister-in-law via a mobile device, I decided to use SMS (or text messages) to provide a lightweight client for the application. It did not take long to settle on Twilio — especially since two colleagues ( and ) who broadcast on Twitch had been participating in Twilio's " " awesome learning experience. In fact, I would not be surprised if both still have videos on their channels of them playing the "TwilioQuest" game. roberttables blendedsoftware TwilioQuest Twilio provides the functionality I need with a robust API. I was able to quickly set up a trial account (which communicates only with mobile numbers that are added to the system), but that was enough for me to validate the functionality. Preparing for Twilio The first step is to create a new account in Twilio by visiting the following URL: https://www.twilio.com/try-twilio Which should direct first-time users to a screen similar to what is shown below: Once everything is setup, the Twilio dashboard will appear as shown below: The Account SSID and Auth Tokens are accessible via this screen. I wanted to configure Twilio programmatically in mode project, so that using my production instance of Twilio was based upon environment variables passed in from Heroku. Below is a list of the attributes that I am managing in my API: jvc:
sms:
   twilio:
     enabled: ${TWILIO_ENABLED}
     account-sid: ${TWILIO_ACCOUNT_SID}
     auth-token: ${TWILIO_AUTH_TOKEN}
     phone-number: ${TWILIO_PHONE_NUMBER}
     enable-reply: ${TWILIO_ENABLE_REPLY}
     reply-host: ${TWILIO_REPLY_HOST}
     trial: ${TWILIO_IS_TRIAL}
     trial-phone-number: ${TWILIO_TRIAL_PHONE_NUMBER}
     cron-schedule-reminder: cron-schedule-summary: "0 17 * * * ?" "0 27 * * * ?" The README.md for my API repository provides the documentation details for the environment-specific values: ${TWILIO_ENABLED} - Twilio (SMS) enabled [jvc.sms.twilio.enabled] (set to order to disable SMS)
${TWILIO_ACCOUNT_SID} - Twilio (SMS) account SID [jvc.sms.twilio.account-sid] (leave unset to disable SMS, recommended non-Production environments)
${TWILIO_AUTH_TOKEN} - Twilio (SMS) auth token [jvc.sms.twilio.auth-token]  (leave unset to disable SMS, recommended non-Production environments)
${TWILIO_PHONE_NUMBER} - Twilio (SMS) phone number to use sending messages [jvc.sms.twilio.phone-number]
${TWILIO_ENABLE_REPLY} - Twilio (SMS) enablement reply functionality [jvc.sms.twilio.enable-reply]
${TWILIO_REPLY_HOST} - Twilio (SMS) reply host URL ( Angular client) to use when reply functionality is enabled [jvc.sms.twilio.reply-host] (value should not end a /)
${TWILIO_IS_TRIAL} - Twilio (SMS) trial indicator [jvc.sms.twilio.trial] (use non-Production instances)
${TWILIO_TRIAL_PHONE_NUMBER} - Twilio (SMS) trial phone number to send to [jvc.sms.twilio.trial-phone-number] (use non-Production instances) false in for for for of of with for for The cron based items determine the schedule of the session reminder and session summary jobs which are running in each environment (if enabled). Within Spring Boot, a simple TwilioConfigurationProperties class was created: @Data
@Configuration( )
@ConfigurationProperties( )
public {
   private boolean enabled;
   private accountSid;
   private authToken;
   private phoneNumber;
   private boolean enableReply;
   private replyHost;
   private boolean trial;
   private trialPhoneNumber;
   private cronScheduleReminder;
   private cronScheduleSummary;
} "twilioConfigurationProperties" "jvc.sms.twilio" class TwilioConfigurationProperties String String String String String String String With these values set up, I can use the Run/Debug dialog in IntelliJ IDEA to pass in the expected values: In Heroku, these values are set up in the environment: Keep in mind, the Heroku values are different, because that is actually the production instance that I have running. The Sms Service Within the SmsService, the following public methods are available: @RequiredArgsConstructor
@Slf4j
@Service
@Transactional
public {
 @Resource(name = )
 private UserData userData;
 private final AttendeeRepository attendeeRepository;
 private final MotivationalQuoteRepository motivationalQuoteRepository;
 private final SessionRepository sessionRepository;
 private final TwilioConfigurationProperties twilioConfigurationProperties;
 public sendGroupMessage(GroupSmsMessage groupSmsMessage) throws FitnessException { }
 public sendSimpleMessage(SimpleSmsMessage simpleSmsMessage) { }
 public resendSingleReminder(long attendeeId) { }
 @Scheduled(cron = )
 public sendSmsMessages() { }
 @Scheduled(cron = )
 public sendSmsSummaryMessages() { }
} class SmsService "requestScopeUserData" void // allows a trainer to send a SMS message to a select group of customers void // allows the system to send a single SMS message, which is used to send a message to the trainer each time a client confirms or cancels their session void // allows the trainer to render the session reminder. "${jvc.sms.twilio.cron-schedule-reminder}" void // allows the trainer to render the session reminder. "${jvc.sms.twilio.cron-schedule-summary}" void // ran hourly, provides a workout summary (including a random fitness quote) to the customer - which can include: // -  the score from the session // - any comments provided by the trainer // - a random fitness quote These methods are called either by a scheduled task or triggered from a request from the Angular client. The next section presents and example of how the Angular client interacts with the Spring Boot service in order to communicate with the Twilio service. Example - Sending a Group Message Sending a Group Message is initiated by the Angular client.  An example is shown below: The request is passed to the following controller in Spring Boot: @PostMapping(value = )
public ResponseEntity<Void> postSession(@RequestBody GroupSmsMessage groupSmsMessage) { {
       smsService.sendGroupMessage(groupSmsMessage); ResponseEntity<>(HttpStatus.CREATED);
   } (FitnessException e) {
       log.error(e.getMessage()); ResponseEntity<>(HttpStatus.BAD_REQUEST);
   }
} "/sms" try return new catch return new The GroupSmsMessage object has the following properties: @Data
public {
   private messageBody;
   private List<ClientDto> distributionList = ArrayList<>();
} class GroupSmsMessage String new The controller then calls the following method: public sendGroupMessage(GroupSmsMessage groupSmsMessage) throws FitnessException {
   log.info( , groupSmsMessage); (CollectionUtils.isEmpty(groupSmsMessage.getDistributionList())) { FitnessException(FitnessException.ENTITIES_MISSING, );
   } (StringUtils.isEmpty(groupSmsMessage.getMessageBody())) { FitnessException(FitnessException.ENTITIES_MISSING, );
   } (!smsEnabled()) { FitnessException(FitnessException.UNAUTHORIZED, );
   }
   Twilio.init(twilioConfigurationProperties.getAccountSid(), twilioConfigurationProperties.getAuthToken());
   log.info( );
   logSmsInformation();
   int successCount = ;
   int errorCount = ; (ClientDto clientDto : groupSmsMessage.getDistributionList()) {
       Message message = Message.creator( PhoneNumber(twilioConfigurationProperties.isTrial() ? twilioConfigurationProperties.getTrialPhoneNumber() : clientDto.getPersonDto().getPhoneNumber()), PhoneNumber(twilioConfigurationProperties.getPhoneNumber()),
         groupSmsMessage.getMessageBody())
         .create(); (message.getErrorCode() == && StringUtils.isEmpty(message.getErrorMessage())) {
           successCount++;
       } {
           errorCount++;
           log.error( + message.getErrorCode() + +  message.getErrorMessage() + + groupSmsMessage.getMessageBody());
       }
   }
   log.info( , successCount, errorCount);
   log.info( );
} void "sendGroupMessage(groupSmsMessage={})" if throw new "Could not send group SMS message to an empty distribution list." if throw new "Could not send group SMS message with an empty message body." if throw new "sendGroupMessage() SMS is NOT enabled to run on this instance" "sendGroupMessage() started" 0 0 for new new if null else "Error #" "(" ") occurred sending smsMessage=" "Successfully sent {} SMS messages ({} errors)" "sendGroupMessage() completed" In the code above, after checking for elements which can yield a Fitness exception, the Twilio.init() method is called.  Thereafter, a Message is created and the logic has been included to function in production and non-production environments.  This basically ties to using the provided trial phone number when not running in production.  Everything else is straight forward and pass the data received by the Angular client directly to the target distribution list. Conclusion The goal of this article was to outline some client communication needs for the SaaS solution I am building.  Thereafter, I provided an example of how easy it is to create a Twilio instance and integrate the solution into my Spring Boot service and Angular client.  Using Spring Boot and an Angular client, I was able to quickly and easily get SMS communication configured in use within a matter of hours.  In my view, Twilio provides an awesome compliment to the services I am using with Heroku. From a cost perspective, my sister-in-law has been using the SMS functionality for right at two months now and I just added more money into my production Twilio account two days ago.  At this point, the total usage has been right at $10 a month - which is far less than I expected to use. In the next article, I plan to discuss how Twilio was used to send the session reminder, providing a mechanism where clients can confirm or cancel their attendance to this session.  I had initially planned to include everything in one article, but I felt it would be better to create an article dedicated to this functionality.  In another future article, I plan to dive into how an end-user's reply to the original (Twilio) SMS can be redirected to the actual trainer for that customer. Exciting articles planned, for sure! (Published with the kind permission of John Vester from the original at DZone )

Heroku

Target

An Awesome Tool To Quickly Create An Amazon-Like Recommendation Engine 

The Best Solution Ever For Application Monitoring

I write about technology michael.bogan@gmail.com

Nominated for 2022 - HackerNoon Contributor of the Year - Software Architecture

Nominated for 2022 - HackerNoon Contributor of the Year - Microservices

Nominated for 2022 - HackerNoon Contributor of the Year - Devops

Nominated for 2022 - HackerNoon Contributor of the Year - Api

Nominated for 2022 - Software Developer of the Year

Nominated for 2022 - HackerNoon Contributor of the Year - Software

Too Long; Didn't Read

Make resilience your competitive advantage

How To Easily Integrate Twilio Into Your SaaS Startup [Part 2]

How To Easily Integrate Twilio Into Your SaaS Startup [Part 2]

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

Heroku Now Officially Supports .NET!

100 Days of AI Day 1: From Newsletter to Podcast, Leveraging AI for Audio Transformation

10 Threats to an Open API Ecosystem

10 Indications That You Should Invest in Automation Via APIs

10 Best Practices for Securing Your API

Heroku Now Officially Supports .NET!

100 Days of AI Day 1: From Newsletter to Podcast, Leveraging AI for Audio Transformation

10 Threats to an Open API Ecosystem

10 Indications That You Should Invest in Automation Via APIs

10 Best Practices for Securing Your API

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps