Documentation / AWG-SAAS

Overview

PLEASE READ!

Each new account will be rewarded 100 credits, you can use 1 credit to send 1 message.
You will get another 100 credits each day.
Using FREE CREDITS to send message will have a footer text.
If you don't want to show footer message, you need to topup credits.
Sending using FREE CREDITS = have footer message
Sending using MAIN CREDITS = NO footer message


Go to top

Register

HOW TO REGISTER A NEW ACCOUNT?
  • Creating a new account is easy. Just go here: Registration page, then input all the information asked.
  • Don't forget to tick the Terms of Use and Privacy Policy checkbox.
NOW I HAVE AN ACCOUNT. WHAT'S NEXT?

Go to top

Login

HOW TO LOGIN TO THE PLATFORM?
  • Please head over to: Login page, then input your email and password
I DON'T HAVE AN ACCOUNT YET?
  • Creating a new account is easy. Just go here: Registration page, then input all the information asked.
  • Don't forget to tick the Terms of Use and Privacy Policy checkbox.

Go to top

New Device

HOW TO ADD NEW DEVICE?
  1. Go to: Devices page
    Click "Add new" button
  2. Input device name and Whatsapp phone number with country code.

Go to top

Connect Device

HOW TO CONNECT DEVICE TO WHATSAPP
  1. Go to: Devices page
    Click "Actions" button, choose "View Device"
  2. You will see QR code if you have not connected to Whatsapp, you will see your Whatsapp profile picture if you are connected.
  3. Scan the QR code and wait until you see your Whatsapp profile picture.

Go to top

Send Message

  1. Go to: Send Message page
  2. Select sender
  3. Input receiver (single or multi)
  4. Input message text
  5. Click "Send"

Go to top

Phonebook

  • Go to menu "Phonebooks" >> click on the "Add new" button to import from excel XLSX file.
    Please download the sample XLSX file for guidance.
  • Go to menu "Phonebooks" >> click on the "PHONEBOOK DATA" to show the contacts >> click on the "Name"/"Phone" to edit contact.

Go to top

Send Campaign

  • What is Rotator?
    If you have 2 or more sender devices, you can rotate the senders while you sending bulk messages.
    The proccess: sender1, sender2, sender3, …., senderX, then go back again to sender1, sender2, ….until the job is done.

Go to top

Inspiring Quote

  • Now you can send bulk messages/campaign with more random with random "Inspiring quote" on each message located at the bottom of the message.

Go to top

Send Poll

Use Send Message menu

  1. Go to Send Message menu
  2. Select sender
  3. Input receiver (single or multi)
  4. Message text:
    {
     "pollMessage": {
       "name": "Poll message name",
       "selectableCount": 1,
       "values": [
         "value 1",
         "value 2"
       ]
     }
    }
  5. Click "Send"

Use Autoreply menu

  1. Go to Autoreply menu
  2. Add new Autoreply
  3. Put keyword POLL (or any keyword you like)
  4. Put response like below:
    {
     "pollMessage": {
       "name": "Poll message name",
       "selectableCount": 1,
       "values": [
         "value 1",
         "value 2"
       ]
     }
    }
  5. Click "Save" to save

Save as message template

  1. Go to Templates menu
  2. Add new template
  3. Put template name
  4. Put in template msgtext like below:
    {
     "pollMessage": {
       "name": "Poll message name",
       "selectableCount": 0,
       "values": [
         "value 1",
         "value 2"
       ]
     }
    }

Use POST API request, please go to menu "Rest API"


Go to top

Send VCard

Use Send Message menu

  1. Go to Send Message menu
  2. Select sender
  3. Input receiver (single or multi)
  4. Input Message text like below:
    {
     "contactMessage": [
       {
         "fullName": "My Full Name",
         "phoneNumber": "6281282667969",
         "organization": "My organization",
         "email": "[email protected]",
         "url": "https://arrocy.com"
       }
     ]
    }
  5. Click "Send"

Use Autoreply menu

  1. Go to Autoreply menu
  2. Add new Autoreply
  3. Put keyword "sample vcard" (or any keyword you like)
  4. Put response like below:
    {
     "contactMessage": [
       {
         "fullName": "My Full Name",
         "phoneNumber": "6281282667969",
         "organization": "My organization",
         "email": "[email protected]",
         "url": "https://arrocy.com"
       }
     ]
    }

Save as template message:

  1. Goto Templates menu
  2. Add new template
  3. Put name “sample location”
  4. Put message msgtext like below:
    {
     "contactMessage": [
       {
         "fullName": "My Full Name",
         "phoneNumber": "6281282667969",
         "organization": "My organization",
         "email": "[email protected]",
         "url": "https://arrocy.com"
       }
     ]
    }

Use GET/POST API request, please go to menu "Rest API"


