Merge pull request #118 from HaripriyaB/send_message_textbelt

Send text message using TextBelt API to any phone number

Author: SANKET7738

Python/Message_using_textbelt/README.md

@@ -0,0 +1,59 @@
+## Send Text Message via TextBelt
+### Description
+The aim is to anonymously send a text message to a mobile number programmatically.
+
+### Library used
+* [requests](https://2.python-requests.org/en/v2.7.0/)
+
+### About TextBelt API:
+*Textbelt* is an SMS API that is built for developers who just want to send and receive SMS.  Sending an SMS is a simple thing.  The API is correspondingly simple, without requiring account configuration, logins, or extra recurring billing.
+
+The `https://textbelt.com/text` endpoint accepts a POST request with the following parameters:
+
+* `phone`: A phone number.  If you're in the U.S. or Canada, you can just send a normal 10-digit phone number with area code.  Outside the U.S., it is best to send the phone number in E.164 format with your country code. 
+* `message`: The content of your SMS.
+* `key`: Your API key (use textbelt to send a free message).
+
+Every programming language has a way to send an HTTP POST request.  Instead of installing a special Textbelt library, just send a POST request.
+
+*Response*
+
+The /text endpoint will respond with JSON:
+* `success`: Whether the message was successfully sent (true/false).
+* `quotaRemaining`: The amount of credit remaining on your key.
+* `textId`: The ID of the sent message, used for looking up its status.  Only present when success=true.  Use this to check SMS delivery status.
+* `error`: A string describing the problem.  Only present when success=false.
+
+### Parameters used and their Significance:
+* phoneNumber : The 10 digit phone number given by the user.
+* message : The message which the user wants to sent to the given phoneNumber.
+
+### Pre-requisites:
+Install requests library via pip/pip3
+
+`>> pip3 install requests`
+
+### Usage:
+`>> python send_message.py`
+
+### I/O:
+
+```
+Enter your 10 digit phone number: $(phone_number)
+
+Enter your message: $(message)
+
+Message successfully sent! 
+```
+
+<img src="ScreenShots/output.png" height=50 width=300>
+</br></br>
+<img src="ScreenShots/message_received.jpg" height=200 width=100>
+
+
+**OR (if sending failed)**
+
+```
+Sorry...Message cannot be sent
+Only one test text message is allowed per day.
+```

Python/Message_using_textbelt/ScreenShots/message_received.jpg

@@ -0,0 +1,25 @@
+import os
+import requests
+
+def send_message(phoneNumber, message):
+    resp = requests.post('https://textbelt.com/text', {
+    'phone':phoneNumber,
+    'message':message,
+    'key':'textbelt',
+    })
+    sent = resp.json()['success']
+    if sent is True:
+        print("Message successfully sent!")
+    
+    else:
+        print("Sorry...Message cannot be sent")
+        print(resp.json()['error'])
+
+def main():
+    phone_number = input("Enter your 10 digit phone number: ")
+    message = input("Enter your message:")
+    send_message(('+91'+str(phone_number)),message)
+
+if __name__ == "__main__":
+    main()
+