Gateway App Builder

You will need to build your gateway app in order to use Android as SMS gateway. This guide will cover the building instructions.

Our system will do the dirty work for you. You'll be able to completely change the application's look and feel by using your own app package name, app name, app icon, app logo, app colors.

Important

Before we proceed, please read and understand this. The application package name, it should be unique and follow a domain format like com.yourdomain.yourapp, we recommend following your domain name to make it unique. Please follow the package name guide below.

• Package names must be written in all lower case.

• It should only contain alphanumeric characters.

• It should not contain more than four dots and less than two dots.

• Names separated by dots in package name must not start with a number.

• You should not use the following reserved keywords: abstract, assert, boolean, break, byte, case, catch, char, class, const, continue, default, double, do, else, enum, extends, false, final, finally, float, for, goto, if, implements, import, instanceof, int, interface, long, native, new, null, package, private, protected, public, return, short, static, strictfp, super, switch, synchronized, this, throw, throws, transient, true, try, void, volatile, while

Required App Credentials

• Please visit this link: https://console.firebase.google.com

• Click Create a Firebase project

• Create a unique project name, tick the box and click Continue

• Unselect Gemini AI and click Continue

• Unselect google analytics and click Create project

• In the console dashboard, click the android icon

• Enter your desired app package name, please use a unique combination, you can use your site domain if needed then click Register app

• Download the google-services.json file then click Next until the Continue to the console shows up

• In the console dashboard, click the Package name the (com.domain.gate...) tab then click the Settings icon

• Click the Service accounts tab

• Download your firebase credentials json file by clicking the Generate new private key -> Generate key button

• After carefully following these instructions, you should have obtained the following files:
  - google-services.json file
  - firebase service account json file

Create a Build Request

1. Login to our customer dashboard using the Envato account you used to purchase Zender: https://dashboard.titansystems.ph

2. In the sidebar menu, go to Zender -> Gateway: https://dashboard.titansystems.ph/zender/gateway

3. Click the New Build button

4. Select the release version. If you are using the latest version of Zender, you always choose the Latest version of the gateway app.

5. Enter the App Name.

6. Select the App Primary Color, this is the main color.

7. Select the App Primary Dark Color, this is the darker version of the main color.

8. Select App Color Accent, this should be the lighter version of the main color.

9. Enter your Zender site domain:
   - If your Zender is using a subdomain, then enter the subdomain like https://subdomain.domain.com
   - If your Zender is using a top level domain, enter the domain like https://domain.com
   - If your Zender is installed in a sub directory of a domain, enter the domain like https://domain.com/zneder_directory
   - The build form will tell you if the domain you entered is invalid.

10. Select the app icon zip file you downloaded from https://icon.kitchen
    - Please select Android when designing the icon.
    - Upload the zip file as-is. No need to extract it.

11. Select the App Logo for Light Mode
    - This image must be dark to be seen on light mode.
    - The image dimensions must be 251x53 in px and png format.

12. Select the App Logo for Dark Mode
    - This image must be light to be seen on dark mode.
    - The image dimensions must be 251x53 in px and png format.

13. Select the google-services.json you obtained earlier. The package name you used in the google-services-json will be extracted automatically by our system to use it as the package name of the apk.

14. Select the License you want to use for the build
    - This is only used for tracking the build count, it doesn't affect your Zender site even if it has a different license used.

15. Press submit and wait for build emails.

Uploading to Zender

1. If the build for your gateway app is successful, you should be able to download the apk file from the same page where you created a build request.

2. Login to your Zender then navigate to Admin Panel -> Overview

3. You should see a widget for gateway app information and settings:

   

4. Click SETTINGS and you should see this:

   

   • Select the apk file you downloaded from the customer dashboard. Do not rename the apk file and just upload as-is.

   • Select the firebase credentials json you obtained from the earlier guide. Please note that google-services.json and firebase credentials json file are not the same!

5. Press SUBMIT and you should now be able to use the app normally.

Common App Questions

App Not Working

If the gateway app is not working or messages are not being sent from the queue. Please check if your Android device has Google Play Services. This service is required for the app to function normally because the app uses FCM for transactions. Also check if the device date and time are correctly synced from the internet.

Google Play Store

There was a policy change from Google for all apps requiring SMS-related permissions, as you can see here. The app was not specifically designed for submission to Google Play, but there is a built-in add device feature in the script for downloading your gateway app, thus allowing your users to easily get the apk file.