Go to top

Send Location

Use Send Message menu

  1. Go to Send Message menu
  2. Select sender
  3. Input receiver (single or multi)
  4. Message text:
    {
     "locationMessage": {
         "name": "Omar Palace",
         "address": "Abu Dhabi",
         "latitude": 24.232483,
         "longitude": 55.692107
     }
    }
  5. Click "Send"

Use Autoreply menu

  1. Go to Autoreply menu
  2. Add new Autoreply
  3. Put keyword LOCATION (or any keyword you like)
  4. Put response like below:
    {
     "locationMessage": {
         "name": "Omar Palace",
         "address": "Abu Dhabi",
         "latitude": 24.232483,
         "longitude": 55.692107
     }
    }
     
  5. Click "Save" to save

Save as template message

  1. Goto Templates menu
  2. Add new template
  3. Put name “sample location”
  4. Put message msgtext like below:
    {
     "locationMessage": {
         "name": "Omar Palace",
         "address": "Abu Dhabi",
         "latitude": 24.232483,
         "longitude": 55.692107
     }
    }

Use GET/POST API request, please go to menu "Rest API"


Go to top

Spintax Campaign

  • THE GOAL IS TO MAKE MESSAGES SLIGHTLY DIFFERENT FROM ONE ANOTHER IN 1 CAMPAIGN
    Go to Send message menu and you can type multiple set of random words inside curly bracket.
    Use { } to group and use | to separate the words or phrases.

    Hi {name}, today we have a {hot sale | big promotion | weekend bazaar | extreme marketplace} event in your city.
    Please contact our {sales | support | admin} for more information
    {+964 771 934 3622 | +964 213 124 8374 | +964 449 332 0948 | +964 930 334 1033}

Go to top

Unsubscribe Campaign

  • HOW TO DO THIS FROM CUSTOMER SIDE?
    By default if a customer typed "unsubscribe" to the bot, the bot will save to database and never send bulk messages to that customer again.
    Every bot in the same user in APP_NAME will not send any bulk message to that customer, this is because APP_NAME have the multi sender feature, if only block 1 sender, other sender can still send bulk messages to that customer.
    Every bot will still be able to send message to that customer, as long sending non-bulk messages.
    *Sending with phonebook with less than 10 receivers or send messages that will finished in less than 30 seconds is NOT bulk-sending.
  • THIS FEATURE WILL HELP YOU TO REDUCE WHATSAPP BAN
    My suggestion is:
    When you send out campaign, include this message at the bottom:
    "Type 'unsubscribe' to remove yourself from our future campaign messages"
    or you can create a button with your campaign message, put "unsubscribe" on the button id.
  • WHAT HAPPEN AFTER CUSTOMER UNSUBSCRIBE?
    Customer's phone number will be saved in "subscriber" table with code "0", and every time you send campaign, it will be checked through this database. If found, send to this number will be skipped.
    Meaning, you don't have to remove the unsubscribed customer's phone from phonebook, because APP_NAME will automatically skip the message to unsubscribed customers.
  • WHAT IF CUSTOMER CHANGED HIS MIND AND WANT TO RECEIVE CAMPAIGN AGAIN?
    From customer side, just ask customer to type 'subscribe' to the bot

Go to top

OpenAI ChatGPT

  • How to get openai apikey?
    Register a new account if haven't done so.
    Then go to: Account API Keys – OpenAI API
  • Where to insert openai apikey in Arrocy Whatsapp Gateway?
  • Will the chatbot remember our previous chat?
    YES. I am proudly announce that start from this version, the chatbot can remember the chat history.
  • WARNING! The more history collected, the more token will be used. Please delete history regularly by button or by type "reset chat" to the chatbot.
  • What is OpenAI persona?
    This will be your chatbot personality/characteristics/attitude/behaviour, that you can set with your own sentence.
    ex.: Your name is Marvin. You are a grumpy chatbot. You are reluctantly answers questions with sarcastic responses.
  • How to interact with openai chatGPT bot?
    Call the chatGPT bot with the OpenAI Prefix (Bot).
    Example to chat with the bot with device on the picture above:
    "bot, what is openai chatbot?"

Go to top

Autoreply Pause

  • You, as a device owner, can pause your autoreply bot at anytime (UPDATED on v5.4.x Now user can trigger this too).
  • Example: Device owner want to interrupt customer conversation with autoreply bot, device owner open chat with a customer and type 'bot pause'.
    Customer cannot pause bot, only device owner can (UPDATED on v5.4.x Now user can trigger this too).
    After you are finished with customer, device owner can type 'bot resume' to start autoreply bot again.
  • To reset Autoreply menu and start from level 0 again, you as device owner can type 'bot reset' (UPDATED on v5.4.x Now user can trigger this too).
  • This pause-resume-reset will ONLY pause-resume-reset 1 specific customer. Other customer autoreply will still working as normal
  • This feature works with Autoreply and OpenAI chatbots
  1. Menu devices >> edit device
  2. Edit 'Autoreply_pause', 'Autoreply_resume', and 'Autoreply_reset' if you want to use your own keywords to pause, resume, and reset the chatbot.

