From de658c32b401a753320373deaf440352b82ef46f Mon Sep 17 00:00:00 2001
From: Tejas Mahajan <141305477+mahajantejas@users.noreply.github.com>
Date: Tue, 19 Nov 2024 09:43:09 +0530
Subject: [PATCH] Updating whatsappgroups onboarding (#240)
* Create WhatsApp Groups Automation Features.md
Created a separate md file listing the features and how to use them.
* Steps to be followed for Onboarding for new NGOs.md
* Create Setting up WhatsApp Groups Automation for existing NGOs.md
* Update Onboarding for new NGOs.md
* Delete docs/WhatsApp Groups Automation.md
removing the earlier documentation.
---
.../Onboarding for new NGOs.md | 60 +++++++++++++++++++
...App Groups Automation for existing NGOs.md | 48 +++++++++++++++
.../WhatsApp Groups Automation Features.md} | 54 ++---------------
3 files changed, 112 insertions(+), 50 deletions(-)
create mode 100644 docs/WhatsApp Groups Automation/Onboarding for new NGOs.md
create mode 100644 docs/WhatsApp Groups Automation/Setting up WhatsApp Groups Automation for existing NGOs.md
rename docs/{WhatsApp Groups Automation.md => WhatsApp Groups Automation/WhatsApp Groups Automation Features.md} (65%)
diff --git a/docs/WhatsApp Groups Automation/Onboarding for new NGOs.md b/docs/WhatsApp Groups Automation/Onboarding for new NGOs.md
new file mode 100644
index 000000000..2a5c6c741
--- /dev/null
+++ b/docs/WhatsApp Groups Automation/Onboarding for new NGOs.md
@@ -0,0 +1,60 @@
+### **5 minute read `Beginner`**
+
+### Contents
+1. [Pre-requisites](#pre-requisites)
+2. [Set-up](#set-up)
+8. [Pricing](#pricing)
+
+### Pre-requisites
+1. Have an active phone number with a normal WhatsApp account linked to it.
+3. Should have the WhatsApp groups created and the phone number should be part of the WhatsApp groups. (it is advised to have the WhatsApp Groups named in an appropriate manner)
+
+
+### Set-up
+#### Step 1: Linking phone number to Maytapi account
+
+
+1. Create maytapi account https://console.maytapi.com/login
+2. Log in with google id and link a phone number (follow instructions given on Maytapi page)
+3. Set up the payment option (~30$ per phone per month) in Maytapi. (For difficulties with the payments reach out directly to Maytapi team on info@maytapi.com keeping your Glific team POC in loop.)
+4. Or proceed with free trial which disables the connection in 3 days.
+5. Make a note of the "product id" and "token" given by Maytapi. This needs to be shared with the Glific team.
+
+
+
+#### Step 2: Filling the Glific onboarding form
+1. Fill the Glific [onboarding form](https://prod.glific.com/organization-registration).
+ - For "App Name" and "Gupshup API key" fill the following details respectively
+ - App name: 2023OBF1
+ - Gupshup API key: 9imaygevg6fuwa82s54hbuyoiuuohmug
+ - Follow the rest of the onboarding form documentation [here](https://glific.github.io/docs/docs/Onboarding/Onboarding%20Form%20Fill%20Up/)
+
+2. After completion of this step, Glific team will share the platform url, along with the log-in credentials.
+
+
+#### Step 3: Connecting Maytapi to Glific
+
+1. In Maytapi go to webhook and enter the following webhook url `https://api.**ngo-shortcode**.glific.com/maytapi`
+
+Ex, if your glific domain is `www.xyz.glific.com` then use the maytapi webhook url becomes `https://api.xyz.glific.com/maytapi`
+
+
+
+2. In Glific, go to setting, go to maytapi, and check if the product and token id as provided my Maytapi is added.
+3. If it is not, then add the product and token it from Maytapi and click save.
+4. This completes the set-up
+
+
+You should be able to see the whatsapp groups option in the left panel that the phone number is part of and perform operations like send, receive and schedule message to a group of groups.
+
+### Pricing
+#### MayTapi
+1. Free trial for 3 days
+2. 30$ per month per phone being linked to Maytapi
+3. Upto 3 phones can be linked per Maytapi account
+
+#### Messaging
+No separate cost for messaging needs to be paid.
+
+### Video Showcase
+
diff --git a/docs/WhatsApp Groups Automation/Setting up WhatsApp Groups Automation for existing NGOs.md b/docs/WhatsApp Groups Automation/Setting up WhatsApp Groups Automation for existing NGOs.md
new file mode 100644
index 000000000..d50208379
--- /dev/null
+++ b/docs/WhatsApp Groups Automation/Setting up WhatsApp Groups Automation for existing NGOs.md
@@ -0,0 +1,48 @@
+### **5 minute read `Beginner`**
+
+### Pre-requisites
+1. Have an active phone number with a normal WhatsApp account linked to it.
+2. Should have the WhatsApp groups created and the phone number should be part of the WhatsApp groups. (it is advised to have the WhatsApp Groups named in an appropriate manner)
+3. Go to your Glific platform and see if the "WhatsApp Groups" option is shown. If it is not visible then contact Glific team POC or go to [NGO support](https://discord.gg/YWgGxWJsMh) Discord channel and create an issue requesting for the WhatsApp Groups Automation to be enabled for your NGO account.
+
+
+
+
+### Set-up
+#### Step 1: Connecting Phone number to Maytapi
+
+1. Create Maytapi account at https://console.maytapi.com/login
+2. Log in with google id and link a phone number (follow instructions given on Maytapi page)
+3. Set up the payment option (~30$ per phone per month) in Maytapi.
+4. Or proceed with free trial which disables the connection in 3 days.
+5. Make a note of the "product id" and "token" given by Maytapi. This needs to be shared with the Glific team.
+
+
+
+#### Step 2: Connecting Maytapi to Glific
+
+1. In Maytapi go to webhook and enter the following webhook url : `https://api.**ngo-shortcode**.glific.com/maytapi`
+
+
+
+Ex, if your glific domain is `www.xyz.glific.com` then use the maytapi webhook url becomes `https://api.xyz.glific.com/maytapi`
+
+2. In Glific, go to setting, go to Maytapi, add product and token id from the Maytapi
+
+
+4. Click on save
+5. This completes the set-up
+
+You should be able to see the whatsapp groups option in the left panel that the phone number is part of and perform operations like send, receive and schedule message to a group of groups.
+
+### Pricing
+#### MayTapi
+1. Free trial for 3 days
+2. 30$ per month per phone being linked to Maytapi
+3. Upto 3 phones can be linked per Maytapi account
+
+#### Messaging
+No separate cost for messaging needs to be paid.
+
+### Video Showcase
+
diff --git a/docs/WhatsApp Groups Automation.md b/docs/WhatsApp Groups Automation/WhatsApp Groups Automation Features.md
similarity index 65%
rename from docs/WhatsApp Groups Automation.md
rename to docs/WhatsApp Groups Automation/WhatsApp Groups Automation Features.md
index f7574bf50..1bc6ab45a 100644
--- a/docs/WhatsApp Groups Automation.md
+++ b/docs/WhatsApp Groups Automation/WhatsApp Groups Automation Features.md
@@ -1,45 +1,7 @@
-> ### **5 minute read `Beginner`**
+### **5 minute read `Beginner`**
-## User Guide: WhatsApp Groups Automation
-
-### Contents
-1. [Pre-requisites](#pre-requisites)
-2. [Set-up](#set-up)
-3. [Group chats](#group-chats)
-4. [Group collections](#group-collections)
-5. [Sending messages](#sending-messages)
-6. [Sending media](#sending-media)
-7. [Scheduling messages and media](#scheduling-messages-and-media)
-8. [Pricing](#pricing)
-9. [Video Showcase](#video-showcase)
-
-### Pre-requisites
-1. Have a phone number on whatsapp
-2. Phone number to be part of the WhatsApp groups (this has to be done manually)
-3. The trial (free) account of Maytapi ( active for 3 days.) for more details
-4. Should be onboarded to Glific platform
-
-### Set-up
-Step 1: Connecting Phone number to Maytapi
-
-1. Create maytapi account https://console.maytapi.com/login
-2. Log in with google id and link a phone number (follow instructions on the page)
-3. Set up the payment option (30$ per phone per month) in Maytapi
-4. Or proceed with free trial which enables the phone to be active for 3 days)
-
-Step 2: Connecting Maytapi to Glific
-
-1. In Maytapi go to webhook and enter the following webhook url
-
-https://api.**ngo-shortcode**.glific.com/maytapi
-
-Ex, if your glific domain is www.xyz.glific.com then use the maytapi webhook url becomes https://api.xyz.glific.com/maytapi
-
-2. In Glific, go to setting, go to maytapi, add product id and token id from the Maytapi
-3. Click on save
-4. This completes the set-up
-
-You should be able to see the whatsapp groups option in the left panel that the phone number is part of and perform operations like send, receive and schedule message to a group of groups.
+## User Guide: WhatsApp Groups Automation Features: Basic
+This document provides details on using basic features of syncing all the WhatsApp Groups, sending messages and media to the groups from the Glific interface, creating collections or groups of groups to send targetted messages to a large number of groups and scheduling messages to the collections in advance.
### Group Chats
@@ -49,7 +11,7 @@ You should be able to see the whatsapp groups option in the left panel that the
### Group Collections
1. Group collection is a group of groups. A way to club together with groups. This is to enable sending or scheduling of messages to the bulk of the groups from the single action.
-#### How to create.
+#### How to create Group Collections
1. Go to Group Collection
@@ -109,14 +71,6 @@ Follow the same steps as above under the `Groups Collection` menu in the `Group
-### Pricing
-#### MayTapi
-1. Free trial for 3 days
-2. 30$ per month per phone being linked to Maytapi
-3. Upto 3 phones can be linked per Maytapi account
-
-#### Messaging
-No separate cost for messaging needs to be paid.
### Video Showcase