Setup

from flask import Flask
from routes import register_routes
import os
from dotenv import load_dotenv

load_dotenv()  # Load .env file

PORT = int(os.getenv("PORT", 9000))
DEBUG = os.getenv("FLASK_ENV", "production") == "development"

app = Flask(__name__)
register_routes(app)  # Auto-register all blueprints

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=PORT, debug=DEBUG)

import os
import importlib
from flask import Blueprint

def register_routes(app):
    routes_dir = os.path.dirname(__file__)

    for filename in os.listdir(routes_dir):
        if filename.startswith("__") or not filename.endswith(".py"):
            continue

        module_name = f"routes.{filename[:-3]}"
        module = importlib.import_module(module_name)

        for attr_name in dir(module):
            attr = getattr(module, attr_name)
            if isinstance(attr, Blueprint):
                prefix = f"/api/{attr.name}"
                app.register_blueprint(attr, url_prefix=prefix)
                print(f"✅ Registered {attr.name} at {prefix}")

import os
import africastalking

AT_USERNAME = os.getenv("AT_USERNAME")
AT_API_KEY = os.getenv("AT_API_KEY")
AT_SHORTCODE = os.getenv("AT_SHORTCODE")

africastalking.initialize(AT_USERNAME, AT_API_KEY)
_sms = africastalking.SMS

def send_bulk_sms(message: str, recipients: List[str]) -> Dict[str, Any]:
    """Send bulk SMS to multiple recipients"""
    response = _sms.send(message, recipients)
    return response

def send_twoway_sms(message: str, recipient: str, shortcode: str = AT_SHORTCODE):
    """Send two-way SMS from a shortcode"""
    response = _sms.send(message, [recipient], shortcode)
    return response

import os
import africastalking

AT_USERNAME = os.getenv("AT_USERNAME")
AT_API_KEY = os.getenv("AT_API_KEY")
AT_VOICE_NUMBER = os.getenv("AT_VOICE_NUMBER")

africastalking.initialize(AT_USERNAME, AT_API_KEY)
_voice = africastalking.Voice

def make_call(phone_number: str, from_number: str = AT_VOICE_NUMBER):
    """Initiate an outbound voice call"""
    response = _voice.call(callTo=[phone_number], callFrom=from_number)
    return response

EnvironmentError: ❌ Missing Africa's Talking credentials (AT_USERNAME / AT_API_KEY)

# Check if .env exists
cat .env

# Restart server
make dev

OSError: [Errno 48] Address already in use

PORT=5000  # or any other available port

# macOS/Linux
lsof -ti:9000 | xargs kill -9

# Windows
netstat -ano | findstr :9000
taskkill /PID <PID> /F

curl -X POST https://YOUR_NGROK_URL/api/sms/delivery-reports \
  -d "id=test123" \
  -d "status=Success" \
  -d "phoneNumber=+254712345678"

ModuleNotFoundError: No module named 'africastalking'

pip install -r requirements.txt

pip install flask-cors

from flask import Flask
from flask_cors import CORS
from routes import register_routes

app = Flask(__name__)
CORS(app)  # Enable CORS for all routes
register_routes(app)