Go to top

Check Phone Number is on Whatsapp

  • Use GET/POST API request, please go to menu "Rest API"

Go to top

Device Settings

  • THIS SETTING IS ACCESSIBLE THROUGH: DEVICES>>EDIT DEVICE
  • What is Autoread? (default NO)
    This is to enable/disable the bot behavior to mark the message status to "read" (past tense), usually indicated by 2 blue ticks.
  • What is Autoswitch? (default YES)
    This is to enable/disable the bot to change sender if the current sender is banned or OFFLINE
  • What is OpenAI prefix? (default "device>>name,")
    This is the bot name followed by "," (comma) then the question.
    Why do I need a prefix?
    This prefix will differentiate between the regular autoreply or the webhook-autoreply.
    This device is dedicated for OpenAI chatGPT, can I skip calling the bot name?
    YES you can, just choose "No Prefix" on the dropdown menu.
  • What is Autoreply group? (default NO)
    This is to enable/disable autoreply feature inside the whatsapp group.

Go to top

Warm Up Device

It is recommended to warm up your new device (Whatsapp account) to reduce the chance to get banned

  • Go to Edit Device menu
  • YES on Warming up Device
  • All devices (in 1 user account with Warmingup=YES) will automatically send messages to each other on interval that you set.

Requirements

  1. MUST be at least 2 devices with Warming Device set to (YES)
  2. Devices MUST be ONLINE
  3. Warming up will starts automatically every 5 minutes

Go to top

Multi Level Referral

    REQUIREMENTS
  • Have a regular user account
  • Free upgrade to a reseller account
  • Top up credits as a reseller
  • Edit your reseller information
  • If you see "Active: YES - Can receive commission", then you are good to go.

  • COMMISSION SCHEMATIC
  • Yo can get commission up to 5 levels below you
  • No limit on each level
  • Commission: 16, 8, 4, 2, 1 %

  • THE FLOW
  • Get as many downlines as possible to get massive amount of commission
  • As soon as your downline topup, you will get commission in to your reseller wallet
  • Minimum amount to cash-out is $20
  • Maximum cash-out per week is 1 time
  • Cash-out request will be process within 3 days

  • RULES
  • 1 person can only participate once, using 1 reseller account
    (I will review this policy in the future to see if multiple account will benefit all of us)


Go to top

Welcome Message

How to make a Welcome Autoreply Message if there is no keyword matched?
  1. Go to menu "Devices"
  2. Click "Actions" button, then Edit
  3. Input "Welcome Message" on the textbox
  4. Put "Hi {name}, Welcome to my shop. Please choose a menu provided below!"
    1. Make an appointment
    2. Pre-sales inquiry

    Main menu
    Back
  5. This Welcome Message will pause for 24 hours.

Go to top

OpenAI Image Generation

HOW TO SET?

  1. Go to menu Devices → Edit
  2. OpenAI contain: arrocy,
  3. Image contain: generate image

HOW TO USE?

  • arrocy, generate image unicorn in a field under a starry night

Go to top

Send List Message

Use Send Message menu

  1. Go to Send Message menu
  2. Select sender
  3. Input receiver (single or multi)
  4. Message text:
    {
     "listMessage": {
       "thumbnailUrl": "https://arrocy.com/assets/img/app/logo.png",
       "title": "List message title",
       "description": "Message description",
       "footerText": "Footer text",
       "buttonText": "Button text",
       "sections": [
         {
           "title": "Section 1",
           "rows": [
             {
               "title": "Row 1",
               "description": "Row description 1",
               "rowId": "rowId1"
             },
             {
               "title": "Row 2",
               "description": "Row description 2",
               "rowId": "rowId2"
             }
           ]
         },
         {
           "title": "Section 2",
           "rows": [
             {
               "title": "Row 1",
               "description": "Row description 1",
               "rowId": "rowId3"
             },
             {
               "title": "Row 2",
               "description": "Row description 2",
               "rowId": "rowId4"
             }
           ]
         }
       ]
     }
    }
  5. Click "Send"

