PicoMSG - Phone as a SMS Gateway for Bulk SMS Marketing

Documentation version 1.0


Introduction


First of all, Thank you so much for purchasing this script and for being my loyal customer. You are awesome!
You are entitled to get six month updates to this product + exceptional support from the author directly.

This documentation is to help you regarding each step of integration. Please go through the documentation carefully to understand how this tool is made and how to install this properly. Basic configutarion knowledge is required to install this script.

How to Install

Installation -

Our app is easy to install. First download the app from download list. It will be packed as a zipped file. You can choose to either input into your server or control panel It is completely explained below.

Please note that installation steps or options may differ on your server depending.


Installation overview -

Here is a quick overview of the installation steps that you have to follow. Please follow these steps in order to minimize the probability of something going wrong:


Requirements -

PHP >= 7.3
BCMath PHP Extension
Ctype PHP Extension
Fileinfo PHP extension
JSON PHP Extension
Mbstring PHP Extension
OpenSSL PHP Extension
PDO PHP Extension
Tokenizer PHP Extension
XML PHP Extension


Importing using ftp or control panel -

This method will work for any server that has either an FTP account set up or another method of copying files to the server

You must upload the app_v1_x.zip file into the public_html directory. Once you have done so, you will need to extract the contents of the zip files into the

public_html directory. Assuming you have done this correctly. You can now delete the zip file if you think it necessary to save space.


Now find .env file and edit or change
DB_HOST= your database host
DB_PORT= your database port number
DB_DATABASE= your database name
DB_USERNAME= your database username
DB_PASSWORD= your database password

You have to import the picomsg_v1_x.sql file into your database.
You can find the picomsg_v1_x.sql in project zip file

Cron setup

Add {your_host}/process/email into your cron for campaign create, group create/import and sending email to contact email

Example Cron: wget -q -O - https://gateway.picotech.app/process/email

How To Upgrade

i) First replace all the codes from v1_Y to v1_x (here x is the item current version and y is the previous version) except .env file
ii)You may want to copy the nessasary files like profile picture from previous "public\uploads" directory to new "public\uploads"
iii) Change from APP_DEBUG=false to APP_DEBUG=true in .env file
iv) Go to the url "{your_host}/process/upgrade" ( you will show a message 'Database upgrade has been finished' )
v) Change from APP_DEBUG=true to APP_DEBUG=false in .env file
you are good to go. Thanks.

How to use PicoMSG

This application contains two types of users.

i) Admin
ii) Customer

All are completely explained below-

(i)Admin Panel

Admin Dashboard

Customer List

Local Settings

Email Settings

Payment Gateway

Email Template

Ticket System

Plan List



(ii) Customer

Dashboard

Quick Send

Create Campaign

List Builder

Add Device

Device List

Sending Settings

How to use the Mobile APP?

Your customer can download the apk file provide in the project file picomsg_v1_x.apk and install to use the phone as a gateway.
You can upload the APK to google drive or any server where the file is downloadable. Then paste the link to application setting. Check below screenshot:
AdminPanel->Settings->Application

App Login Screen:

Allow Permissions to process further

After allowing, you can login using customer login credentials or QR Code scaning. QR Code can be generated from Customer Panel->Device->Add Device


Then just press the play button to process all your queue messages.

How to run APK Source Code

This android app was built with React Native v0.67.2

Follow the steps below to run the source code on your computer for modification purpose, although we don't recommend any modification as you will get full APK file with the project source code.
  1. Unzip the android_app_src.zip on your prefered location ex: E:\ReactNative\gateway
  2. Open the terminal on that location
  3. Run npm install
  4. After completing the installation run npx react-native run-android
NB: Before installation, make sure you have your environment setup correctly. For environment setup follow react native step by step documentation this link. Also we don't support any installation issues you may occur regarding environment setup

After modification you can follow this to build your APK

Copyright and license

Copyright Pico Technology 2022
Pico Technology