add example app code for testing template-only-app

Author: jrpbc

template-only-app/app.py

@@ -6,6 +6,7 @@
 from flask import Flask, redirect, render_template, request
 
 import notifications
+import sms_notifications
 import storage
 from db import get_db_connection
 from feature_flags import is_feature_enabled
@@ -106,6 +107,28 @@ def cron():
     conn.execute("SELECT 1")
     print("Hello from cron job")
 
+@app.route("/sms-notifications", methods=["GET", "POST"])
+def sms_notifications_page():
+    logger.info("Accessed /sms-notifications endpoint with method %s", request.method)
+    if request.method == "POST":
+        phone_number = request.form.get("phone_number")
+        message = "This is a test SMS from Strata Platform."
+
+        # Check opt-out status first
+        opt_out_status = sms_notifications.check_opt_out_status(phone_number)
+        if opt_out_status.get("opted_out"):
+            return f"Cannot send SMS: {phone_number} has opted out of messages."
+
+        # Send SMS
+        result = sms_notifications.send_sms(phone_number, message)
+        logger.info("SMS send result: %s", result)
+
+        if result["success"]:
+            return f"SMS sent successfully to {phone_number}. Message ID: {result['message_id']}"
+        else:
+            return f"Failed to send SMS: {result['error']} (Code: {result.get('error_code', 'Unknown')})"
+
+    return render_template("sms_form.html")
 
 if __name__ == "__main__":
     main()

template-only-app/sms_notifications.py

@@ -0,0 +1,90 @@
+import logging
+import os
+import boto3
+import json
+from botocore.exceptions import ClientError
+
+logging.basicConfig()
+logger = logging.getLogger()
+logger.setLevel(logging.INFO)
+
+def send_sms(phone_number, message, message_type="TRANSACTIONAL"):
+    """
+    Send SMS via AWS End User Messaging (PinpointSMSVoiceV2)
+    """
+    try:
+        logger.info("Initializing AWS Pinpoint SMS Voice V2 client")
+        client = boto3.client("pinpoint-sms-voice-v2")
+        phone_pool_id = os.environ.get("AWS_SMS_PHONE_POOL_ID")
+        configuration_set = os.environ.get("AWS_SMS_CONFIGURATION_SET_NAME")
+        logger.info("Sending SMS Using Configuration Set: %s", configuration_set)
+        logger.info("Sending SMS Using Phone Pool ID: %s", phone_pool_id)
+
+        params = {
+            "DestinationPhoneNumber": phone_number,
+            "OriginationIdentity": phone_pool_id,
+            "MessageBody": message,
+            "MessageType": message_type
+        }
+
+        # Add configuration set for tracking
+        if configuration_set:
+            params["ConfigurationSetName"] = configuration_set
+
+        # Add context for tracking (optional)
+        params["Context"] = {
+            "ApplicationName": "template-app",
+            "Environment": "dev"
+        }
+
+        if check_opt_out_status(phone_number).get("opted_out"):
+            logger.warning("Phone number %s has opted out of SMS messages. Aborting send.", phone_number)
+            return {
+                "success": False,
+                "error": f"Phone number {phone_number} has opted out of SMS messages."
+            }
+
+        response = client.send_text_message(**params)
+
+        return {
+            "success": True,
+            "message_id": response.get("MessageId"),
+            "response": response
+        }
+
+    except ClientError as e:
+        error_code = e.response["Error"]["Code"]
+        error_message = e.response["Error"]["Message"]
+        logger.error(f"ClientError: {error_code} - {error_message}")
+
+        return {
+            "success": False,
+            "error": error_message,
+            "error_code": error_code,
+            "details": str(e)
+        }
+    except Exception as e:
+        return {
+            "success": False,
+            "error": str(e)
+        }
+
+def check_opt_out_status(phone_number):
+    """
+    Check if a phone number is opted out
+    """
+    try:
+        client = boto3.client("pinpoint-sms-voice-v2")
+
+        response = client.describe_opted_out_numbers(
+            OptOutListName="default",
+            OptedOutNumbers=[phone_number]
+        )
+
+        opted_out_numbers = response.get("OptedOutNumbers", [])
+        is_opted_out = any(num["OptedOutNumber"] == phone_number for num in opted_out_numbers)
+
+        return {"opted_out": is_opted_out}
+
+    except Exception as e:
+        return {"error": str(e)}

template-only-app/templates/sms_form.html

@@ -0,0 +1,24 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <title>SMS Test</title>
+</head>
+<body>
+    <h1>Send Test SMS</h1>
+    <form method="post">
+        <div>
+            <label for="phone_number">Receiver Phone Number (E.164 format: +1234567890):</label><br>
+            <input type="tel" id="phone_number" name="phone_number"
+                   pattern="^\+[1-9]\d{1,14}$"
+                   placeholder="+1234567890"
+                   required><br>
+            <small>Must include country code (e.g., +1 for US)</small><br>
+            <small><strong>If using simulator phone numbers for testing:</strong><br>
+            • +14254147755 (Success Text testing)<br>
+            • +14254147167 (Text Blocked testing)</small>
+        </div>
+        <br>
+        <button type="submit">Send Test SMS</button>
+    </form>
+</body>
+</html>