Project Dashboard

send_message.py

import requests

# --- CONFIGURATION ---
# Replace with your actual Join API key
API_KEY = "YOUR_API_KEY_HERE" 
# Replace with the ID of the device you want to send from
DEVICE_ID = "YOUR_DEVICE_ID_HERE"
# The phone number you want to send the message to
RECIPIENT_NUMBER = "+447911123456" # Use international format
# The message you want to send
MESSAGE_TEXT = "Hello from my Python script! This is a test message sent via the Join API."

def send_join_message(api_key, device_id, number, text):
    """
    Sends an SMS/RCS message using the Join API.
    """
    print(f"Attempting to send message to {number}...")

    # Construct the API URL with all the required parameters
    api_url = (
        f"https://joinjoaomgcd.appspot.com/_ah/api/messaging/v1/sendPush"
        f"?apikey={api_key}"
        f"&deviceId={device_id}"
        f"&sms_number={number}"
        f"&sms_text={text}"
    )

    try:
        # Make the GET request to the Join API
        response = requests.get(api_url)
        
        # Raise an exception if the request returned an error (e.g., 401, 404)
        response.raise_for_status()

        # The Join API returns a JSON response. Let's check it.
        json_response = response.json()

        if json_response.get("success"):
            print("✅ Success! The command was sent to your device.")
            print("Please check your phone to confirm the message was sent.")
        else:
            # This usually means your API key or device ID was wrong
            print(f"❌ Error: The API returned an error.")
            print(f"   Message: {json_response.get('errorMessage', 'No error message provided.')}")

    except requests.exceptions.RequestException as e:
        print(f"❌ A network error occurred: {e}")
    except Exception as e:
        print(f"❌ An unexpected error occurred: {e}")


# --- EXECUTION ---
if __name__ == "__main__":
    send_join_message(API_KEY, DEVICE_ID, RECIPIENT_NUMBER, MESSAGE_TEXT)