Webhook Configuration

# Send a test SMS (replace with your tunnel URL and phone number)
curl "https://abc123.ngrok.io/api/sms/invoke-bulk-sms?phone=254711000000&message=Hello+Test"

# Initiate a test call (replace with your tunnel URL and phone number)
curl "https://abc123.ngrok.io/api/voice/invoke-call?phone=254711000000"

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Say>Welcome to the service. This is a demo voice application. Goodbye.</Say>
</Response>

# Send test airtime (sandbox won't actually send, but will trigger callbacks)
curl "https://abc123.ngrok.io/api/airtime/invoke-send-airtime?phone=254711000000&amount=10&currency=KES"

{
  "transactionId": "SomeTransactionID",
  "phoneNumber": "+254711XXXYYY",
  "sourceIpAddress": "127.12.32.24",
  "currencyCode": "KES",
  "amount": 500.00
}

{
  "status": "Validated"  // or "Failed"
}

{
  "phoneNumber": "+254711XXXYYY",
  "description": "Airtime Delivered Successfully",
  "status": "Success",
  "requestId": "ATQid_SampleTxnId123",
  "discount": "KES 0.6000",
  "value": "KES 100.0000"
}

# Check SIM swap status
curl "https://abc123.ngrok.io/api/sim-swap/invoke-check-simswap?phone=254711000000"

{
  "status": "Swapped",
  "lastSimSwapDate": "01-01-1900",
  "providerRefId": "fe3b-46fd-931c-b2ef3a64da93311064104",
  "requestId": "ATSwpid_4032b7bfddd5fdca0c401184a84cbb0d",
  "transactionId": "738e202b-ea2f-43e5-b451-a85334e90fb5"
}

# Continue session
response = "CON What would you want to check \n"
response += "1. My Account \n"
response += "2. My phone number"

# End session
response = "END Your phone number is +254711000000"

from flask import request, abort

def verify_africastalking_webhook():
    # Check user agent
    user_agent = request.headers.get('User-Agent', '')
    if 'AfricasTalking' not in user_agent:
        abort(403)  # Forbidden
    
    # Additional validation logic here
    # E.g., check IP addresses, verify signatures, etc.

import logging

logger = logging.getLogger(__name__)

@sms_bp.route("/delivery-reports", methods=["POST"])
def sms_delivery_report():
    payload = {key: request.values.get(key) for key in request.values.keys()}
    
    logger.info(f"SMS Delivery Report: {payload}")
    
    # Process the payload
    return "OK", 200

@sms_bp.route("/delivery-reports", methods=["POST"])
def sms_delivery_report():
    payload = {key: request.values.get(key) for key in request.values.keys()}
    
    # Log immediately
    print(f"Received: {payload}")
    
    # TODO: Queue for background processing
    
    # Return quickly
    return "OK", 200

# Replace abc123.ngrok.io with your tunnel URL
BASE_URL="https://abc123.ngrok.io"

# SMS
curl "${BASE_URL}/api/sms/invoke-bulk-sms?phone=254711000000&message=Test"

# Voice
curl "${BASE_URL}/api/voice/invoke-call?phone=254711000000"

# Airtime
curl "${BASE_URL}/api/airtime/invoke-send-airtime?phone=254711000000&amount=10"

# SIM Swap
curl "${BASE_URL}/api/sim-swap/invoke-check-simswap?phone=254711000000"

# Missing required parameter
curl "${BASE_URL}/api/sms/invoke-bulk-sms?message=Test"

{
  "error": "Missing 'phone' query parameter"
}

https://abc123.ngrok.io/api/sms/delivery-reports

https://api.yourdomain.com/api/sms/delivery-reports