Use Autoreply menu

  1. Go to Autoreply menu
  2. Add new Autoreply
  3. Put keyword sample list (or any keyword you like)
  4. Put response like below:
    {
     "listMessage": {
       "thumbnailUrl": "https://arrocy.com/assets/img/app/logo.png",
       "title": "List message title",
       "description": "Message description",
       "footerText": "Footer text",
       "buttonText": "Button text",
       "sections": [
         {
           "title": "Section 1",
           "rows": [
             {
               "title": "Row 1",
               "description": "Row description 1",
               "rowId": "rowId1"
             },
             {
               "title": "Row 2",
               "description": "Row description 2",
               "rowId": "rowId2"
             }
           ]
         },
         {
           "title": "Section 2",
           "rows": [
             {
               "title": "Row 1",
               "description": "Row description 1",
               "rowId": "rowId3"
             },
             {
               "title": "Row 2",
               "description": "Row description 2",
               "rowId": "rowId4"
             }
           ]
         }
       ]
     }
    }
  5. Click "Save" to save

Save as message template

  1. Go to Templates menu
  2. Add new template
  3. Put template name
  4. Put in template msgtext like below:
    {
     "listMessage": {
       "thumbnailUrl": "https://arrocy.com/assets/img/app/logo.png",
       "title": "List message title",
       "description": "Message description",
       "footerText": "Footer text",
       "buttonText": "Button text",
       "sections": [
         {
           "title": "Section 1",
           "rows": [
             {
               "title": "Row 1",
               "description": "Row description 1",
               "rowId": "rowId1"
             },
             {
               "title": "Row 2",
               "description": "Row description 2",
               "rowId": "rowId2"
             }
           ]
         },
         {
           "title": "Section 2",
           "rows": [
             {
               "title": "Row 1",
               "description": "Row description 1",
               "rowId": "rowId3"
             },
             {
               "title": "Row 2",
               "description": "Row description 2",
               "rowId": "rowId4"
             }
           ]
         }
       ]
     }
    }

Use POST API request, please go to menu "Rest API"


Go to top

Send Buttons Message

Use Send Message menu

  1. Go to Send Message menu
  2. Select sender
  3. Input receiver (single or multi)
  4. Message text:
    {
     "buttonsMessage": {
       "thumbnailUrl": "https://arrocy.com/assets/img/app/logo.png",
       "title": "Buttons Message Title",
       "description": "Description for Buttons Message",
       "footer": "Footer Text",
       "buttons": [
         {
           "type": "reply",
           "displayText": "Reply Here!",
           "id": "buttonId1"
         },
         {
           "type": "url",
           "displayText": "Visit Site!",
           "id": "buttonId2",
           "url": "https://arrocy.com"
         },
         {
           "type": "call",
           "displayText": "Call Me!",
           "id": "buttonId3",
           "phoneNumber": "14088999448"
         }
       ]
     }
    }
  5. Click "Send"

Use Autoreply menu

  1. Go to Autoreply menu
  2. Add new Autoreply
  3. Put keyword sample list (or any keyword you like)
  4. Put response like below:
    {
     "buttonsMessage": {
       "thumbnailUrl": "https://arrocy.com/assets/img/app/logo.png",
       "title": "Buttons Message Title",
       "description": "Description for Buttons Message",
       "footer": "Footer Text",
       "buttons": [
         {
           "type": "reply",
           "displayText": "Reply Here!",
           "id": "buttonId1"
         },
         {
           "type": "url",
           "displayText": "Visit Site!",
           "id": "buttonId2",
           "url": "https://arrocy.com"
         },
         {
           "type": "call",
           "displayText": "Call Me!",
           "id": "buttonId3",
           "phoneNumber": "14088999448"
         }
       ]
     }
    }
  5. Click "Save" to save

Save as message template

  1. Go to Templates menu
  2. Add new template
  3. Put template name
  4. Put in template msgtext like below:
    {
     "buttonsMessage": {
       "thumbnailUrl": "https://arrocy.com/assets/img/app/logo.png",
       "title": "Buttons Message Title",
       "description": "Description for Buttons Message",
       "footer": "Footer Text",
       "buttons": [
         {
           "type": "reply",
           "displayText": "Reply Here!",
           "id": "buttonId1"
         },
         {
           "type": "url",
           "displayText": "Visit Site!",
           "id": "buttonId2",
           "url": "https://arrocy.com"
         },
         {
           "type": "call",
           "displayText": "Call Me!",
           "id": "buttonId3",
           "phoneNumber": "14088999448"
         }
       ]
     }
    }

Use POST API request, please go to menu “Rest API”


Go to top

Typebot Chat Flow

Typebot is a tool to create an extensive autoreply chatbot using visual flow/diagram.

  1. Login or create new account on https://typebot.io
  2. Create chat flow
  3. Publish it
  4. Share. On this page you can see “Your typebot link”. Example: https://typebot.co/customer-support-18ggd91
  5. Login to https://arrocy.com, go to Devices menu then Edit device, at the bottom, you will see “Typebot” tab next to Gemini AI tab
  6. Enter “Your typebot link” in the Typebot full url box. SAVE.
     

Go to top