Rodrigo Rodriguez (Pragmatismo)
3add3ccbfa
Changed incorrect references to .vbs files to .bas and corrected USE_WEBSITE keyword naming. Also added missing fields to API response structure and clarified that start.bas is optional for bots.
98 lines
3.4 KiB
QBasic
98 lines
3.4 KiB
QBasic
REM General Bots: SEND SMS Keyword - Universal SMS Sending
|
|
REM Free SMS sending using Twilio, Nexmo, or other SMS APIs
|
|
REM Can be used by ANY template that needs to send SMS messages
|
|
|
|
PARAM phone_number AS string LIKE "+1234567890"
|
|
PARAM message AS string LIKE "Hello, this is your SMS message"
|
|
PARAM from_number AS string LIKE "+1987654321"
|
|
|
|
DESCRIPTION "Send an SMS message to any phone number"
|
|
|
|
REM Validate inputs
|
|
IF NOT phone_number OR phone_number = "" THEN
|
|
TALK "❌ Phone number is required"
|
|
TALK "💡 Format: +[country code][number] (e.g., +1234567890)"
|
|
RETURN NULL
|
|
END IF
|
|
|
|
IF NOT message OR message = "" THEN
|
|
TALK "❌ Message content is required"
|
|
RETURN NULL
|
|
END IF
|
|
|
|
REM Validate phone number format (basic check)
|
|
IF LEFT(phone_number, 1) <> "+" THEN
|
|
TALK "⚠️ Phone number should start with + and country code"
|
|
TALK "Example: +1234567890"
|
|
END IF
|
|
|
|
REM Check message length (SMS limit is typically 160 characters)
|
|
message_length = LEN(message)
|
|
IF message_length > 160 THEN
|
|
TALK "⚠️ Warning: Message is " + message_length + " characters"
|
|
TALK "SMS messages over 160 characters may be split into multiple messages"
|
|
END IF
|
|
|
|
TALK "📱 Preparing to send SMS..."
|
|
TALK "To: " + phone_number
|
|
TALK "Message length: " + message_length + " characters"
|
|
|
|
REM Create SMS object
|
|
sms_data = NEW OBJECT
|
|
sms_data.to = phone_number
|
|
sms_data.from = from_number
|
|
sms_data.message = message
|
|
sms_data.timestamp = NOW()
|
|
sms_data.status = "pending"
|
|
sms_data.length = message_length
|
|
|
|
REM Calculate estimated cost (example: $0.01 per message)
|
|
segments = INT((message_length - 1) / 160) + 1
|
|
sms_data.segments = segments
|
|
sms_data.estimated_cost = segments * 0.01
|
|
|
|
REM In production, this would integrate with:
|
|
REM 1. Twilio SMS API (https://www.twilio.com/docs/sms)
|
|
REM 2. Nexmo/Vonage API (https://developer.vonage.com/messaging/sms/overview)
|
|
REM 3. AWS SNS (https://aws.amazon.com/sns/)
|
|
REM 4. Azure Communication Services
|
|
REM 5. MessageBird API
|
|
|
|
REM Example Twilio integration (requires API key):
|
|
REM SET HEADER "Authorization" = "Basic " + BASE64(account_sid + ":" + auth_token)
|
|
REM SET HEADER "Content-Type" = "application/x-www-form-urlencoded"
|
|
REM twilio_url = "https://api.twilio.com/2010-04-01/Accounts/" + account_sid + "/Messages.json"
|
|
REM post_data = "To=" + phone_number + "&From=" + from_number + "&Body=" + message
|
|
REM result = POST twilio_url, post_data
|
|
|
|
REM For now, save to queue for processing
|
|
SAVE "sms_queue.csv", sms_data.timestamp, sms_data.from, sms_data.to, sms_data.message, sms_data.segments, sms_data.estimated_cost, sms_data.status
|
|
|
|
TALK "✅ SMS queued successfully!"
|
|
TALK ""
|
|
TALK "📊 SMS Details:"
|
|
IF from_number AND from_number <> "" THEN
|
|
TALK "From: " + from_number
|
|
END IF
|
|
TALK "To: " + phone_number
|
|
TALK "Message: " + LEFT(message, 50) + "..."
|
|
TALK "Segments: " + segments
|
|
TALK "Estimated Cost: $" + sms_data.estimated_cost
|
|
TALK "Time: " + sms_data.timestamp
|
|
TALK ""
|
|
TALK "⚙️ Status: Queued for delivery"
|
|
TALK ""
|
|
TALK "💡 Setup Guide to enable SMS:"
|
|
TALK "1. Sign up for Twilio (free trial available)"
|
|
TALK "2. Get your Account SID and Auth Token"
|
|
TALK "3. Get a Twilio phone number"
|
|
TALK "4. Configure in .gbot settings:"
|
|
TALK " - SMS_PROVIDER (twilio/nexmo/aws)"
|
|
TALK " - SMS_ACCOUNT_SID"
|
|
TALK " - SMS_AUTH_TOKEN"
|
|
TALK " - SMS_FROM_NUMBER"
|
|
TALK ""
|
|
TALK "📚 Twilio Quick Start: https://www.twilio.com/docs/sms/quickstart"
|
|
|
|
REM Return SMS data
|
|
RETURN sms_data
|