Metadata-Version: 2.1
Name: intelli-sms-gateway
Version: 0.1.5
Summary: A package extending developable features of the Intelli-Africa Solutions SMS Gateway
Home-page: UNKNOWN
Author: Intelli Africa Solutions
Author-email: info@intelliafrica.solutions
License: MIT
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# Overview

1. Installation

2. Authenticate

3. Assign CSV file path to variable CSV for a bulk sms

4. Call either method for sending bulk or single SMSs


# 1. Installation

```Shell
pip install intelli-sms-gateway # For Windows

pip3 install intelli-sms-gateway # For Linux
```

### Should dependencies fail to automatically install
```Shell
pip install requests && pip install pandas

#OR

pip3 install requests && pip3 install pandas

```


# 2. Authentication




**Instantiate Client class byt passing the parameters email and password in that order**
```Python
from intelli_sms_gateway.client import Client

# Import the client class from the client module

client = Client('foo@foo.com', 'password')

# This line of code with Authenticate you. Should you not be authenticated, it will raise an exception
```

*Should the client be authenticated, this instantiation will return a property of value True. The reverse is true.*



# 3. Getting Details On a Bulk SMS from a CSV



*Define a variable, assign to it the path of the csv file you want to use*
**Make sure the first column in the CSV is named 'numbers' or the program will return errors. Phone numbers must be in the format 263777534224**


# 4. Sending the messages



## Bulk SMSes




*Call the single SMS method of the client instance and pass the required parameters namely: message, csv, title*
**The CSV that is being passed is the variable that contains the path to the CSV. Should the path be incorrect, errors will be raised**

```Python
# We send a bulk SMS after authentication

client.send_bulk_sms('Please attend the meeting at 1pm', csv_variable, 'Meeting announcament')
```



## Single SMSes






*Call the single SMS method of the client instance and pass the required parameters namely: message, receiver, title*
**Phone numbers must be in the format 263777534224**

```Python
# We send a single SMS after authentication

client.send_single_sms('Please attend the meeting at 1pm', '263777534224', 'Meeting announcament')
```


#  *If your credentials are correct, your messages will not be sent*


