+
+
+
+
+
+2 . After Signup access and click on the `login` link
+
+
+
+
+6 . **CreateApp** page will open up. Click on select `Access API` button.
+
+
+
+
+7. Enter your organization name and create the app. The name of the app could be your org name or initials or any variations like organization name or abbreviation (CC, ILP, SoL, etc).
+
+
+
+8. Click on **Go To Dashboard** button.
+
+
+
+9. Click on GO LIve Button
+8 . Click on `Onboarding mechanisms` dropdown arrow. And scroll down.
+
+
+
+a) Disable Automated opt-in message.
+
+
+
+9. It will redirect to the stage 2 page. Scroll to the bottom and click on `next` button.
+
+
+
+10 . Step 3 page. Enable `template messaging.`
+
+
+
+11 . Scroll down and click on `Go To dashboard` button
+
+
+
+12 . After creating the app you will be redirected to the what app dashboard(image below). Click on the `Go live` button.
+
+
+
+13 . It will ask to select one of the options. Select `Go Live with Traditional Gupshup Flow`and then select `New Number` and then click on `confirm` button
+
+
+
+
+
+14 . It will ask to if you are ready to setup your business details. Click on `I am ready` button
+
+
+
+15 . Enter the `country` and scroll down to click on `proceed` button
+
+
+
+
+
+16. Fill in all your general details and your **email id** (on which you will receive verification email), office address, etc... (**_All the details should match your Facebook manager account_**) and then click on `next`.
+
+
+
+17. Verify your account via the verification email and click `confirm`.
+
+
+
+18. Then it will ask for your Facebook business manager id. You can get it from here. Enter your FMId and click on confirm.
+
+
+
+19. After that it will ask you to add a Facebook Business manager ID and then it will ask a new chatbot number. Enter the number and click on `save`.
+
+
+
+
+
+20. After adding the chatbot number, Gupshup mentions that they take 2-7 days to verify your Facebook manager ID.
+
+21. Go to your Facebook manager and accept the request from the request screen. (It should show on this screen below).
+
+
+
+22. Now go to your Gupshup account again and verify the mobile number via OTP or a call (image as shown in point 9).
+
+
+
+23. After verification, you will be live on Gupshup.
+
+24. To set up Glific, you’ll need to send us the following details at https://prod.glific.com/organization-registration
+
+25. App Name
+26. GupShup account phone number
+27. API key - Go to Gupshup, Click on the right corner top click on it and copy the API key and paste it in the Glific form
+
+
+
+___
+## Use media files in a flow
+
+9. Follow the steps to send the media files to contacts through a flow.
+
+- [Send media files in messages](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Send%20the%20contact%20a%20message/#send-media-files-in-a-message)
diff --git a/versioned_docs/version-1.0.0/2. Onboarding/GCS Setup/_category_.json b/versioned_docs/version-1.0.0/2. Onboarding/GCS Setup/_category_.json
new file mode 100644
index 000000000..436611c29
--- /dev/null
+++ b/versioned_docs/version-1.0.0/2. Onboarding/GCS Setup/_category_.json
@@ -0,0 +1,5 @@
+{
+ "link": {
+ "type": "generated-index"
+ }
+}
\ No newline at end of file
diff --git a/versioned_docs/version-1.0.0/2. Onboarding/_category_.json b/versioned_docs/version-1.0.0/2. Onboarding/_category_.json
new file mode 100644
index 000000000..436611c29
--- /dev/null
+++ b/versioned_docs/version-1.0.0/2. Onboarding/_category_.json
@@ -0,0 +1,5 @@
+{
+ "link": {
+ "type": "generated-index"
+ }
+}
\ No newline at end of file
diff --git a/versioned_docs/version-1.0.0/3. Pilot Essentials.md b/versioned_docs/version-1.0.0/3. Pilot Essentials.md
new file mode 100644
index 000000000..40e690d5b
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Pilot Essentials.md
@@ -0,0 +1,39 @@
+> ### **3 minute read `Beginner`**
+
+Designing chatbots is an iterative process, and with every launch or pilot, you learn new things and make changes. But if you are launching your chatbot for the first time with your users, here are 15 quick things you need to check. It shouldn't take you more than 15 minutes to ensure everything is in order.
+
+Disable the automated opt-in message on Gupshup. This will prevent your users from receiving additional default messages from Gupshup, which might confuse them. To do this, click on your app on Gupshup, go to the Opt-ins tab, click on the Onboarding mechanisms dropdown arrow, and scroll down to disable the toggle.
+
+
+
+The first message that a user receives upon joining the bot should be a consent message. Here are a few guidelines for designing your consent message:
+Clearly mention the name of the organization and the purpose of the bot.
+Clearly ask the user if they would like to receive messages from the bot (You can provide an interactive message with a "Yes" or 👍🏼 button).
+Users should have an option to opt out. Therefore, add the keyword in the footer through which users can opt out from the bot.
+
+
+
+Other pointers to remember-
+It is recommended to have the first message sent by the user to the chatbot, instead of you broadcasting the message to users, even if you have user details. Broadcasting messages might lead to user reporting or blocking the bot, which can affect the overall health of the bot. Unless you have obtained user consent outside the bot (on your app or manually), the first message should always be user-initiated.
+Create a separate flow for users who type "STOP" and add them to a collection for future reference.
+
+3) Update the Opt-in settings post-user consent. It is mandatory to update a contact's settings with Opt-in after their consent.
+
+
+4) Important user information collected during registration, such as Name, Language, Training group, City, etc., should be updated in the contact profile. This will be helpful for you to refer in any flow in future
+
+5) Confirm important information (like Name, Language, etc.) before updating the contact. Sometimes, users might enter incorrect information, which can impact the user experience throughout.
+
+For example, sharing a name as "My name is Krishna Priya" instead of just "Krishna Priya" can lead to the bot referring to the user with the incorrect name every time. Additionally, a user choosing the wrong language preference by mistake might discourage them from using the bot.
+
+6) Set default and new contact flows through Settings → Flows to ensure that new users receive the intended flow.
+7) Add content in all nodes for all languages, if multiple languages are used for the bot.
+8) Add users to relevant collections based on how you want to communicate with them in the future.
+9) Use interactive messages wherever you want the user to choose from given options or when answers are predictable (e.g., grade, Yes/No, Gender, etc.).
+10) If a flow is triggered from your end to the user, the first message of the flow should be an HSM message (because we don't know if the users are in the active session window or not).
+11) Add labels for both outgoing and incoming messages for all the data you want to capture and check in the future.
+12) Use appropriate names for Flows, Keywords, and Result names to make it easy to track them in the future.
+13) Use emoticons, bold, italics, and media as needed.
+14) Ensure the user does not encounter any dead ends in the bot, especially in the case of interactive messages. Make sure there is also an option for the user to send free text apart from the button options you provide, and clarify what the user is expected to do. Connect the user's response back to the main question and wait for their response so the flow can proceed.
+
+15) Testing, Testing, Testing: Test the chatbot internally with at least 3 to 5 people on mobile phones before sharing it with actual users.
diff --git a/versioned_docs/version-1.0.0/3. Product Features/01. Chats.md b/versioned_docs/version-1.0.0/3. Product Features/01. Chats.md
new file mode 100644
index 000000000..74059581f
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/01. Chats.md
@@ -0,0 +1,48 @@
+###**3 minute read `Beginner`**
+
+
+**Chats**: This section on the left side is highlighted, indicating that the user is currently viewing the chat interface.
+
+**Chat Window**: The central part of the interface shows an ongoing conversation with a particular contact.
+
+**Contacts**: On the right side, there is a section titled 'Contacts' listing different contacts who have been interacted.
+
+
+
+
+
+
+
+2. Enter the title of the message and click on `Save` button.
+
+
+
+
+
+3. Verify the message saved in Speed sends
+
+
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/1. Flow Overview.md b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/1. Flow Overview.md
new file mode 100644
index 000000000..121269f01
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/1. Flow Overview.md
@@ -0,0 +1,40 @@
+> ### **2 minute read `Beginner`**
+
+## Flow Listing Page
+You will be taken to the `Flow Listing Page` on clicking the `Flows` tab in the Left Panel. All the Flows created will be listed here.
+
+## Flow Listing Page Buttons
+
+1. **Configure -** The CTA buttons in `Flow Editor page` on clicking `Configure` are as follows :
+ - **Save as Draft** : This lets you save a draft of the flow you just configured. This lets you save the progress whenever you make changes to a flow before publishing it. This will be helpful for testing out the changes you make in a flow.
+
+ - **Publish** : By publishing a flow, you will be able to make a flow public. Anyone who prompts your chatbot with the correct keyword will be able to access your flow.
+
+ - **Preview** : The Preview feature displays a Flow Simulator with the Whatsapp Interface. It shows the flow from the eyes of an end user and you'll be able to understand how the various nodes look like in Whatsapp. This feature enables you to test out your flows without needing to do it from your Whatsapp app in mobile or web.
+
+ - **Revision History** : Version Control in Glific is enabled through Revision History. It creates a list of versions based on the changes you've made to a flow. If in case you end up having a faulty flow, you will always be able to go back and revert it to the last working version/ any version of your liking.
+
+ - **Reset Flow Counts** :
+
+2. **Make a copy**
+3. **Export & Import Flow**
+ - **Export flow in Configure page**
+
+4. **Edit**
+ - **Name & Keywords**
+ - **Ignore Keywords**
+ - **is active?**
+ - **is pinned?**
+ - **Run this flow in the background + Background Flows**
+
+5. **Delete**
+
+## Create Flow
+
+## Search Flow
+
+## Filter By
+ - **Title**
+ - **Last Published**
+ - **Last saved in Draft**
+ - **Active / Inactive**
\ No newline at end of file
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/2. Flow Actions/01. Flow Actions Overview.md b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/2. Flow Actions/01. Flow Actions Overview.md
new file mode 100644
index 000000000..fd60ea762
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/2. Flow Actions/01. Flow Actions Overview.md
@@ -0,0 +1,84 @@
+> ### **3 minute read `Beginner`**
+___
+
+**There are several types of actions available in Glific. You can select it from the node dropdown in the Flow Configure page to select the desired action type.**
+
+
+___
+
+1. **[Send contact a message](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Send%20the%20contact%20a%20message)** - It sends the message to the contact in the flow. You can also add variables in the content of the message to publish the value in the message. Refer [Flow level & Contact level variables](https://glific.github.io/docs/docs/Flows/Flow%20Variables/Flow%20variables%20vs%20Contact%20variables/) to know more about how to use variables in flow.
+
+
+___
+
+2 . **[Wait for contact to respond](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Wait%20for%20the%20contact%20to%20respond)** - Get an input from contact and use it in your flow. Many option available for response type. Input send by contact will be saved in the variable under `Result Name` field. For more details refer [Contact response type](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Send%20the%20contact%20an%20interactive%20message)
+
+
+___
+
+3 . **[Wait for time](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Wait%20for%20time)** - Send a message after a specified time gap. If the wait time is not selected, then it will put a gap of 5 seconds by default.
+
+
+___
+
+4 . **[Send a staff member a message](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Send%20a%20staff%20member%20a%20message)** - Send a message to staff member (other than the contact with whom current flow communication is in process) in the flow. For details refer [Send message to a staff member](https://glific.github.io/docs/docs/Flows/Flow%20Actions/Send%20message%20to%20a%20staff%20member/)
+
+
+___
+5 . **[Label the incoming message](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Label%20the%20incoming%20message)** - To label the message received in the flow. This helps you generate data point and generate analytics. Ex. if someone chooses English as their preferred language you can label their message English and then generate chart for how many people selected English.
+
+
+___
+6 . **[Add the contact to a Collection](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Add%20or%20Remove%20the%20contact%20to%20a%20collection)** - To add the contact (who is communicating in the flow) in a Collection already created.
+
+
+___
+7 . **[Remove the contact from a Collection](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Add%20or%20Remove%20the%20contact%20to%20a%20collection)** - To remove any contact from a Collection.
+
+
+___
+8 . **[Update the contact](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Update%20the%20contact) -** To save the contact details in the DB.
+
+
+___
+9 . **[Call a Webhook](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Call%20a%20webhook)** - To send or receive data to a 3rd party web application. Refer [How to use Webhooks in Glific](https://glific.github.io/docs/docs/Integrations/How%20to%20use%20Webhooks%20in%20Glific/) to know more about how to use a webhook in Glific.
+
+
+___
+10 . **[Enter another flow](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Enter%20another%20flow)** - to call another flow with in a flow.
+
+
+___
+
+11 . **[Split by custom expression](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Split%20By/Custom%20Expression)** - To take a decision in a flow based on the response submitted by contact.
+
+
+
+___
+12 . **[Split by a result in the flow](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Split%20By/Result%20in%20the%20Flow)** - To take a design in the flow based on the result of user response.
+
+
+___
+13 . **[Split by collection membership](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Split%20By/Collection%20Membership).** - This node is used to identify if the contact is a member of a particular collection. In the below example, it is checking if the contact is a member of the English collection.
+
+
+___
+14 . **[Split by contact field](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Split%20By/Contact%20Field).** - This node is used to make a decision in the flow based on the value of a contact variable.
+
+
+___
+15 . **[Wait for result](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Wait%20for%20result)** - This node is used to get results from webhook results. If there is a delay in the response from webhook, then it will wait to get the result according to the time set in `wait for result.` Earlier, the flow used to break if there was a delay in the response from the webhook. But now, it will not break and will wait for the result from the webhook. Resume flow API is used to make this feature, which will queue the request. If there is no webhook, then `wait for result` will work as `wait for time`
+
+
+___
+16 . **[Start Somebody else in the flow](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Start%20somebody%20else%20in%20a%20flow)** - This node is used to start interacting with new user or a collection in the middle of the flow.
+
+
+
+___
+
+17 . **Open Ticket** - This node is used to ask questions and assign them to the appropriate project team member. It simplifies the process of posting queries and directing them to the right person.
+
+
+
+To more about action types, you can refer to [this article](https://help.nyaruka.com/en/article/actions-3pbdyd/) published by the **Nyaruka Team**. We thank the **Nyaruka team** for publishing it for the community.
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/2. Flow Actions/02. Send the contact a message.md b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/2. Flow Actions/02. Send the contact a message.md
new file mode 100644
index 000000000..1507fc046
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/2. Flow Actions/02. Send the contact a message.md
@@ -0,0 +1,217 @@
+> ### **3 minute read `Beginner`**
+___
+
+## Send the contact a message
+
+It sends the message to the contact in the flow. You can also add variables in the content of the message to publish the value in the message.
+
+
+3. Create a Google Sheet with two headers, `Key` and `template_uuid` as shown below. Usually the `key` column will be having dates on which the individual templates need to be sent.
+ 
+4. Now let us setup the flow. The flow starts with a `Link Google Sheets` node which has the Google Sheets we created linked. This is how the node looks like :
+
+
+
+As you can see, the row input field is given an expression `@calendar.current_date` which tries to match the current date value with a `Key` value. If a match is found, then that row is chosen.
+
+5. In the next step, `Send contact a message` is used and an expression is given in place of the template selection drop-down. The expression reads `<%= Glific.Clients.ColoredCow.send_template("@results.sheet.template_uuid", ["@contact.name"]) %>`
+
+
+
+In this expression, the `template_uuid` matching the row in the given date gets send to the user. The expression also passes the value of the contact's name. You can pass multiple variables in this expression, if the template message demands it, using comma separation.
+
+In this way, you can use Google Sheets for sending template messages. With the use of [Triggers](https://glific.github.io/docs/docs/Product%20Features/Triggers/) you'll be able to schedule different template messages for specific dates using Google Sheets, enabling you to do it in a single flow, instead of creating separate flows for separate templates. This is particularly useful, when you plan to share a set of instructions/ advisory/ content in a scheduled manner in specific dates & let's you use dynamic content for the same.
+
+## Send Interactive Messages using Google Sheets
+
+Glific enables you to send interactive messages using Google Sheets. This is particularly helpful when you need the options within the interactive messages to be dynamic.
+This lets you use the same interactive message for creating multiple dynamic list of options to choose from for the beneficiary.
+
+Let's dive in a bit deeper to see how it works.
+
+1. Create a Google Sheet with the list of options you wish to have in the interactive message in a row as shown below. In this example, we want the values given in row 2 i.e `key` value as 1 to be used as the options in the interactive message we're going to create. These values could be updated in real-time to change the options inside the interactive message or you can add more rows to have different interactive messages too.
+
+
+2. Add the above created Google Sheet on the Glific. Please find the steps to do that [here](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Link%20Google%20Sheets/#add-readable-google-sheet)
+
+3. Now create a sample `Interactive Message` with a list message (can do similarly for button options too). Only the first option needs to be entered as shown below with some sample data, as it will be rewrited by the values on the sheet- hence the rest of the options could be left empty. The idea is to fetch values for the options list dynamically from the sheet.
+
+
+3. Now since we have the Google Sheets linked & the interactive message created, let's create a sapmple flow to understand how it works :
+
+
+4. As you can see, the flow starts with a Link Google Sheets node, where the readable google sheets from which the options to be fetched inside the interactive message is added. This is how the Google Sheets node is configured :
+
+
+- In the node above, the sheet we created have been linked & the corresponding action is marked as `Read` since the options for `Interactive Message` are being read from the Google Sheets.
+- Here 1 is added in `Select row` field, as the values for the interactive message are present on the row with the key value as 1 and it is stored under the variable name `sheet`
+- Instead of 1, you can also use dynamic values like [flow variables or contact variables](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Variables/Flow%20variables%20vs%20Contact%20variables), functions like @calendar.current_date etc.
+
+
+5. The next node consists of `Send contact an interactive message` node and this is how it is configured
+
+
+- The interactive message we've created is chosen from the dropdown.
+- The dynamic fields checkbox is selected which enables us to use dynamic values inside the interactive message.
+- In the input field box with `number of variables`, the number of options in the interactive message needs to be entered. Here we've given 8, since we need 8 options in the list sent (as also shown on google sheets).
+- The `id` and `variable` values need to be filled. The id could be any unique value for referencing & variable value is being fetched from the linked Google Sheet.
+- The variable names are filled as `@results.sheet.course1`, `@results.sheet.course2` and so on representing each row value from the row we've chosen to read from.
+
+6. Now since the flow is configured, let's test the flow
+
+
+As you can see on the preview above, the list of options we had given in the Google Sheets are shown as a list of options inside the Interactive Message.
+
+- Sending interactive messages using Google Sheets could avoid the redundancy of creating multiple interactive messages when the list of options needs to be updated (some option needs to be added or removed) or multiple interactive messages to be used.
+- It can also be used for handling situations where the list of options is more than 10 by using 'More' as the tenth option and having a separate list of options in the next row.
+
+## Add Writable Google Sheet
+
+### Enable Google Sheet APIs and Add Credentials
+
+1. Use [this](https://console.developers.google.com/start/api?id=sheets.googleapis.com) wizard to create or select a project in the Google Developers Console. This will automatically turn on the API. Click Continue, then Go to credentials.
+
+2. On the `Add credentials to your project` page, create a **Service account key**.
+
+3. Select your project name as the service account and choose JSON as the key format. Download the generated JSON file containing the credentials.
+
+4. Go to your Glific account, navigate to Settings, and select Google Sheet.
+
+
+
+ii) Select the collections you want to split on
+
+
+
+
+iii) The node will look like this.
+
+
+
+___
+## Sample Flow
+
+
+
+___
+## Execution Results
+Different users will randomly be sent into different flow branches and see different videos in this flow. Each image represents a different user journey as per the shared example.
+
+
+
+
+
+___
+## Additional Info
+1. Ensure that you add users who have enter/ pass through the split randomly node to a collection and use the [split by collection node](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Split%20By/Collection%20Membership) at the beginning of your flow to ensure that these users cannot re-enter the test as this will skew you data results. Refer to the sample flow image to see an illustraation of this.
+2. Read more about how to conduct A/B tests on [this blog](https://glific.org/a-b-testing-your-flows-using-the-split-randomly-node/) and read about how Antarang has used this functionality to improve their registration process [here](https://glific.org/antarang-foundation-ab-tests-their-user-registration-process-using-the-split-randomly-node/)
+___
+## Advanced Feature Webinar
+
+
\ No newline at end of file
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/2. Flow Actions/Split By/05. Collection Membership.md b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/2. Flow Actions/Split By/05. Collection Membership.md
new file mode 100644
index 000000000..d6b06809e
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/2. Flow Actions/Split By/05. Collection Membership.md
@@ -0,0 +1,46 @@
+> ### **1 minute read `Intermediate`**
+
+___
+**Split By Collection is used in flows, if there is a need to take a decision on the basis of which collection a contact belongs to.**
+
+In the below example, we are taking decision in the flow on the basis of which language use has preferred to use in Glifc.
+
+Let's say there are two languages to select for contacts (English and Hindi).
+
+1 . Create a flow
+
+2 . Ask for the language preferences.
+
+3 . Add contact to the language specific collection.
+
+4 . Do different actions on the basis of which collection a contact belongs to.
+
+i) Select `Split by Collection Membership` question type.
+
+
+
+
+
+
+
+ii) Select the collections you want to split on
+
+
+
+
+
+iii) Node will look like this.
+
+
+
+
+___
+## Sample Flow
+
+
+
+
+___
+## Execution Results
+
+
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/2. Flow Actions/_category_.json b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/2. Flow Actions/_category_.json
new file mode 100644
index 000000000..436611c29
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/2. Flow Actions/_category_.json
@@ -0,0 +1,5 @@
+{
+ "link": {
+ "type": "generated-index"
+ }
+}
\ No newline at end of file
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/01. Predefined Contact Variables in Glific.md b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/01. Predefined Contact Variables in Glific.md
new file mode 100644
index 000000000..1e15b59c2
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/01. Predefined Contact Variables in Glific.md
@@ -0,0 +1,17 @@
+> ### **1 minute read `Intermediate`**
+
+___
+
+**Below is the list of default contact variables which can be used without defining it explicitly.**
+
+## Default variables
+
+Values for below variables are by default updated when contact is created in the system.
+
+- `**name**` - Can access the value of it in flow, referencing it by `@contact.name`
+- `**phone**` - Can access the value of it in flow, referencing it by `@contact.phone`
+- `**id**` - Can access the value of it in flow, referencing it by`@contact.id`
+
+Below variable values will be updated once the user provides the response in the flow.
+
+- **language** - Can access the value of it in flow by `@contact.language`
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/02. Flow variables vs Contact variables.md b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/02. Flow variables vs Contact variables.md
new file mode 100644
index 000000000..cd2f61c7d
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/02. Flow variables vs Contact variables.md
@@ -0,0 +1,67 @@
+> ### **2 minute read `Intermediate`**
+
+___
+**There are two types of variable substitution you can use in flow editors :**
+
+1. Flow level (`@results`)
+1. Contact level (`@contact`)
+
+Going by the basic definition`@results`can be used only on a particular flow and`@contact`variables can be used in any flow. Let’s see some use cases.
+
+You may want to store the value/input received from contacts and then use it as a variable especially when sending a message/flow to a large scale of users ex. Hi `@contact.name`.
+
+These variables can be used on a flow
+
+or
+
+can be fetched and used in another workflow.
+
+- To use the variable value in the **same workflow** use _@results.field.input_ in `Results` field in `Wait for response` node or use it in `send message` node to view the value in the chat flow.
+- To use the variable value in **another workflow** use _@contact.field.fieldname_ in any other work flow in `send message` node to view the value in the that chat flow.
+
+Example use case: Suppose in the Registration workflow where you get a contact to register with your NGO, you ask for basic contact details for registration.
+
+
+
+
+
+## Registration Flow
+
+Sample workflow to get graduate students to register for advanced classes.
+
+
+
+
+
+In this example, the contact information has been captured in the below variables (note the ‘wait for response’ blocks). This will show the value of the variables entered by contact in the flow.
+
+- `@results.contact_name.input`
+- `@results.contact_email.input`
+- `@results.college_name.input`
+- `@results.college_year.input`
+
+If you want to show the category of the variable, then you can use `category` in place of `input`
+
+- `@results.contact_name.category`
+- `@results.contact_email.category`
+- `@results.college_name.category`
+- `@results.college_year.category`
+
+
+
+
+
+## Survey Flow
+
+The second workflow has been created to get the feedback of the students who have attended the classes.
+
+In this workflow, the feedback and sending the responses back to the user who has participated in the survey has been captured. The contact information which was saved in the Registration workflow can also be fetched here and used in the responses.
+
+Contact information is fetched with the below syntax for required variables,
+
+- `@contact.fields.contactname`
+- `@contact.fields.email`
+- `@contact.fields.collegename`
+- `@contact.fields.collegeyear`
+
+
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/04. List of Custom Contact Variables created in Flows.md b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/04. List of Custom Contact Variables created in Flows.md
new file mode 100644
index 000000000..b92146776
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/04. List of Custom Contact Variables created in Flows.md
@@ -0,0 +1,110 @@
+> ### **2 minute read `Beginner`**
+
+___
+
+**To know which all variables are created by you in flows, please check the **_{{@}}View contact variables_** link at the bottom of the flows screen.**
+
+## View Contact Variables
+
+1 . Login in your Glific account.
+
+2 . Click on `Flows` link from left menu list.
+
+
+
+
+
+3 . At the bottom click on `{{@}}View contact variables` **** link.
+
+
+
+
+4 . `Contact variable` page will open up with the list of variables created in your account.
+
+
+
+
+___
+## Variable Details
+
+1 . Each variable will show below details
+
+a. **Variable Name :** Shows name of the variable with complete syntax to use in flow.
+
+Ex. **_age_group_** variable is shown as **_@contact.fields.age_group_**
+
+b. **Input Name :** Shows the name by which variable is saved in the BigQuery
+
+c. **Short Name :** Shows the short name of the variable.
+
+
+___
+## Variable Actions
+
+1 . Click on `edit` icon next to Input name or short name to edit it.
+
+
+
+
+
+2 . After edit click on `green tick` icon to save it.
+
+
+
+
+
+3 . Click on `delete` icon to delete the variable form the system.
+
+
+
+
+4 . Click on `confirm` button to delete the variable.
+
+
+
+
+___
+## Search Contact Variables
+
+1 . On top right corner find the search input box.
+
+
+
+
+
+2 . Enter the **Variable Name**, **input name** or **short name** to search the contact variable.
+
+
+
+
+
+3 . Click on `search` icon to get the search result.
+
+
+
+
+___
+## Add new Contact Variable
+
+1 . Click on `Add New` button on top right corner.
+
+
+
+
+
+2 . Enter Input name and Short name of the variable.
+
+
+
+
+
+3. Click on `Save` button. You will get confirmation message.
+
+
+
+
+
+4 .Verify the new variable created in the list of variables.
+
+
+
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/05. Parent and Child variable.md b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/05. Parent and Child variable.md
new file mode 100644
index 000000000..341832783
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/05. Parent and Child variable.md
@@ -0,0 +1,74 @@
+In Glific, one flow can be linked to another flow. The main flow in this case is the parent flow and the linked on is the child flow.
+
+Variables defined in Parent flow can be accessed in child flow and vice versa.
+
+In below example, two flows are created. We will see how to access variables across flows.
+
+1. Parent
+1. Child
+
+## Access variable in child flow, which was defined in parent flow
+
+Parent flow has variable defined with name **state**
+
+1 . Create a flow (parent).
+
+
+
+
+
+2 . Define a variable. In this example the variable name is **state**
+
+
+
+
+
+3 . Call another flow (child)
+
+
+
+4 . Access variable created in parent flow.
+
+Syntax to access any variable of parent flow is _@results.parent.variablename_ like in this example the variable name is **state** . The syntax will be **_@results.parent.state.input_**
+
+
+
+
+
+## Access variable in parent flow , which was defined in child flow.
+
+
+
+1 . Define a variable in child flow. In this example the variable name is **City**
+
+
+
+
+
+2 . Access the variable in parent flow.
+
+Syntax to access any variable of child flow is _@results.child.variablename_ like in this example the variable name is **city** . The syntax will be
+
+**_@results.child.city.input_**
+
+
+
+
+
+**Your Parent and Child flows will look like this**
+
+**Parent Flow**
+
+
+
+
+
+**Child Flow**
+
+
+
+
+
+**Flow results will look like**
+
+
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/06. Create a Counter Variable in a Flow.md b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/06. Create a Counter Variable in a Flow.md
new file mode 100644
index 000000000..cbcd28e0d
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/06. Create a Counter Variable in a Flow.md
@@ -0,0 +1,29 @@
+There may be a need to keep a counter in a flow, to keep track of how many times an action is performed or for other purposes.
+
+One can create a variable (refer to [Flow variables vs Contact variables](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Variables/Flow%20variables%20vs%20Contact%20variables) document to know more about how variables are created in a flow.)and increment it with expression.
+
+1 . Initialize the variable with an update contact node.
+
+
+
+
+
+2 . Use the update contact node to create a variable and in the result section add 1 to increment the counter.
+
+In this example, a variable **counter** is created and in the result section, it is incremented by 1. ( `<%= @contact.fields.counter+ 1 %>`)
+
+
+
+
+
+The value of the variable counter can be fetched anywhere with syntax `@contact.fields.counter`
+
+Split By expression node to check how many times the counter has been incremented.
+
+
+
+Then in the flow, you can use it anywhere where you want to repeat things. One of the common use cases is when you nudge the users in case of no response.
+
+
+
+
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/_category_.json b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/_category_.json
new file mode 100644
index 000000000..436611c29
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/3. Flow Variables/_category_.json
@@ -0,0 +1,5 @@
+{
+ "link": {
+ "type": "generated-index"
+ }
+}
\ No newline at end of file
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/01. Flows not working - Troubleshoot checklist.md b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/01. Flows not working - Troubleshoot checklist.md
new file mode 100644
index 000000000..6a0a8477c
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/01. Flows not working - Troubleshoot checklist.md
@@ -0,0 +1,81 @@
+> ### **2 minutes read `Intermediate`**
+
+---
+
+1. **Is the flow published?** If the desired result not showing while executing the flow. Make sure you have published the flow after modifying it.
+1. **Check messages in all language**. If you are getting messages which you are not expecting. Please check if different messages are saved in other languages and check which language preference is user is having which you are using for testing the flow.
+1. **Variable not defined properly.** If variables are not defined properly the flow will not give expected results. Refer [Flow level variable Vs Contact level variable](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Variables/Flow%20variables%20vs%20Contact%20variables/) for details about how to use variables in flows.
+1. **Linked flow is not published.** The flow will not execute if any other flow is called from a flow and the other flow is not published.
+1. **Web hook errors.** The flow will not give desired results if there is any error in the web hook call. Refer [How to check Webhook Logs in Glific?](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Call%20a%20webhook/#checking-webhook-logs) to know more about web hook logs.
+1. **Flow should start with a Send a Message** - Flow should start with a message, so that it gives related message. Starting a flow with `Wait for response` action type will confuse if the flow has started or not.
+1. **Ignore Keyword is checked or not? -** Check if `Ignore Keyword` is checked for the flow, which is currently executing for the contact. If Ignore Keyword is checked, then it will not allow to start another flow, if contact type any other keyword.
+1. **Flow should be active** - Check if flow is inactive. Click on isActive check box and save to activate the flow.
+
+
+
+1. **Node** **placement**- There should be only single first node at the top in flow editor. All other node should be below that.
+
+**Correct** **placement**
+
+
+
+**Incorrect placement**
+
+
+
+10 . **Ignore keywords** - Check if contact is already in a flow, which has `ignore keywords`implemented. If contact tries to strat flow with the keyword, in this case, it will not start the flow.
+
+11 . **OptedOut** - check if a contact is not opted out. An easy test is to ask the contact to type optin and send it to the BOT (**Note, Your optin flow should always have optin keyword set to it**). See if it starts working.
+
+Also, make sure, that the default optin message from the Gupshup portal is disabled.
+
+
+
+##
+
+
+
+12 . **Session Window -** Check if contacts are in the session window, to start a flow with them, if not make sure the flow is started with HSM (with an expected response). The same is true if the flow is started for a collection.
+
+---
+
+## 4. Errors while creating Flow
+
+
+
+1. `Could not find Sub Flow: Help Workflow` - The subflow was created and exists no more.
+
+2. `The next message after a long wait for time should be an HSM template` - After `Wait for time`, it should be an HSM message. The same error will be shown when you tick `Continue when there is no response` checkbox and the delay set is 1 day or more.
+
+3. `Could not find Contact: SaaS Admin`- When staff member added to Send Broadcast node is deleted but in the node it is not updated
+
+4. `Could not find Sub Flow: Out of Office Workflow` - The subflow was created and no more exists.
+
+5. `Could not find Group: Default Group` - When collection added to Add to Collection node is deleted but in the node it not updated
+
+6. `Could not find Contact: NGO Staff` - The user created in the platform is deleted and no more exist in the platform
+
+7. `Could not parse Group` - This looks similar to when collection added to Add to Collectionnode is deleted but in the node it is not updated.
+
+8. `Your flow has dangling nodes` - There are some nodes that are not connected to any other node in the flow.
+
+9. `Missing translations` - This error appears when translations are not added to all nodes (where at least one node has it). It's crucial to fix this to avoid confusing multilingual messages, and the message points out which node lacks translation.
+
+
+
+10. `Node Error Warning` - This error shows up if the node following an Interactive message isn't a `Wait for response`. The flow won't move forward for users without allowing them to respond after an Interactive message. Even though Glific automatically adds a `Wait for response` node after the Interactive message, manual removal of this can trigger the error.
+
+
+
+11. `Trigger warning` - This warning arises if the flow's first node is a 'Send message' without an HSM template. Without this, messages to users not in the 24-hour session window might fail. Therefore, the first message in a flow should be an HSM message.
+
+
+
+12. `Media Template warning` - This warning indicates selecting a media attachment in an HSM template message but failing to attach an Image URL in the flow.
+
+
+---
+
+## Logs to know if any errors are thrown while executing the flow
+
+Refer [Notifications for system errors](https://glific.github.io/docs/docs/Product%20Features/Notifications#notifications-for-system-errors)
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/02. How to identify which keyword triggered the flow.md b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/02. How to identify which keyword triggered the flow.md
new file mode 100644
index 000000000..fe9d2718f
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/02. How to identify which keyword triggered the flow.md
@@ -0,0 +1,24 @@
+> ### **2 minutes read `Beginner`**
+
+___
+**There may be a situation, where you want to identify which keyword started a flow or wanted to capture the keyword/sentence contact has sent to start a flow.**
+
+
+You can use `flow_keyword` variables to get the information in the flow.
+
+The syntax will be `@results.flow_keyword.input`
+
+or you can use a `category` to get the whole sentence which contact has entered to start a flow.
+
+The syntax will be `@results.flow_keyword.category`
+
+For Example: Let's say you have a flow with multiple keywords like **key1, key2, key3** etc and you want to know what keyword actually triggred the flow.
+
+
+
+
+
+
+
+
+Note: If a staff member (User) initiates the flow for a contact from the dashboard, then @results.flow_keyword.category will either be null or return @results.flow_keyword.category as value.
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/11. Configure Optin & Optout preferences in Glific.md b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/11. Configure Optin & Optout preferences in Glific.md
new file mode 100644
index 000000000..d132204b4
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/11. Configure Optin & Optout preferences in Glific.md
@@ -0,0 +1,74 @@
+# Opt-in & Opt-out Flows
+
+> ### **2 minutes read `Intermediate`**
+
+
+**When any new beneficiary sends a message for the very first time, the beneficiary can get an Optin message to give their consent to receive the messages from the BOT. Likewise, the beneficiary also has the freedom to Optout from receiving anymore messages from a Whatsapp Chatbot.**
+
+___
+## Video Tutorial
+
+
+
+
+
+In Glific NGOs can configure the `optin` and `optout` process in flows.
+
+Glific uses `settings` variable to update the beneficiary's profile details in the system.
+
+___
+## Configure Opt-in and Opt-out in Flows
+
+1 . Create new flow or use the existing flow in the system with name optin and optout.
+
+2 . Craft a message to let the user respond to their optin preference.
+
+
+
+
+
+3 . Get the response form the user.
+
+
+
+
+___
+## Opt-in preferences update
+
+4 . On confirmation update the opt-in preferences for the beneficiary.
+
+
+
+___
+## Opt-out preferences update
+
+5 . Create a flow for opt-out or use the existing flow in the system. Keywords for Optout flow could be **optout**, **stop.** _(You can recommend us if you have better suggestions for the keywords)_
+
+6 . When beneficiary sends **optout** or **stop** keyword to BOT, Opt-out preferences will be set for the beneficiary.
+
+7 . Yon need use **optout** value to update the `settings` variable .
+
+
+
+
+
+**Note** - Make sure to use optin as keyword of this flow. optin is a special keyword which will execute the flow to get contact's optin even if they are optedout
+
+
+
+
+___
+## Sample Opt-in Flow
+
+
+
+
+___
+## Reference Article
+
+- [Get Opt-in for WhatsApp](https://developers.facebook.com/docs/whatsapp/overview/getting-opt-in/)
+
+___
+## Tags
+- Optin
+- Optout
\ No newline at end of file
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/13. Background Flows.md b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/13. Background Flows.md
new file mode 100644
index 000000000..794f4dc43
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/13. Background Flows.md
@@ -0,0 +1,41 @@
+> ### **2 minutes read `Beginner`**
+
+___
+**There may be a requirement to send automated messages other than the regular flows they're accessing or manual interaction happening with them. Such as when you want to keep sending weekly/bi-monthly activities but also have the interact with the bot on a daily basis. For this, you can plan your activities as a background flow while other flows remain as it is.**
+
+So, you can create that flow and mark it as `Run this flow in the background`
+
+Note: Background flow cannot have `wait for response` node, as this flow will execute in the background and may conflict with other flows hence, you shouldn't expect any response from user for those.
+
+If you need a flow with user responses, then create a normal flow and uncheck `Run this flow in the background`
+
+
+
+## **Create Background flow**
+
+1 . Create a flow.
+
+
+
+2 . Configure it with messages the way you want.
+
+
+
+3 . Save it.
+
+4 . Go to the edit screen for that flow.
+
+
+
+
+5 . Mark the check box `Run this flow in the background`
+
+
+
+6 . Save it.
+
+### **Background flows can be used :**
+
+- to share some messages to number of contacts from collection.
+- to share any information periodically with beneficiaries combined with triggers.
+- to update specific states of beneficiaries in the system. (Ex. Update district of all beneficiaries who are in one collection.)
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/18. Create a flow to capture multiple answers for a single question.md b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/18. Create a flow to capture multiple answers for a single question.md
new file mode 100644
index 000000000..3736db453
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/18. Create a flow to capture multiple answers for a single question.md
@@ -0,0 +1,45 @@
+While creating a program you might have a requirement to capture multiple answers for a single question. This requirement doesn't work with interactive messages but you can still use regular text to accomplish this.
+
+
+
+For multiple answers, it's always better to add a note and an input example that will help users to know how to answer in the correct way. For example,
+
+
+
+
+
+And the Wait For Response can be something like this
+
+
+
+
+
+Your message flow will look something like this
+
+
+
+
+
+
+
+## For Conditional Flow
+
+
+
+If you want to create a conditional flow with multiple answers, you can create your program like this.
+
+
+
+
+
+
+
+You can set the Wait For Response like this,
+
+
+
+
+
+Your message flow will look like this
+
+
diff --git a/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/Flows Auto translate.md b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/Flows Auto translate.md
new file mode 100644
index 000000000..d203c92b6
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/03. Flows/4. Others/Flows Auto translate.md
@@ -0,0 +1,67 @@
+> ### **2 minutes read `Intermediate`**
+
+---
+
+**Allows Glific to auto translate content in the default language of flow editor, and have the translations populated in in the other languages enabled in the Glific instance.**
+
+_The feature is in beta version and can be enabled/ disabled for any given organization’s Glific instance upon request in the [discord](https://discord.gg/CAUgdQsZAd) channel or via writing to spoc from the Glific team._
+
+**Overview**
+
+1. Create flow in default language
+2. Have translations auto populated for all the languages selected in your Glific instance
+3. Have the flow exported as CSV (with or without translations) to be proofread and corrected by language experts
+4. Import translations as CSV
+5. The process (automatic translations -> export translations -> import translations) chain can be used as a whole or in parts depending on your needs
+
+**How it works**
+
+1. Find `Translation` button is in the flow editor
+
+
+
+
+
+
+
+5 . Fill in the rest of the details to verify.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+---
+
+**_Note:_** _If you have never used Data Studio before then you will be prompted to provide some basic information and agree to their terms and conditins. Do so and then repeat step 2._
+
+---
+
+3 . Click on `Copy Report`. Refer to the image below:
+
+
+
+---
+
+**_Note:_** _Do not click on any of the drop downs for **New Data Source**. Directly click on_ 'Copy Report'
+
+---
+
+## Connect data sources to your BigQuery Account
+
+---
+
+4 . A new tab will open with the copy of the report and some visuals not functioning, select `Manage added data sources`from the Resources Menu. Refer to the image below:
+
+
+
+---
+
+### Connect `contacts`, `messages`, and `message conversations` through 'My Projects'
+
+---
+
+5 . Click on `edit` one by one for each data source. Start with **contacts**
+
+
+
+6 . Connect to the BigQuery data source:
+
+a. Select `MY PROJECTS` from the menu on the far left.
+
+b. Select the `Project` (_If the project is not listed you might need to enter the_ **_Dataset ID_** _manually_. _Refer to the note after step 8_)
+
+c. Select the `Dataset`, this is your WA bot number
+
+d. Select the `Table` with the matching name. Click on the blue `Reconnect` button at the top right corner.
+
+
+
+e . You might get a warning "`Configuration has changed. Do you want to apply the changes?`”. That’s okay, click on `APPLY`
+
+
+
+f . The fields listing page will open up. Verify that the fields are set to the correct type. Most will be correct by default.
+
+**What to check for:**
+
+1. All fields with 'id' in their name should be of the type 'text'
+2. 'phone' should be of the type 'text'
+3. 'language' should be of the type 'text'
+4. All fields with 'at'/'time' in their name should be of the type 'Date and Time'
+5. Latitude/Longitude should be of the type latitude, longitude.
+
+g. Click on `DONE` in fields listing page
+
+
+
+7 . **_Repeat steps 5 and 6 for the following data sources; Messages, Message Conversations_**
+
+---
+
+**_Note: To get the Dataset ID click on the phone number on BigQuery._**
+
+
+
+---
+
+### Connect `flat fields`, `monthly active users`, `Contact collections`, `success messages` and `flow context` by replacing your Dataset ID into the preset 'Custom Query'.
+
+---
+
+8 . For the Flat Fields data source, select Edit and then update the custom query with **Dataset ID** (from the Glific settings interface for big query as shown in the note above). Replace `tides-saas-309509.917302307943` with your **Dataset ID** (Refer to the image below)
+
+**Note:** Ensure that you only replace the **Dataset ID**, that is, ".contacts" should not be deleted. This applies for all steps where you replace the **Dataset ID**, ensure you do not select and paste over the remaining text.
+
+---
+
+
+
+9 . Click on `Reconnect` to update.
+
+
+
+10 . Verify the field types. (Refer Step 6.f.) And then click `Done`
+
+11 . Follow steps 8 to 10 as above for; `Monthly active users`, `Contact Collections` and `Success Messages`, Replace the **Dataset ID** as per your setup.
+
+12 . For Flow context data source update the custom query with **Dataset ID** (from the Glific settings interface for big query). There will be four places where you need to update the **Dataset ID**
+
+
+
+---
+
+### Connect `flow Results` and `Contact Collection` by running a query in BigQuery before connecting the data sources.
+
+---
+
+13 . For Flow results. First go to your BigQuery account. Open a new tab and run below query. Replace `tides-saas-309509.917302307943` with your **Dataset ID**
+
+
+
+```
+CREATE OR REPLACE FUNCTION `tides-saas-309509.917302307943.jsonObjectKeys`(input STRING) RETURNS ARRAY
+
+18 . Go back to DataStudio and follow the same steps as we did for `contacts` (6 and 7) above to connect the `Contact Collection` data source.
+
+19 . Click `CLOSE` on the top right, and your reports will be ready
+
+
+
+20 . Your reports are ready for use.
+
+---
+
+**_Note: To create your own custom reports follow the steps in the below document ._**
+
+[https://support.google.com/datastudio/answer/6292570?hl=en](https://support.google.com/datastudio/answer/6292570?hl=en)
+
+---
diff --git a/versioned_docs/version-1.0.0/3. Product Features/09. Reporting & Dashboard/03. Capturing Data for Reports & Analytics.md b/versioned_docs/version-1.0.0/3. Product Features/09. Reporting & Dashboard/03. Capturing Data for Reports & Analytics.md
new file mode 100644
index 000000000..b80c685e6
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/09. Reporting & Dashboard/03. Capturing Data for Reports & Analytics.md
@@ -0,0 +1,78 @@
+> ### **2 minute read `Intermediate`**
+
+**While communicating with contacts, data points can be collected and saved. Once done, customised reports can be created from the saved data.**
+
+## Prerequisites
+
+- [Data Studio Integration for Visualizations & Reports](https://glific.github.io/docs/docs/Product%20Features/Reporting%20&%20Dashboard/DataStudio%20Integration%20for%20Visualizations%20&%20Reports)
+
+**Below is a step by step process to capture the data first.**
+
+1. Gather the data points from flows.
+1. Save the data with the “Update Contact” function.
+1. Check the data field value in BigQuery.
+1. Generate chart reports in DataStudio.
+
+
+
+Detailed steps to generate the reports.
+
+1. Use `Wait for response` function in flows to gather the data points. Example: capture name of the contact using _contact_name_ field.
+
+
+
+1. Save the data with the `Update Contact` node. Use this variable format for the data point _@results.fieldname.input_ where the fieldname part can change as per your data point. For simplicity, make field name same as Result Name from the above image.
+
+
+
+
+
+
+
+4. Access the field values using variables such as _@contact.fields.fieldname_
+
+
+
+5. Access BigQuery from [https://console.cloud.google.com/](https://console.cloud.google.com/)
+
+
+
+
+
+
+
+6. Select your `project` from the dropdown.
+
+
+
+
+
+7 . From the left menu, click on **triangle** next to your project name . Then click on the **triangle** next to your BOT number **** and click on the `Contacts` label.
+
+
+
+
+
+8 . Click on the `Preview` sub-label to view the data in tabular format.
+
+
+
+
+
+9 . Verify the data in your Big Query
+
+
+
+
+
+10 . From the `Export` dropdown on the right, click on `Explore with Data Studio` option.
+
+
+
+
+
+11 . Google Studio ( [https://datastudio.google.com/](https://datastudio.google.com/) ) will open up in another tab.
+
+
+
+12 . Follow the steps in the below document to create reports.
diff --git a/versioned_docs/version-1.0.0/3. Product Features/09. Reporting & Dashboard/04. Making Custom Reports on DataStudio.md b/versioned_docs/version-1.0.0/3. Product Features/09. Reporting & Dashboard/04. Making Custom Reports on DataStudio.md
new file mode 100644
index 000000000..23e73d71c
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/09. Reporting & Dashboard/04. Making Custom Reports on DataStudio.md
@@ -0,0 +1,255 @@
+> ### **10 minute read `Intermediate`**
+
+
+
+## Prerequisites
+- [Capturing data for reports & analytics](https://glific.github.io/docs/docs/Product%20Features/Reporting%20&%20Dashboard/Capturing%20Data%20for%20Reports%20&%20Analytics)
+- [Data Studio Integration](https://glific.github.io/docs/docs/Product%20Features/Reporting%20&%20Dashboard/DataStudio%20Integration%20for%20Visualizations%20&%20Reports)
+
+## Video Tutorial
+
+
+
+## Overview
+
+This document is meant to guide organisations to build custom dashboards either entirely from scratch or build on top of the existing reports provided by Glific.
+
+In order to keep things simple, all steps that will be described below will be in reference to the existing reports but they can be extended to build reports or dashboards from scratch as well.
+
+The existing reports are built keeping in mind some of the general monitoring and evaluation metrics that organisations would like to keep a track of either on a weekly or daily basis.
+
+These reports include information on daily activity status, engagement metrics, frequency of interactions and user information all within different pages of the reports.
+
+The reports can be used as is or customised to the organisation’s liking by adding more data sources, blending different data views/tables together in existing or new pages of the report.
+
+
+## What's being reported in the current reports?
+
+In the current version of the report (v3.0) you will find the following pages -
+
+**Daily Status :** Gives an overall view of the total number of active contacts and messages sent by the users each day. It also gives a breakdown of the number of active contacts and messages by hour in order to evaluate time-based factors that might be impacting engagement
+
+**Flow Reports :** This page gives a breakdown of the user engagement per flow. The charts included within this report give an overview of the number of times a user has requested a particular activity or flow or provided feedback on an activity.
+
+**Sessions :** The sessions page gives total and average number of sessions (flows) initiated by the user. It also gives a breakdown of the frequency of interactions per user, average time spent on flow per user and the average number of messages sent by the user for each flow.
+
+**Contact Details :** All contact details collected by the organisation can be visualised in this view of the report.
+
+**Field Views (User Details) :** Additional page to visualise contact details that makes use of a stored procedure in Bigquery meant to unnest all the fields level information that the organisation is collecting in their flows and mapping them back to the contact details [Capturing data for reports & analytics](https://glific.github.io/docs/docs/Product%20Features/Reporting%20&%20Dashboard/Capturing%20Data%20for%20Reports%20&%20Analytics)
+
+All the reports above can be filtered as per date, time, flow name, flow label (activity/feedback etc.) and contact details.
+
+# Getting Started :
+
+## Adding template to new report page
+
+Once you have made a copy of the existing reports and made connections to your data sources by following the steps in this document [Integrate DataStudio to create Visualisations & Reports](https://glific.github.io/docs/docs/Product%20Features/Reporting%20&%20Dashboard/DataStudio%20Integration%20for%20Visualizations%20&%20Reports), you are now all set to customise existing pages or add new pages.
+
+In order to add a new page,
+
+1. Navigate to `Pages` on the header
+1. Click on `New Page` (you can even duplicate an earlier page by clicking on `Duplicate Page` and customise it as per your requirements)
+
+
+
+1. `Rename` the report by clicking on the Page (Number) from the header panel and selecting the 3 dots beside the current report name
+
+
+
+An empty page will be created without the source template. In order to add the source template -
+
+1. Multi-select all the rectangles, texts and filters from the template that you would like to be copied from a previous page
+1. Right click on the selection and click the `Make report-level`
+
+
+
+
+
+You are now ready to add data sources and charts to your new report page.
+
+## Connecting to new data sources from report page
+
+Every report page has a pre-selected data source which can be changed. If you want to select a source from already connected data sources or if you want to include a new custom query or data source from your BigQuery Console -
+
+1. Click on `Add Data` option available on the header panel
+
+
+
+1. Select the `Bigquery` connector
+
+
+
+1. Select the **project** that contains your datasets
+1. Select the **Glific dataset**
+1. Choose from the list of available data sources
+
+
+
+Or you could also -
+
+1. Add a dummy chart and then click on `Edit Data Source` (pen icon) in the `Data Source` section of the right data pane
+1. Select the data source from the list of connected data sources after the BigQuery connector automatically opens to your project
+
+
+
+
+
+## Working with fields, metrics, dimensions and filters
+
+When working with charts, the right data pane gives you options to change **dimension**, **metrics**, **define custom fields** and **add filters** to organise data in a certain way. Here is a complete breakdown of all the available options -
+
+**Fields :** Fields are the columns that appear in your connected dataset
+
+**Date Range Dimension :** As the name suggests, this option lets you specify the `datetime` field within your dataset and can be used to plot time-series charts and graphs. Specifying the date dimension also lets the user further filter as per month, week, day, hour and so on
+
+**Dimension :** Dimensions describe or categorize your data. Adding dimensions to a chart groups the data by those dimensions. Time, flow name, city, student’s age are all examples of dimensions you could use to group the information in your chart. Note that any type of data can be a dimension, including a column of unaggregated numbers
+
+**Metrics :** Metrics measure your dimensions. A metric is the result of applying an aggregation to a set of values. That aggregation could come from the underlying data set, or be the result of implicitly or explicitly applying an aggregation function, such as **COUNT()**, **SUM()**, or **AVG()**
+
+**Note about Dimensions and metrics in your data source :** When you connect to your data in Data Studio, you'll see the list of fields along with their default properties, as shown below. **Dimensions** (unaggregated columns that you can group by) appear as green fields. **Metrics** (aggregated data) appear as blue fields
+
+**Parameters :** Parameters store user-defined data. Unlike dimensions and metrics, which get their information from the underlying data set, parameters get their information from users. Parameters can then be used to customise or personalised your reports and data sources
+
+**Calculated Fields :** Calculated fields let you create new fields derived from your data. Calculated fields appear in the field list with `fx` at the end
+
+**Filters :** There are two types of filters that can be added to the report, one at a page level, also called as a control and the other at a chart level which is available as an option in the right data panel after a chart is added. Both filters work essentially the same way and can be used to visualise only a portion of the data
+
+## Creating calculated fields
+
+In order to create a calculated field -
+
+1. Click on either dimension or metrics in the right data pane and select `Create Field` at the very bottom of the drop-down list
+
+
+
+1. In the formula text box, specify the condition using which you want the new field to be created. The formula takes in all SQL functions. Some examples in which this could be used include **HOUR(inserted_at)** to extract only the HOUR information from the datetime column or doing a CASE WHEN to specify “Male” or “Female” instead of a “1” or “2” from the original data source.
+
+
+
+1. Provide the calculated field with a name and data type and then select the `Apply` button.
+
+##
+
+## Creating Filters
+
+**Creating page-level filters :**
+
+1. Select on `Add a control` option from the top header panel
+
+
+
+1. Select the type of filter you want to add from the page. The available filters include options like sliders to filter numeric data types, checkboxes to select only boolean values or drop down list to filter as per dimensions available in a specific column of the dataset.
+
+
+
+1. Adjust the shape and position of the filter within your report
+1. Select the column using which the data needs to be filtered from the `Control Field` option available in the right data pane.
+
+
+
+1. Make adjustments to the **metric**, **order**, **range** etc. as necessary based on the type of filter selected
+
+
+
+**Creating chart-level filters**
+
+1. After adding a chart, scroll to the `Filter` section of the right data pane.
+
+
+
+1. Click on `Add a filter`
+1. Filters are usually of two types - **Include** or **Exclude**. Select whether you want to include or exclude certain dimensions or types of values (NULLs) from your data
+
+
+
+1. Select the field which has the dimension or value that needs to be filtered
+1. Select a filtering condition. This can include filtering based on partial or full matching with the column value or filtering null values or values that start with a certain value.
+
+
+
+1. Type in the keywords for which the filtering condition needs to be applied
+
+## Working with grouped data
+
+In certain cases, you might be interested in working with averages such as per user per flow average times or with grouped data such as combining contacts and messages tables together and grouping them to visualise the number of messages sent by users.
+
+These manipulations are not directly available in the backend tables and might get a little tricky to work with if you are building custom fields since Data Studio does not support group by functions in the formula box for calculated fields.
+
+In such cases, it is advisable to either select the table visualisations where you can add multiple grouped dimensions and visualise the number of records for such groupings. For example, if you wish to get the number of flows requested by a user per day, you could -
+
+1. Select the **Table with Bars** chart from the `Add A Chart` option in the top header panel
+
+
+
+1. Add dimensions for `Date` and `Phone` in the right data pane to create the groupings
+
+
+
+1. Select the `flow_label` metric and choose the **SUM** aggregation to get the total number of activities requested per user per day
+
+## Creating Views
+
+The other way to deal with averages or with grouped data is to create **views** from backend tables and add them as data sources within your reports. You can create views directly from Data Studio in the following way
+
+1. Click on `Add A Data` option in the top header panel
+1. Select the `Bigquery` connector
+1. Click on the `Custom Query` option and then select your **project** and **dataset name**
+1. Type or paste your view query in the `Enter Custom Query` text box
+1. Select `Add` after you are done
+
+The views currently in use include Flat Fields available in your Bigquery Console along with UserSessions and ContactMessages available within Datastudio (Click on `Resource` > `Manage added data sources` in your Datastudio report to view them)
+
+## Managing views/queries - changing names and data types
+
+The default name given to a query or a view when it's created is **Bigquery**. You might want to give this particular view/query a name in order to manage it across multiple pages of the report.
+
+You can also make data type changes after you have created the view/query if you haven't already done so while creating it. In order to make name or data type changes -
+
+1. Select the `Resource` option from the header panel of Datastudio
+1. Select the `Manage Added Data Sources`option
+
+
+
+1. Navigate to the data source that has the name “Bigquery” and click on the `Edit` option beside it
+
+
+
+1. Double click on the current view/query name at the top of the `edit` box and change the name
+
+
+
+1. In order to change the data type, navigate to the field to be changed and select the data type from the drop-down list from either **Number**, **Text**, **Geolocation**, **Boolean** etc
+
+
+
+1. Click on the `Done` button in the top right corner of the editing box after you have made all the changes
+
+## Styling the graphs
+
+After you are done adding data sources, creating new views, adding graphs etc. it is time to style them as per your report.
+
+Each graph has its own styling criteria. A **bar graph** may have an option to change the orientation, i.e, vertical or horizontal orientation whereas a **pie chart** gives you an option to select the number of total slices (if the data was numeric).
+
+The styling depends on your use-case and there is no hard and fast rule as to how you would like to present the data.
+
+You may however want to adjust the colors of the graphs/charts based on the template colors you are using. This can be done through the `Color` and `Background and Border` sections within the `Styling` tab.
+
+
+
+
+
+You can also **add** **labels** to the chart and adjust the **font size** and color of the labels. The other thing you might want to try is making text/orientation changes to the legend of the graph. The changes are automatically saved.
+
+Once you are done styling the pages and the graphs, you have your organisation level reports ready to be viewed or shared.
+
+
+
+## Reference Article
+
+- [Configure Dimensions and Metrics](https://support.google.com/datastudio/answer/6402048?hl=en)
+
+- [About Calculated Fields](https://support.google.com/datastudio/answer/6299685?hl=en)
+
+- [Working with Filters](https://support.google.com/datastudio/answer/6291066?hl=en)
+
+- [Configure Chart Components](https://support.google.com/datastudio/answer/6291062?hl=en)
diff --git a/versioned_docs/version-1.0.0/3. Product Features/09. Reporting & Dashboard/05. Populate Data in Field Views- User Info Report.md b/versioned_docs/version-1.0.0/3. Product Features/09. Reporting & Dashboard/05. Populate Data in Field Views- User Info Report.md
new file mode 100644
index 000000000..8d7a1c14d
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/09. Reporting & Dashboard/05. Populate Data in Field Views- User Info Report.md
@@ -0,0 +1,102 @@
+> ### **2 minute read `Intermediate`**
+
+**Flat fields table contain contact specific data based on the data points an Organisation has defined in their system. Organisation needs to have enough contact fields information available to visualise this report.**
+
+## Prerequisites
+- [Data Studio Integration for Visualizations & Reports](https://glific.github.io/docs/docs/Product%20Features/Reporting%20&%20Dashboard/DataStudio%20Integration%20for%20Visualizations%20&%20Reports)
+
+## How to verify if you have enough contact fields information available.
+
+1 . Go to Big query and execute the below queries to check if there is enough data in contacts and messages tables.
+
+
+
+**_Note - beginner-290513.917777711114 needs to be changed with your product ID_**
+
+_SELECT * FROM `beginner-290513.917777711114.contacts`LIMIT 1000_
+
+_SELECT * FROM `beginner-290513.917777711114.messages` LIMIT 1000_
+
+
+
+
+
+2 . Get the data in your reports for Contacts and Messages tables. Follow the steps from 1 to 6 in [Integrate DataStudio to create visualisations & reports](https://glific.github.io/docs/docs/Product%20Features/Reporting%20&%20Dashboard/DataStudio%20Integration%20for%20Visualizations%20&%20Reports) to get the data for Contacts and Messages tables.
+
+## Steps to configure your Field Views (User info) report.
+
+1 . Select `Field View (User Info)` report from the dropdown.
+
+
+
+
+
+2 . You may see error in the report chart section.
+
+
+
+
+
+3 . Click on `Resources >> Manage added data source`
+
+
+
+
+
+4 . Click on `Edit` on `Flat fields` section.
+
+
+
+5 . Click on `Edit connections`
+
+
+
+6 . Click on `My Projects`. Click your `project` . Click on your `data set`. Then click on `flat_fields` table.
+
+
+
+7 . It will open up Big Query. select `flat_field` table from the list of tables.
+
+
+
+
+
+8 . Click on `Invoke store procedure`
+
+
+
+9 . Click on `Run` button
+
+
+
+10 . Click on Reconnect
+
+
+
+11 . Click on Done
+
+
+
+12 . Now data will be updated in Flat_fields.
+
+
+
+## Plot the data in the charts
+
+1 . Click on the chat where you want to plot the data from Flat fields.
+
+2 . Click on `Data` link in right pane.
+
+3 . Notice under `Dimension` section it says Invalid dimension
+
+
+
+4 . Drag the data field from the Available fields section to the dimension section.
+
+
+
+
+
+5 . And you will be able to see the data in the charts.
+
+
diff --git a/versioned_docs/version-1.0.0/3. Product Features/09. Reporting & Dashboard/06. Understanding V5 Data Studio Reports.md b/versioned_docs/version-1.0.0/3. Product Features/09. Reporting & Dashboard/06. Understanding V5 Data Studio Reports.md
new file mode 100644
index 000000000..5db472191
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/09. Reporting & Dashboard/06. Understanding V5 Data Studio Reports.md
@@ -0,0 +1,238 @@
+> ### **10 minute read `Beginner`**
+
+___
+## Prerequisites
+
+- [GCS Setup](https://glific.github.io/docs/docs/Onboarding/GCS%20Setup/Google%20Cloud%20Storage%20Setup)
+- [BigQuery Setup](https://glific.github.io/docs/docs/Product%20Features/Reporting%20&%20Dashboard/BigQuery%20Setup%20and%20link%20with%20Glific)
+- [Sample Dashboard](https://lookerstudio.google.com/u/0/reporting/6f6d2bd7-7bd0-45d0-afad-1e9620f266d8/page/CoQkB)
+___
+## Video Tutorial
+
+
+
+___
+
+# Why should you connect to the V5 Template Dashboard?
+Deploying your chatbot program can generate tremendous value at scale for your users, **the template dashboard enables the crucial other half of your chatbot program.**
+- It enables your organisation to **monitor and evaluate the health of your chatbot program**, so that you may iterate and improve the experience for your users.
+- The dashboard **also serves as a repository of user information that your field/remote operations teams can easily download** to engage more deeply with your stakeholders.
+
+
+The template dashboard aims to make as much common chatbot program information accessible to your organisation as possible. You may use what is relevant to your program. Beyond this, you might want to tweak this dashboard to further suit your needs, refer to [google support](https://support.google.com/looker-studio/?hl=en#topic=6291037) to learn how to do this.
+___
+
+# Understanding the pages in the Dashboard
+## 1. Overview
+This page has been created to give your organisation a sense of the overall health of your chatbot progream. It is divided into 3 broad sections, described below.
+The page has one date range filter at the top left which is set to the last 30 days by default.
+
+### Stakeholder Engagement Overview
+
+
+
+This section of the overview page tells you about the number of people/phone numbers that have engaged (sent or recieved messages) with your chatbot.
+- **Contacts reached since launch:** The total number of phone numbers that have ever engaged with your chatbot till today. This number will not change when you alter the date range filter.
+- **Active Contacts (recieving messages):** The total number of phone numbers that have recieved a message in the selected time period.
+It is important to note that all contacts who have recieved a message might not have sent a message back to you, but all those who have sent a message to your bot would definitely have recieved a message back.
+- **Contacts sending messages:** The total number of phone numbers that have sent a message to your chatbot in the selected time period. This is a subset of your Active Contacts value.
+- **Sending/Active:** The percentage of phone numbers who are sending messaged to your chatbot as compared to the total number of phone numbers that have received messages. Based on the nature of your program you could decide what percentage indicates good engagement.
+- **Active contacts and messages exchanged graph:** This is a very useful graph that helps you analyse the trends of contacts engaged and messages sent over time.
+
+ **Note:** _If you hover your cursor over the top right corner of this graph and click on the down arrow, you can learn about engagement trends over months, days of the week and hours of the day. Give it a try!_
+___
+### Messages and Conversations Overview
+
+
+
+This section of the overview page tells you about the number and types of messages and conversations you have exchanged. Messages and conversations impact costs and can be seen in further detail the _conversation costs_ page of your report.
+- **Messages exchanged:** The total number of messages that have been sent by the bot (outgoing) or recieved by the bot (incoming) in the selected time period.
+- **Outgoing and Incoming messages pie chart:** The distribution of total messages exchanged.
+- **Outgoing and Incoming messages graph:** The daywise trend of messages exchanged over time.
+- **Conversations started:** The total number of unique conversations started during the selected time period. A single conversation is defined a 24 hour window from the first message sent by your bot.
+- **Conversation type pie chart:** The distribution of conversation types. Different conversation types are charged differently. Refer [here](https://support.gupshup.io/hc/es-co/articles/4414423534617).
+- **Conversations Graph:** The daywise trend of total number of conversations over time for the selected time period.
+___
+### Contact Opt in/Opt out Overview
+
+
+
+This section is especially useful during the onboarding phase/s of your program. An important first step in using the chatbot is getting your users consent or to 'opt in' to receive messages from you. This is required by WA/Facebook to ensure that people do not recieve spam messages.
+- **Opt in since launch:** The total contacts who have opted in since your chatbot started
+- **New optins:** The users who have opted in during the selected time period.
+- **Optin Graph:** The day wise trend of optins for the selected time period.
+- **Active opt in contacts:** The total optin contacts recieveing or sending messages in the selected time period.
+
+Similarly for the the 3 corresponding opt out visuals.
+___
+## 2. Flow Activity
+This page has been created to help you monitor your flows. It is divided into 4 broad sections, described below. This page has a date range filter and a flow name filter which allows you to see data for a specific flow during a specific time period.
+___
+### Flow Activity Overview
+
+
+
+
+This section tells you how many people are going through the flows and how often.
+- **Contacts starting flows:** The number of contacts starting selected flows in the selected time period.
+- **Total flows traversed:** The total number of times the selected flows have been entered in the selected time period.
+- **Unique flows traversed:** A count of the unique flows entered in the selected time period.
+- **Contacts and total flows traversed graph:** The Daywise trend of contact and flow activity over time.
+___
+### Flows Completed
+
+
+
+
+This section will help you understand how often and how your flows are being completed.
+- **Total flows completed:** A count of the unique flows selected.
+- **Flow completions table:** A list of the selected completed flows and the number of times it has been completed.
+- **Flow completed node table:** A list of the completed flows, the node at which the flow was completed, and the number of times that node was reached.
+- **Flow completion graph:** The daywise trend of flows completed during the selected time period.
+___
+### Incomplete and Killed Flows
+
+
+
+This section helps you investgate which flows have been killed, at which node, and for which contact. Flows can be killed if contacts do not respond for 7 days, if a webhook fails, if they fall into an infinite loop, or if you manually terminate the flow.
+Using this you can identify where and how to improve your flows.
+- **Total incomplete and killed flows:** The number in the box indicated the count of unique flows that have been killed for some contacts.
+- **Flow name table:** The list of killed flows out of the flows that you have selected and the number of contacts for whom the flow is killed.
+- **Node and result table:** The list of killed flows, the node, associated result name and number of contacts for whom the flow was killed.
+- **Contact list table:** The list of phone numbers and the point at which the flow was killed. Using this you can investigate your flow and their chat on Glific to understand the problem further.
+
+___
+### Contacts in the Middle of Flows
+
+
+
+This section is structured the same was as the previous one. It will tell you about flows which contacts have not completed, which node they are at, and who the contacts are.
+___
+## 3. Contact Activity by Flow
+
+This page has been created to give you information about your contacts. It is divided into 3 broad sections, described below. This page has a date range filter, a flow name filter, and a flow label filter which allows you to see data for a specific flow/flow label during a specific time period. [Using labels](https://www.youtube.com/embed/Y2KWDO7SfnI?showinfo=0) to track engagement is an important part of flow design.
+
+This is an important page to gather user information and data points for activity in specific flows.
+
+### Total Contacts and Messages by Flow name/Flow Label
+
+
+
+This section is the same as the the **stakeholder engagement overview section** in the **overview page**, with the key difference being that you can filter and check engagement for specific flows.
+___
+### Contact Details by Flow Label
+
+
+
+This section allows you to see the contact activity for each of the listed flow labels for a specific flow or of flow labels selected, depending on how you use the filters.
+- **Flow label & contacts table:** Displays all the associated flow labels as per your filter and the count of contacts tagged with that label.
+- **Flow label and messages table:** Displays the flow label, contact, and associated message as per your selected filters.
+
+___
+### Contact Activity
+
+
+
+This section comprises of 1 table which will give you a list of every contact for selected flows or flow labels and show you how many messages the contact has sent during the selected time period. It is arranged for you to see your most active contact at the top.
+___
+## 4. Result Details
+This page gives you all the information stored in your [flow variables](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Variables/Flow%20variables%20vs%20Contact%20variables) which we create and store with '@results'.
+The page has two sections with one table in each.You can filter this page by date, flow name, and result name.
+
+
+
+- **Total users by result name:** Describes the number of times a value has been stored in a result/flow variable for a specific flow.
+- **User names and responses by result name:** Gives you the list of contacts, when they passed through the node and what value was saved in the result/flow variable.
+___
+## 5. Contact Details
+This page is where you will find all the contact details that you have [stored in contact fields](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Update%20the%20contact/#define-custom-variables).
+This page has 5 visuals, described below. This page allows you to filter by contact name, phone number, contact field, and date.
+
+
+
+- **Active Contacts(recieving messages)**: A count of all the contacts stored who have recieved messages in the selected time period.
+- **Total users by language preference:** Shows you the distribution of contacts for those contacts who have their language preference updated on your system.
+- **Contact List:** This table shows you all you contacts, the contact field values that have been created for them and the associated values stored in these contact fields.
+- **Opt out Contacts** This table shows you the list of all the contacts who have opted out from using your chatbot(i.e. you can no longer send them messages) and their related details.
+
+
+
+___
+
+## 6. Conversation Costs
+
+
+You will recieve a monthly invoice from Gupshup based on the messages you exchange and the conversations started. This page provides you with a snapshot of your chatbots activity and associated charges for the selected time period. It is an expansion of the second section of the overview page.
+
+
+
+To learn more about charges for the types of conversations and messages mentioned in this sheet refer [here](https://support.gupshup.io/hc/es-co/articles/4414423534617).
+
+___
+
+## 7. Collection Messages
+This page allows you to search for your contacts by the collections that they are part of and then check how many and which messages they have exchanged.
+You can filter this page by date, phone number, and collection name. This page has 2 visuals, described below.
+
+
+
+- **Total Messages exchanged per collection:** A list all the contacts, the collections they belong to and the total messages they have exchanged.
+- **Messages exchanged:** A list of all the messages exchanged by each contact in the selected collections.
+
+
+
+___
+
+## 8. Collection Contacts
+This page allows you to search for your contacts by the collections that they are part of, check how many there are and extract their details.
+You can filter this page by date, phone number, and collection name. This page has 3 visuals, described below.
+
+
+
+- **Number of contacts:** The total number of active contacts for the selected time period in your selected collections.
+- **Contacts by collection table:** This table gives you a count of the active contacts for the given time period, per collection selected.
+- **Contacts details by collection:** This table will give you all the contact details by contact field as per the selected filters.
+
+
+
+___
+## 9. User Retention
+This page provides you with a view of monthly user retention. it has a date filter set to always show you the past one years data. It contains a single visual which can be understood as follows:
+
+Refer to the row for Nov 2022. In this month, 22 contacts engaged with our bot for the first time (the column labelled '0'). In the following month, 14 of these contacts returned to use the bot (column labelled as '1'), in the following month only one of these users returned. And in the month after that, 3 users from the cohort who first engaged with us in Nov 22 had returned to use the bot.
+
+
+
+___
+
+## Additional
+
+### Checking which dataset is being used
+
+___
+
+Understanding which dataset and fields are being used will help you understand your dashboard better.
+1. Hover your cursor over the top of the dashboard and click edit at the top right. You will enter the editing mode.
+2. Click on any visual and refer to the first column on your right. You can see which data source is being used under the heading 'data source'.
+
+
+
+Note: If you have not connected to our V5 template dashbord then first make a copy (option next to edit) and then follow the above steps.
+
+The visuals will not populate until you connect them to your chatbot data sources, but you should still be able to see which dataset its intended to pick up from.
+
+
+
+___
+
+### Downloading data
+
+1. In view mode, hover your cursor over any visual and click the 3 dots at the top right of the vidual.
+
+
+
+2. Select export and then pick whichever format you want the data in.
+
+
+
+___
diff --git a/versioned_docs/version-1.0.0/3. Product Features/09. Reporting & Dashboard/_category_.json b/versioned_docs/version-1.0.0/3. Product Features/09. Reporting & Dashboard/_category_.json
new file mode 100644
index 000000000..436611c29
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/09. Reporting & Dashboard/_category_.json
@@ -0,0 +1,5 @@
+{
+ "link": {
+ "type": "generated-index"
+ }
+}
\ No newline at end of file
diff --git a/versioned_docs/version-1.0.0/3. Product Features/10. Help.md b/versioned_docs/version-1.0.0/3. Product Features/10. Help.md
new file mode 100644
index 000000000..e69de29bb
diff --git a/versioned_docs/version-1.0.0/3. Product Features/10. Others/01. Getting Started with Glific.md b/versioned_docs/version-1.0.0/3. Product Features/10. Others/01. Getting Started with Glific.md
new file mode 100644
index 000000000..71d48e2bd
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/10. Others/01. Getting Started with Glific.md
@@ -0,0 +1,131 @@
+> ### **2 minutes read `Beginner`**
+
+**You can start communicating with your contacts/ beneficiaries after your Glific account setup is complete.**
+
+## Video Tutorial: Getting started with Automated Chat Flows
+
++ +2. Click on `Flows` menu from the left panel and then click on `+ CREATE FLOW` button from top right corner + + + +
+ +3. Enter the `Name` of the flow and the `Keywords` with which you want to trigger/start the flow. Click on `Save` button. + + + +## Configure the Flow + +1. You will see your first flow created on the `Flows` tab. Click on the `Configure` icon to start adding messages in the flow. + + + +
+ +2. Once the Flow Editor opens up, click on `Create Message` to create your first message in the flow. + + + +
+ +3. The `Send Message` node will open up. Type your introductory message in the input box. Click on `Ok` button to save it. + + + +
+ +4. You will now see a node created in your Flow Editor. + + + +
+ +5. Click on the **red dot** at the bottom of the node and drag it to create the next node. + + + +
+ +6. You can receive the response back from your contact at this stage and show it back to the contact in a flow. + + + +
+ +7. There are many message types that are available for you to build up your communication flow with your contacts. + +## Test the flow + +12. To test your communication flow, click on `Preview` button from Glific flow edit. + + + +13. It will open up a simulator for you to start communicating through the flow. + + + +14. Reply from the simulator message input box and you will see the + +the response back from your flow. + +15 . `Publish` the flow to start using it with your contacts, after your test is successful. + + + +- **Publish & Stay** - Will publish the flow and keep the flow open in Flow editor. +- **Publish & GO Back** - will Publish the flow and take you to the flows listing page. +- **Cancel** - Will not publish the flow and keep the flow open for editing + + + + + +16 . Note it will show the `Last published` and `Last saved in draft` date and time of the flow. Make sure to publish the flow after edits to get the desired results from the flow. + + + +## Change Admin in Facebook Business Account + +If needed, one can add new members in the FaceBook business account. Refer the Facebook support article below for more details : [Add People to your Business Manager](https://www.facebook.com/business/help/2169003770027706?id=2190812977867143) + +You can also change the role of the person to admin if needed. +Refer the Facebook support article below for more details : [Change someone's Role in Business Manager](https://www.facebook.com/business/help/254817222048070?id=2190812977867143) + + +## Reference Articles + +[Flows : By TextIt](https://help.textit.com/en/article/sending-messages-with-a-flow-t9sj2w/)
_We thank the **TextIt** team for publishing it openly for the community._ + +## Tutorial Videos + +- [Tutorials on Flows : By RapidPro](https://app.rapidpro.io/video/) + +- `Save` and `Publish` the Flows +
+
+The `Role Management` option could be seen inside the pop-up as shown above.
+
+### How to create a User Role?
+
+1. Open `Role Management`
++
+
+
+2. Click on `+ CREATE ROLE` on top right corner
++
+
+
+
+3. In the `Add a New Role` page, input the name (label) of the role and a short description and click on `SAVE`.
++
+
+
+
+4. As you can see in the `Role Management` listing page, the role we created is shown towards the bottom with the description given.
++
+ +
+5. The role we created can be accessed in Staff Management. When you try to edit a user under Staff Management, the role we created will be displayed in the drop down as shown above.
\ No newline at end of file
diff --git a/versioned_docs/version-1.0.0/3. Product Features/10. Others/03. Languages.md b/versioned_docs/version-1.0.0/3. Product Features/10. Others/03. Languages.md
new file mode 100644
index 000000000..ac07e9fc4
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/10. Others/03. Languages.md
@@ -0,0 +1,153 @@
+> ### **3 minute read `Beginner`**
+
+**Glific supports multiple languages to communicate with contacts in different languages. It enables global reach, personalization & localization, inclusivity, efficient customer support & satisfaction**
+
+## Create flow
+
+1. Start creating a new flow in the flow editor. Refer [Getting started with communication in Glific](https://glific.github.io/docs/docs/Product%20Features/Others/Getting%20Started%20with%20Glific) to know more about how to create flows.
+
+
+
+## Languages available to communicate
+
+
+
+2. Click on the `configure` icon on your new flow.
+
+
+
+
+
+3. Verify the languages are available to create a flow.
+
+
+
+
+
+## Create flow in a different language
+
+
+
+4. Click on the `language` option to add translation of the message for that language.
+
+
+
+
+
+5. Click on the message you want add another language support for.
+
+
+
+
+
+6. Enter the message text in the selected language and click `OK` button to save it.
+
+
+
+
+
+7. Your message is saved. You can repeat the process for all the languages and all the messages.
+
+
+
+
+
+8. You can click on the `default` link to see the message again in English
+
+
+
+
+
+To **add more languages in flow editor** please refer to [Add a new language in the flow editor](https://glific.github.io/docs/docs/Product%20Features/Others/Languages/#add-new-language-in-flow-editor).
+
+## Test the flow in a different language
+
+To test the flows in different languages, the user needs to change the language preference of the contact who is testing. And then execute the flow, which needs to be tested.
+
+There are two ways to change the language.
+
+1 . Type language and send it to BOT (it will execute the language flow ) and change contact language.
+
+2 . Change the contact language from the user's profile.
+
+a) Click on the View Contact Profile.
+
+
+
+
+
+b) Change the language from the dropdown.
+
+
+
+
+
+
+
+For details, you can refer to the article [https://help.nyaruka.com/en/articles/4207750-changing-the-default-flow-language](https://help.nyaruka.com/en/articles/4207750-changing-the-default-flow-language) published by the **Nyaruka team** for the community. We thank the **Nyaruka team** for publishing it publicly for the community.
+
+
+## Interface Languages
+
+**Glific by default uses English language for its interface. A staff can change the interface language to other languages if they wish to use other languages.**
+
+
+
+# How to change the language of your interface.
+
+1 . Login in your Glific account.
+
+2 . Click on `Profile` icon from left menu .
+
+
+
+
+
+3 . Click on `My Account` menu item
+
+
+
+4 . On `My Account` page click on the `change interface language` dropdown to select the available languages for interface.
+
+
+
+
+
+5 . Interface language is changed in your preferred language.
+
+
+
+
+
+
+## Add new Language in Flow Editor
+
+To add new language in Flow editor, add it from the organisation setting screen.
+
+**Steps to add new language in the Flow editor.**
+
+1 . Click on `settings` icon from bottom left corner.
+
+
+
+
+
+2 . Click on `edit` icon in Organisation tab.
+
+
+
+
+
+3 . In **supported languages** section click `arrow` icon to open the drop down. Click on the checkbox next to the language you want to add in your flow editor.
+
+
+
+
+
+4 . Click on `Save` button to save the changes.
+
+
+
+5 . Verify the new language added in the flow editor
+
+
diff --git a/versioned_docs/version-1.0.0/3. Product Features/10. Others/04. Keywords.md b/versioned_docs/version-1.0.0/3. Product Features/10. Others/04. Keywords.md
new file mode 100644
index 000000000..60debc09a
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/10. Others/04. Keywords.md
@@ -0,0 +1,31 @@
+> ### **1 minute read `Beginner`**
+
+**Keywords are used to start a particular flow from a BOT. When beneficiary sends a specific word which is set as keyword for a flow, that particular flow will start and beneficiary will start getting messages from that flow. Multiple Keywords can be defined with a flow and in different languages. Common keywords used are _Hi_, _Hello_, _Help_, _NGO Org Name_ etc, depending on the purpose of the flow.**
+
+## How to define a keyword
+
+Keywords can be defined at the time of creating a flow and can also be edited at a later stage.
+
+1 . Click on `+ CREATE FLOW` button
+
+
+
+
+
+2 . Enter the name of the flow and define keywords. Separate the Keywords with coma "," to add more than one keyword in a flow.
+
+
+
+## Edit Keywords
+
+Click on `Edit` icon next to the flow listing page to add or edit the keywords. Keywords are shown below the flow name, to know which keywords are assigned to a flow.
+
+
+
+## Ignore keywords
+
+4 . `Ignore keywords` if checked, is used to restrict beneficiary to enter any other flow from the active (current) flow with use of keywords of another flow.
+
+
+
+5 . Click on `Save` button to save the modifications done in keywords
diff --git a/versioned_docs/version-1.0.0/3. Product Features/10. Others/05. New Contact, Default flow Out of office hours notifications.md b/versioned_docs/version-1.0.0/3. Product Features/10. Others/05. New Contact, Default flow Out of office hours notifications.md
new file mode 100644
index 000000000..b3736a2e9
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/10. Others/05. New Contact, Default flow Out of office hours notifications.md
@@ -0,0 +1,75 @@
+There may be a requirement to start a specific flow when a new contact sends any message for the very first time to the BOT.
+
+## Configure New Contact flow
+
+1. Click on `Settings` icon from the sidebar.
+
+
+
+
+
+2. Click on the edit icon on `organisation` block.
+
+
+
+
+
+3. Select `New contact flow` **** checkbox. If the `New contact flow` checkbox is unselected, then no flow will execute for the new contact for the very first message.
+
+
+
+4. Select the flow from the dropdown which you want to execute when a new contact sends a message for the very first time.
+
+
+
+
+
+5. Click on the `Save` button
+
+
+
+
+
+There may be a requirement to send automated responses, when contact send any keyword which is not assigned to any flow or send responses during the non working hours. NGOs can configure **Default flow** in Glific and assign a flow to respond.
+
+## Configure Default flow
+
+1. Click on `Settings` icon from sidebar.
+
+
+
+
+
+2. Click on edit icon on `organisation` block.
+
+
+
+
+
+3. Select `Default flow` checkbox.
+
+4. Select the flow, which you want to use as default flow.
+
+5. Select the `days` of working from the dropdown
+
+6. Select the `start`and `stop` hours from the clock icon.
+
+## Trigger a flow during non working hours
+
+7. Select the flow which you want to trigger, if user sends any message in out of operations hours.(Hours outside of the hours selected for default flow) .
+
+8. Click on `Save` button activate it.
+
+
+
+
+
+9. You can deactivate it any time by unselecting the `Default flow` checkbox.
+
+
+
+**Some details about** `Default flow` **flow.**
+
+1. It will not work for new contacts, when they message it for the very first time.
+1. If beneficiary enters any keyword of any flow, then that particular flow will execute, not the flow selected in `out of` `Hours of operation` .
+1. The `out of Hours of operation`flow will be executed only once in a day for each contact,
diff --git a/versioned_docs/version-1.0.0/3. Product Features/10. Others/06. Collections.md b/versioned_docs/version-1.0.0/3. Product Features/10. Others/06. Collections.md
new file mode 100644
index 000000000..b1e4ef3d1
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/10. Others/06. Collections.md
@@ -0,0 +1,108 @@
+> ### **2 minute read `Beginner`**
+
+Collections is a feature in Glific to keep one set of users in one place and use it to communicate with all users in that collection in one go.
+
+## Video Tutorial
+
+
++ +2 . Click on the `Export Flow` icon from the tile of the flow, which you want to Export. + + +
+ +or + +It can also be exported from the Flow Editor, if the flow is opened for configuration. + + + +
+ +3 . On clicking the `Export Flow` button, the file explorer pops up. Click on `Save` to save the file on your device. The file will be saved in **JSON** format. + + + + +## Importing the Flows + + + +1 . Click on the Flows tab from the Left Panel. + + + + +
+ +2 . From the Flow listing screen, click on `Import Flow` button + + + +
+ +3 . It will open the file explorer window to select the flow file. + +4 . Select the file and click on `Open`. The flow will be copied, created and displayed on the Flow listing page. + + diff --git a/versioned_docs/version-1.0.0/3. Product Features/10. Others/12. Contact Profile & History.md b/versioned_docs/version-1.0.0/3. Product Features/10. Others/12. Contact Profile & History.md new file mode 100644 index 000000000..f9ba255ab --- /dev/null +++ b/versioned_docs/version-1.0.0/3. Product Features/10. Others/12. Contact Profile & History.md @@ -0,0 +1,147 @@ +> ### **4 minute read `Beginner`** + +**NGO users can see the contact profile and access history from the Glific interface, when there is a requirement to check the same. It could be used for personalized interactions, data-driven decision making, improving support etc.** + +## View Contact profile + +1 . Login to the Glific and click on the chats tab from the left panel. + + + + + +2 . Search the contact from the name of the contact or phone number from the right panel. + + + + + +3 . From the top bar click on the down arrow (next to the contact name) and click on `View contact profile` link + + + +4 . Contact profile page will open up. You can check the below details of contact. + + i) Name - **_Contact Name will be shown in chat screen and view profile page screen is the one which is set in the flow with_ `@contact.fields.name` **_variable, by the contact. If the name is not updated with the_ `@contact.fiels.name`**_variable, the name will be picked from_ `@contact.name`**_(WhatsApp name set by the contact) variable._** + + + + + + + + + + + + ii) phone number + + iii) Provider status / Optin Staus - ( _if contact is optin and can receive HSM templates_) + + iv) Language - ( contact's preferred language). NGO users also can change the language and save it to update the language preference of contact. + + +
+
+## Create New Profile
+
+1 . Create a new flow and ask a question, the contact if he/she wants to create a new profile.
+
+
+
+
+
+
+
+2 . If contact press 1. As contact to provide their profile attributes like name and role
+
+
+
+
+
+3 . Once the contact share the details use the node with the name `manage profile` and add the details to the profile.
+
+
+
+
+
+4 . It will return success or failure. If it returns success add the values. in the contact variables.
+
+
+
+
+
+Output after executing the flow (**Create User**)
+
+
+
+## Access Old Profile
+
+To access the old profile or the profile just create.
+
+1 . Enter option 2 (Switch to the existing user) in the first node created
+
+
+
+
+
+
+
+
+2 . Use `@contact.list_profiles` to show all profiles that exist for this phone number.
+
+
+
+
+
+3 . Use the `manage profile` node to switch the user profile
+
+
+
+
+
+
+
+4 . **On success**, access the profile contact variables with `@contact.fields.name`
+
+**On Failure** ask the contact to choose the option again.
+
+
+
+
+
+Output after executing the flow (**Switch User**)
+
+**User profile 1.**
+
+
+
+
+
+**User profile 2**
+
+
+
+## Multiple Contact Profiles with same phone number
+
+### Video Tutorial
+
+
+
+It has been observed in some cases, beneficiaries have one phone number and there is more than one person who needs to have their profile created to access the Chat.
+
+In Glific we have introduced a multiple profile feature, which will help more than one person to create their profiles and use the chatbot to access the information with one phone number.
+
+Below are the steps on how to implement multiple profile features in your flow.
+
+## Advanced Feature Webinar
+
+
+
+## View Contact History
+
+1 . Scroll down the contact profile page.
+
+2 . Click on the `show more` button to see the older history of the contact.
+
+
diff --git a/versioned_docs/version-1.0.0/3. Product Features/10. Others/All product features.md b/versioned_docs/version-1.0.0/3. Product Features/10. Others/All product features.md
new file mode 100644
index 000000000..3b38fc784
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/10. Others/All product features.md
@@ -0,0 +1,129 @@
+## Send and receive messages
+
+At the most basic level you can send and receive messages to your user community.
+
+## Rich media attachments
+
+You can use stickers, images, videos(youtube link or attached in message), document, audio. You would need to host the media files on platforms like Google Cloud Storage and then provide link as an attachment on Glific.
+
+## Record and send audio messages
+
+You can upload an audio file on GCS and add the link in a message or you can also directly record the message from the Glific chat interface and send to the users.
+
+## Multiple languages
+
+You can enable different regional languages and plan the message content to support those languages. See More
+
+## Flows - conversation builder
+
+1. [**Design Conversations**](https://glific.github.io/docs/docs/Onboarding/Glific%20Onboarding%20Toolkit) - You can set up messages to be sent to the users and plan the next messages based on their responses. You can also take a lot of other actions based on users' responses as mentioned below.
+1. [**Send message to a staff**](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Send%20a%20staff%20member%20a%20message) - If you feel that your staff needs to be notified of something while a contact is in the middle of the flow.
+1. **Terminate flow** - if a user is in a flow and you want to send a manual message you can terminate the active flow
+1. [**Label a message**](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Label%20the%20incoming%20message) - if you want to track some metrics, labels are your good friends. For example you want to see how many started a flow and how many completed the flow, you can label the first message as `Flow stared` and last message at `Flow completed`.
+1. [**Wait for the next message**](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Wait%20for%20the%20contact%20to%20respond) - you can add pauses in between messages to make it look like a more natural conversation.
+1. [**Split conversation paths**](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Split%20By/Custom%20Expression) - you can send different contacts down different conversation paths based on multiple conditions for example, the collection they belong to and an option they selected.
+1. [**Webhooks**](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Call%20a%20webhook) - use these when you want to interact with an external system to pull or push data from Glific.
+
+## Block contacts
+
+If you don't want to see a particular contact in the chat list maybe because they sent inappropriate messages or spammed the chatbot, you can block and remove them from the list.
+
+## Simulator
+
+The simulator can help you test the conversation flows without spending additional costs of testing it on your actual phones.
+
+## [Advanced Search](https://glific.github.io/docs/docs/Product%20Features/Searches/#advanced-search)
+
+As you interact with a large number of contacts you might want to search them for more than 1 parameter such as if there's a label assigned to the message, if some team member is managing it, or just looking up within a date range. You can also save this search for quick reference later on. Saving this search allows you to grow that search result over time. For example you want to view all the messages labeled `Flow complete` and belong to the `Jharkhand` collection.
+
+## [HSM templates](https://glific.github.io/docs/docs/Product%20Features/Templates)
+
+WhatsApp allows you to nudge your users if they have not messaged the chatbot within 24-hours. For this you need to get an HSM template message approved before you can send it out. Glific offers the interface to submit this message for approval. You can use these templates as a single message or within a flow. Templates also allow you to use buttons to redirect the user to a website link or call you at the press of a button.
+
+## [Interactive messages](https://glific.github.io/docs/docs/Product%20Features/Interactive%20Messages)
+
+Messages can also have clickable actions for upto 10 options. For upto 3 options you can use buttons, but for more than 3 and upto 10 you need to use the list option. These are a good replacement when you want to get users to respond to move the conversation flow forward.
+
+## [Time based scheduling (triggers)](https://glific.github.io/docs/docs/Product%20Features/Triggers)
+
+When you want to send a flow or message to a user at a specific time, you can schedule those messages in advance. You can simply set up a trigger and forget about it 😄. This scheduled messages can be recurring periodically or can be sent one time - upto your program.
+
+## [Default messaging](https://glific.github.io/docs/docs/Product%20Features/Others/New%20Contact,%20Default%20flow%20Out%20of%20office%20hours%20notifications/#configure-default-flow)
+
+There will be cases when your contacts will not be in any flows you've defined on Glific or they might send a message that doesn't match any keywords you've planned for. In those cases, this default flow will get triggers so that you have the opportunity to bring the user into one of your desired conversation flows.
+
+## [Staff management (roles & permissions)](https://glific.github.io/docs/docs/Product%20Features/Others/Staff%20Management)
+
+As Glific is a cloud based program, you and your team can work together from anywhere. Your team members can create their own Glific login and use the platform. Different team members can be given different access.
+
+## [Collections](https://glific.github.io/docs/docs/Product%20Features/Others/Collections)
+
+Whenever you want to categorise your users based on a certain data point such as their location, grade, language preference, or any other category specific to your program, you can put them in a collection. This allows you to send targeted messages to all the contacts in a collection at once. You can move contacts in and out of the collections as per your use case.
+
+## [Optin Management](https://glific.github.io/docs/docs/Product%20Features/Flows/Others/Configure%20Optin%20&%20Optout%20preferences%20in%20Glific/)
+
+WhatsApp requires you to get legit optin from the contacts else you run into the chance of getting your number blocked. You can save their optin status within glific and send them nudge messages. Or if the contacts no longer want to receive a message you can opt them out.
+
+## [Contact history](https://glific.github.io/docs/docs/Product%20Features/Others/Contact%20Profile%20&%20History/)
+
+You can view how & when a contact moved from one flow to the other, how & when they were added or removed to a collection or any other contact related activity on Glific. You can check this information in the contact profile along with all the other contact related information.
+
+## [Multiple profiles](https://glific.github.io/docs/docs/Product%20Features/Others/Contact%20Profile%20&%20History/#multiple-contact-profiles-with-same-phone-number)
+
+With this feature, one contact(i.e. WhatsApp number), can have multiple user profiles associated with the contact. For example, 2 or 3 children in a household using the same phone to access the chatbot. In the default case, one contact will have one profile. If you have used this feature and users have created multiple profiles, then they can easily switch profiles to continue from their last interaction. When a contact starts using the chatbot, in case multiple profiles exist, you can ask the user to select the right profile. The data collection happens at a contact level and not at a profile level - this is something we still need to figure out.
+
+## [Maps visualisation](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Wait%20for%20the%20contact%20to%20respond/#15-has-location)
+
+You can use the default location feature of WhatsApp to get the user's locations and then plot them on the map. This can enable you to check the density of an occurrence in a region for ex, if you want to see how many people reported potholes or garbage in their location.
+
+## [A/B Testing](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Split%20By/Random%20Chance%20for%20AB%20Tests)
+
+Glific NGOs have reached a stage where they want to run tests with their flows and find the most optimum method to deliver their content and engage with users. Managing A/B tests right now isn’t easy and so we’re building the right support for A/B tests.
+
+## Speech Recognition
+
+When using voices is crucial for your programs, you can use speech recognition features to get users to respond with a voice note and understanding their responses. Glific uses external integrations to accomplish this hence not readily available. If you share your usecase with us, we can help you with this.
+
+## [Notifications](https://glific.github.io/docs/docs/Product%20Features/Notifications)
+
+Glific provides warnings and critical alerts whenever errors and issues arise such as message not sent, template message got rejected etc… You can access notifications from the sidebar.
+
+# Integrations
+
+## [Google Sheets](https://glific.github.io/docs/docs/Product%20Features/Flows/Flow%20Actions/Link%20Google%20Sheets)
+
+Many education orgs need to continuously create new content for the chat flows while keeping the same conversation experience. So while the content order remains same, the content itself changes over time. This often needs a standard Glific flow where the content can be pulled from a google sheet which stores the dynamic content. This way you won't have to make new Glific flows each time you have to deliver content.
+
+## [Access data with BigQuery](https://glific.github.io/docs/docs/Product%20Features/Reporting%20&%20Dashboard/BigQuery%20Setup%20and%20link%20with%20Glific)
+
+All the conversation program data resides in BigQuery which is an additional tool required when using Glific. Glific only stores the data for a couple of months and then removes it. So your data only resides on BigQuery in the long run.
+
+## [NLP with Dialogflow](https://glific.github.io/docs/docs/Integrations/Dialogflow%20for%20Natural%20Language%20Processing/)
+
+If you have a use case there your users are typing a wide variety of unexpected responses that can't be handled by the options in Glific, then you can also use Dialogflow's NLP feature to respond to your users. You can group those unexpected responses by categories and prepare the responses for those categories. Dialogflow will fuzzy match the message and send relevant response to the contact. To use NLP you must ensure that your chatbot is being used at a sufficiently large scale like with more than 3-5K contacts.
+
+## [Exotel for calling](https://glific.github.io/docs/docs/Integrations/Setting%20up%20Exotel/)
+
+If you want to include a functionality to call the user or receive a call from them at some point in the conversation flow on WhatsApp, then you can use Glific's Exotel integration to take relevant action for example based on a call, redirect them to the optin or any other flow or update their contact information.
+
+## CRM or Tracker
+
+A tracker aims to collect information about the individual users as per their journey on the chatbot. The tracker stores all information such as basic demographics, content they access, response to quizzes, points earned, progress or advancement across levels, most active time, drop off point and time and more. You can adapt the tracker as per your program design. As a result of the tracker, all of these will be possible:
+
+- Personalized learning journeys and recommendations
+- Learner’s profile even for shared contacts
+- Send report cards
+- Manage points and badges
+- Improved analytics
+
+What information would you want to collect from the users? - that would be the first step to an effective tracker. The needs of every NGO in terms of data points would be different, can the tracker structure be determined based on the information collected during the contact registration.
+
+# Upcoming features
+
+## Internal dashboard
+
+So far NGOs have been using BigQuery and Data Studio to build their reporting dashboards but not all NGOs find that very convenient to use. Basic reports within the Glific interface are preferred. Now with enough evidence and report templates, we will be building a dashboard within Glific interface.
+
+## Template reports advancement
+
+We will work on advancements in data collected through conversation flows. This upgrade will allow Glific to collect more information in an automated way so as to reduce human error and chance of generating rich data dashboards.
diff --git a/versioned_docs/version-1.0.0/3. Product Features/10. Others/Tags.md b/versioned_docs/version-1.0.0/3. Product Features/10. Others/Tags.md
new file mode 100644
index 000000000..c9bc3c0c4
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/10. Others/Tags.md
@@ -0,0 +1,47 @@
+> ### **2 minutes read `Beginner`**
+
+**Glific currently supports the use of `Tags`, which is used for categorizing flows, HSM Templates & Interactive Messages. Tags help you manage your flows/ templates/ interactive messages faster and enables you to filter out and view items belonging to each Tag separately, making the search process easier.**
+
+
++ +## Tags in Flows + +
+
+In the Flow listing page, you will find the option for selecting a Tag from a dropdown list. Tags could be helpful for bundling all flows which are similar to each other.
+
+Tags could be created during the creation of a flow. Please refer the screenshot below :
+
+
+
+As you can see, while creating a flow, you can either select a Tag from the dropdown or create a new Tag which indicates the type of Flow. Here since it is a user registration flow, we’re tagging it as ‘Onboarding’. Similarly, other Tags could be used like ‘Support’, ‘Menu’ for bundling all flows which handle support or which contain menu respectively.
++## Tags in HSM Templates +
+
+Tags could also be useful in HSM Templates, for bundling all similar template messages.
+As you can see in the screenshot above, the Tag option could be found just above the `Submit for Approval` option.
+
+Similar to what we saw in `Tags in Flows`, during Template message creation, Tags could either be created or selected from the available set of options. It can also be ignored if not required.
+
+
+
+As you can see, on choosing the `Weather` tag, we are able to filter out all HSM templates which are tagged as ‘Weather’. Since only one template is tagged as ‘Weather’, just the template we just created is being shown. In this way, you will be able to categorize & at a later stage, search & find templates easily by making use of `Tags`.
++## Tags in Interactive Messages + +
+
+Tags can also be used in Interactive Messages. It will particularly be useful for categorizing interactive messages which has some common attributes. This makes finding them at a later stage useful.
+
+Tags could either be selected from a dropdown or a new Tag could be created altogether while creating an interactive message.
+
+
+
+In the screenshot above, we can see that the interactive message we’re creating is tagged with a new tag called ‘Registration’. So when you’re searching for the Tag at any later point, you’ll be able to find it out easily without scrolling over the whole Interactive Message listing page. Tags make sure that you end up categorizing similar interactive messages to the same bucket, bringing a structure in the flow listing page, improving the searchability & helps managing them easier.
+
+
+
+## Note
+It is important to note that selecting or creating tags are not mandatory during creation of a Flow, Template or Interactive Message. It is an additional feature in case you’ve large number of flows/ templates/ interactive messages & managing them becomes cumbersome.
diff --git a/versioned_docs/version-1.0.0/3. Product Features/10. Others/_category_.json b/versioned_docs/version-1.0.0/3. Product Features/10. Others/_category_.json
new file mode 100644
index 000000000..436611c29
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/10. Others/_category_.json
@@ -0,0 +1,5 @@
+{
+ "link": {
+ "type": "generated-index"
+ }
+}
\ No newline at end of file
diff --git a/versioned_docs/version-1.0.0/3. Product Features/_category_.json b/versioned_docs/version-1.0.0/3. Product Features/_category_.json
new file mode 100644
index 000000000..436611c29
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Product Features/_category_.json
@@ -0,0 +1,5 @@
+{
+ "link": {
+ "type": "generated-index"
+ }
+}
\ No newline at end of file
diff --git a/versioned_docs/version-1.0.0/3. Starter Kit/15 Pre-launch Chatbot Checks.md b/versioned_docs/version-1.0.0/3. Starter Kit/15 Pre-launch Chatbot Checks.md
new file mode 100644
index 000000000..8655d985d
--- /dev/null
+++ b/versioned_docs/version-1.0.0/3. Starter Kit/15 Pre-launch Chatbot Checks.md
@@ -0,0 +1,58 @@
+> ### **3 minute read `Beginner`**
+
+**Designing chatbots is an iterative process, and with every launch or pilot, you learn new things and make changes. But if you are launching your chatbot for the first time with your users, here are 15 quick things you need to cross check,to ensure that you have checked in all basic things for your Bot. It shouldn't take you more than 15 minutes to ensure everything is in place.**
+
+1. Disable the automated opt-in message on Gupshup. Every chatbot needs to take consent from it’s user to be able to further send messages. Gupshup sends a default message. But that generic message might confuse your users. Hence it is suggested to disable it on Gupshup and take consent on chatbot itself.
+To do this, click on your app on Gupshup, go to the Opt-ins tab, click on the Onboarding mechanisms dropdown arrow, and scroll down to disable the toggle.
+
+
+
+2. The first message that a user receives upon joining the bot should be a consent message. Here are a few guidelines for designing your consent message:
+- Clearly mention the name of the organization and the purpose of the bot.
+- Clearly ask the user if they would like to receive messages from the bot (You can provide an interactive message with a "Yes" or 👍🏼 button).
+- Users should have an option to opt out. Therefore, add the keyword in the footer through which users can opt out from the bot.
+
+
+
+### Other pointers to remember-
+- It is recommended to have the first ever chatbot conversation initiated by the user instead of you broadcasting the message to users, even if you have user details. Broadcasting messages might lead to user reporting or blocking the bot, which can affect the overall health of the bot. Unless you have obtained user consent outside the bot (on your app or manually), the first message should always be user-initiated.
+- Create a separate flow for users who type "STOP/ Opt Out" and add them to a collection. This will help you to reach out to them in future at least know how many of your users are opting out.
+
+3. Update the Opt-in settings post-user consent. It is mandatory to update a contact's settings with Opt-in after their consent.
+
+
+
+4. Important user information collected during registration, such as Name, Language, Training group, City, etc., should be updated in the contact profile. This will be helpful for you to refer in any flow in future
+
+
+
+5. Confirm key information (like Name, Language, etc.) which you would be using through out the bot, before updating the contact. Sometimes, users might enter incorrect information, which can impact the user experience throughout.
+
+For example, sharing a name as "My name is Krishna Priya" instead of just "Krishna Priya" can lead to the bot referring to the user with the incorrect name every time. Additionally, a user choosing the wrong language preference by mistake might discourage them from using the bot.
+
+But please remember that, there is a tradeoff that it adds another click in the process for the user. So pick the info you would like to confirm.
+
+
+
+6. You can customize which flow you want to send to users who have come to your bot for the first time. You can update this new contact flow through Settings → Flows. If you haven’t set it, then users would get a pre-set new contact flow (by Glific) which might not be your preferred first flow for new users.
+
+7. Add content in all nodes for all languages, if multiple languages are used for the bot.
+
+8. Add users to relevant collections based on how you want to communicate with them in the future.
+
+9. Use interactive messages wherever you want the user to choose from given options or when answers are predictable (e.g., grade, Yes/No, Gender, etc.).
+
+10. If a flow is triggered from your end to the user, the first message of the flow should be an HSM/ Template message (because we don't know if the users are in the active session window or not).
+
+11. Add labels for both outgoing and incoming messages for all the data you want to capture and check in the future.
+
+12. Use appropriate names for Flows, Keywords, and Result names to make it easy to track them in the future.
+
+13. Use emoticons, bold, italics, and media as needed.
+On a side note, Here is a [blog](https://glific.org/writing-your-first-chatbot-script/) written on writing the first chatbot script (along with some examples). Do give it a read!
+
+14. Ensure the user does not encounter any dead ends in the bot, especially in the case of interactive messages. Make sure there is also an option for the user to send free text apart from the button options you provide, and clarify what the user is expected to do. Connect the user's response back to the main question and wait for their response so the flow can proceed.
+
+
+
+15. Testing, Testing, Testing: Test the chatbot internally with at least 3 to 5 people on mobile phones before sharing it with actual users.
diff --git a/versioned_docs/version-1.0.0/4. Integrations/Bhashini ASR b/versioned_docs/version-1.0.0/4. Integrations/Bhashini ASR
new file mode 100644
index 000000000..d855f9333
--- /dev/null
+++ b/versioned_docs/version-1.0.0/4. Integrations/Bhashini ASR
@@ -0,0 +1,78 @@
+> ### **4 minute read `Advanced`**
+
+**“Bhashini” is a project or initiative aimed at providing easy access to the Internet and digital services for all Indians in their native languages. The primary goal of the project is to increase the amount of content available in Indian languages, thereby promoting digital inclusivity and accessibility for a broader population**
+
+---
+
+## Bhashini in Glific
+- Bhashini APIs are used in Glific for speech recognition
+- Whatsapp user can share an audio file, which could be converted to text (in the language chosen by the user)
+- The converted text could be stored in Google Sheets, used in flows/ used as per the use case
+
+---
+
+## Sample Chat
+
+
+---
+
+## Steps to integrate Bhashini ASR in Glific flows
+1. Create an account in [Bhashini website](https://bhashini.gov.in/ulca/user/register#) using name & email ID. Please verify the account using the email received.
+
+
+2. Go to ‘My Profile’ on the top-right corner.
+
+
+3. Generate ‘ULCA API Key’ (top-right corner). Also make note of the User ID on top of the button. This will be used inside the webhook call in Glific flow.
+
+
+4. Make note of the API Key generated. This is required inside the webhook call used in the Glific flow for calling the Bhashini API. (Starting with 01af.. here)
+
+
+5. Now login to your Glific instance and create a flow. In this example we’ll use a flow called Maven ASR Bhashini, used for recording incoming audio queries in a Google Sheet. The flow starts with asking the user to share the query as a voice note and it is saved as ‘speech’.
+
+The download link for a few sample flows are given below to test it for yourself.
+
+
+
+6. After the audio is captured, the Bhashini ASR API is called using a Webhook function called ‘speech_to_text_with_bhasini’ and the response is stored as ‘speech2text’.
+
+- The function name is pre-defined, you should always use the name ‘speech_to_text_with_bhasini’ to call the Bhashini API
+- The response stored (speech2text here) could be given any name of your liking, just like any other flow variable
+
+
+
+7. The webhook body is shown below. Please update the parameters as shown :
+
+- speech : It should be updated with the result name given for the audio file captured. Here, it is saved as ‘speech’ (Step 5), hence the value is @results.speech.input (If the audio note captured was saved as ‘query’, then the value will be @results.query.input)
+- userID : The userID is updated with the userID captured from Bhashini website. (Refer Step 3)
+- ulcaApiKey : The API Key needs to be updated with the ULCA API key captured from Bhashini website. (Refer Step 4)
+- pipelineId : Keep the value as given in the screenshot below - “64392f96daac500b55c543cd”
+- base_url : Keep the value as given in the screenshot below - “https://meity-auth.ulcacontrib.org/ulca/apis/v0/model/”
+- contact : Keep the value as given in the screenshot below - “@contact”
+You can read more about the variables used inside the webhook body/ Bhashini APIs [here](https://bhashini.gitbook.io/bhashini-apis/)
+
+
+
+8. Once the webhook is updated, you could always refer to the translated text as ‘@results.speech2text.asr_response_text’ to use it inside the flow.
+
+The output of the text response from the Bhashini depends on the language preference of the user. For instance if a user has selected Hindi language, the response from Glific will be in Hindi script.
+
+9. You could additionally link the webhook to a ‘Link Google Sheet’ node to record the translated text into a spreadsheet as shown in the flow below.
+
+
+
+10. The Google Sheet node is configured as shown below. The fourth variable being used is ‘@results.speech2text.asr_response_text’ which will capture the translated text in the fourth column.
+
+
+11. The incoming audio notes in this flow will be captured in Google Sheets as shown below
+
+
+## Sample Flow Links
+*Test some sample flows for yourself by importing these flows to your Glific instance.*
+
+- [Maven ASR Bhashini](https://drive.google.com/file/d/1qXxDIaP4MMDl18NsgVuhF1H8cIetJNiM/view?usp=sharing)
+- [Bhasini API](https://drive.google.com/file/d/1K-KcJ0NFDIcVN2w8E1sTnev36AEGdv5I/view?usp=sharing)
+
+## Blogs
+- [Getting started with Bhashini ASR](https://glific.org/getting-started-using-asr-with-bhashini-api/)
diff --git a/versioned_docs/version-1.0.0/4. Integrations/Bhashini ASR.md b/versioned_docs/version-1.0.0/4. Integrations/Bhashini ASR.md
new file mode 100644
index 000000000..c1e60aa0c
--- /dev/null
+++ b/versioned_docs/version-1.0.0/4. Integrations/Bhashini ASR.md
@@ -0,0 +1,78 @@
+> ### **4 minute read `Advanced`**
+
+**`Bhashini` is a project or initiative aimed at providing easy access to the Internet and digital services for all Indians in their native languages. The primary goal of the project is to increase the amount of content available in Indian languages, thereby promoting digital inclusivity and accessibility for a broader population**
+
+---
+
+## Bhashini in Glific
+- Bhashini APIs are used in Glific for speech recognition
+- Whatsapp user can share an audio file, which could be converted to text (in the language chosen by the user)
+- The converted text could be stored in Google Sheets, used in flows/ used as per the use case
+
+---
+
+## Sample Chat
+
+
+---
+
+## Steps to integrate Bhashini ASR in Glific flows
+1. Create an account in [Bhashini website](https://bhashini.gov.in/ulca/user/register#) using name & email ID. Please verify the account using the email received.
+
+
+2. Go to ‘My Profile’ on the top-right corner.
+
+
+3. Generate ‘ULCA API Key’ (top-right corner). Also make note of the User ID on top of the button. This will be used inside the webhook call in Glific flow.
+
+
+4. Make note of the API Key generated. This is required inside the webhook call used in the Glific flow for calling the Bhashini API. (Starting with 01af.. here)
+
+
+5. Now login to your Glific instance and create a flow. In this example we’ll use a flow called Maven ASR Bhashini, used for recording incoming audio queries in a Google Sheet. The flow starts with asking the user to share the query as a voice note and it is saved as ‘speech’.
+
+The download link for a few sample flows are given below to test it for yourself.
+
+
+
+6. After the audio is captured, the Bhashini ASR API is called using a Webhook function called ‘speech_to_text_with_bhasini’ and the response is stored as ‘speech2text’.
+
+- The function name is pre-defined, you should always use the name ‘speech_to_text_with_bhasini’ to call the Bhashini API
+- The response stored (speech2text here) could be given any name of your liking, just like any other flow variable
+
+
+
+7. The webhook body is shown below. Please update the parameters as shown :
+
+- speech : It should be updated with the result name given for the audio file captured. Here, it is saved as ‘speech’ (Step 5), hence the value is @results.speech.input (If the audio note captured was saved as ‘query’, then the value will be @results.query.input)
+- userID : The userID is updated with the userID captured from Bhashini website. (Refer Step 3)
+- ulcaApiKey : The API Key needs to be updated with the ULCA API key captured from Bhashini website. (Refer Step 4)
+- pipelineId : Keep the value as given in the screenshot below - “64392f96daac500b55c543cd”
+- base_url : Keep the value as given in the screenshot below - “https://meity-auth.ulcacontrib.org/ulca/apis/v0/model/”
+- contact : Keep the value as given in the screenshot below - “@contact”
+You can read more about the variables used inside the webhook body/ Bhashini APIs [here](https://bhashini.gitbook.io/bhashini-apis/)
+
+
+
+8. Once the webhook is updated, you could always refer to the translated text as ‘@results.speech2text.asr_response_text’ to use it inside the flow.
+
+The output of the text response from the Bhashini depends on the language preference of the user. For instance if a user has selected Hindi language, the response from Glific will be in Hindi script.
+
+9. You could additionally link the webhook to a ‘Link Google Sheet’ node to record the translated text into a spreadsheet as shown in the flow below.
+
+
+
+10. The Google Sheet node is configured as shown below. The fourth variable being used is ‘@results.speech2text.asr_response_text’ which will capture the translated text in the fourth column.
+
+
+11. The incoming audio notes in this flow will be captured in Google Sheets as shown below
+
+
+## Sample Flow Links
+*Test some sample flows for yourself by importing these flows to your Glific instance.*
+
+- [Maven ASR Bhashini](https://drive.google.com/file/d/1qXxDIaP4MMDl18NsgVuhF1H8cIetJNiM/view?usp=sharing)
+- [Bhasini API](https://drive.google.com/file/d/1K-KcJ0NFDIcVN2w8E1sTnev36AEGdv5I/view?usp=sharing)
+
+## Blogs
+- [Getting started with Bhashini ASR](https://glific.org/getting-started-using-asr-with-bhashini-api/)
diff --git a/versioned_docs/version-1.0.0/4. Integrations/ChatGPT Integration via Jugalbandi.md b/versioned_docs/version-1.0.0/4. Integrations/ChatGPT Integration via Jugalbandi.md
new file mode 100644
index 000000000..62f2291ae
--- /dev/null
+++ b/versioned_docs/version-1.0.0/4. Integrations/ChatGPT Integration via Jugalbandi.md
@@ -0,0 +1,94 @@
+> ### **3 minute read `Advanced`**
+
+**Leverage the capabilities of GPT models developed by OpenAI by using Jugalbandi APIs. Jugalbandi APIs is enhancing Glific by providing Retreival Augemented Generation or in simple words, enabling NGOs to use custom knowledge base for GPT models to answer from.**
+
+## Video Tutorial
+
+
+
+
+## Using ChatGPT within Glific via Jugalbandi API
+
+**Step 1:** Import the below sample flow from the Flow screen and click on the `setting` icon to configure it.
+
+**Sample Flow**
+
+[GPTintegration.json](https://storage.googleapis.com/cc-tides/GPTintegration%20(2).json)
+
+**Step 2:** Click on `Flows` from the left panel and click on the setting icon to configure the imported flow. Here's how the imported flow would look like
+
+
+
+**Step 3:** The first node is the `Send Message` node, which prompts the contact to ask question which will then be sent to ChatGPT using `Call Webhook` in `Step 6`
+
+**Step 4:** The second node is the `Wait for Response` node with the result name `gpt_query`. The response from the contact will be saved in this result and can be referenced as `@results.gpt_query`.
+
+
+
+**Step 5:** The third node is the `Send Message` which we are sending to contact while we are sending user query to ChatGPT and waiting for the response.
+
+
+
+**Step 6:** Next in the `Call Webhook` node we are calling [Jugalbandi](https://www.jugalbandi.ai/) APIs by choosing `FUNCTION` in the node and adding value as `jugalbandi`
+
+
+
+When invoking a webhook, the initial step is to select a suitable HTTP method, such as `POST`, `GET`, or `PATCH`, to perform the desired function in the interaction between the caller and the Jugalbandi API.
+
+The function is then called with three key-value pairs as the function body
+
+
+
+`url:` URL is referencing a given end point from the [Jugalbandi APIs](https://api.jugalbandi.ai/docs) some examples are given below
+
+_below is picture showing the list of end points_
+
+
+
+1. In the flow- by calling the “jugalbandi-voice” function and the above inputs in the webhook from the glific interface we can get a text response in desired language as well as a voice note. Send voice notes and get voice notes in return using the Jugalbandi API.
+
+- Prerequisites: knowledge base will have to uploaded in jugalbandi platform. [Read More](https://glific.github.io/docs/docs/Integrations/ChatGPT%20Integration/)
+- [Example flow](https://drive.google.com/file/d/1xLnLGWg_95Zhi5v0QIQpaRz_cLA9d0Er/view) (json format) which you can upload and re-use as a starting point
+
+
+Elements involved
+2. [Jugalbandi Platform](https://api.jugalbandi.ai/docs#/)
+Using Jugalbandi platform for generating voice response.
+
+
+
+
+3. Call the Glific webhook
+
+Function to use - “jugalbandi-voice”
+
+
+
+## Function Body
+
+
+
+
+“Input_language” : specify as per the jugalbandi platform or you can use the @contact.language
+“output_format” : text or voice
+“query_text” : if the input is in text format
+“audio_url” : send the flow variable of the voice note received
+“prompt” : any contextual or system prompt
+“uuid_number” : custom knowledge base which has been uploaded in the jugalbandi platform
+
+## How to get the response back and get the voice note
+- The first node in the “success” pathway is pulling the responses
+
+
+
+
+
+- The second node (screenshot below) is sending the computer generated voice note of the response.
+
+
+
+
+
+
diff --git a/versioned_docs/version-1.0.0/4. Integrations/Dialogflow for Natural Language Processing.md b/versioned_docs/version-1.0.0/4. Integrations/Dialogflow for Natural Language Processing.md
new file mode 100644
index 000000000..44bf4f607
--- /dev/null
+++ b/versioned_docs/version-1.0.0/4. Integrations/Dialogflow for Natural Language Processing.md
@@ -0,0 +1,249 @@
+> ### **6 minute read `Advanced`**
+
+**Dialog Flow can be used in flows to send responses to end-users based on their intent when a specific keyword doesn’t match.**
+
+## Video Tutorial
+
+
+
++ +## Using DialogFlow NLP agent within Glific. + +**Step 1 :** Open a GCP account, project and service account with a key (.json file). + +**Step 2 :** Connect your Glific instance with this project by adding contents of its key file as GOTH credentials for Glific. + +**Step 3 :** Open a DialogFlow Account and _create an NLP agent_ that links to the project created in Step 1. + +**Step 4 :** Create some intents within your agent. You can do so by creating an intent from scratch OR by creating a KnowledgeBase from a set of FAQs + +**Step 5 :** Create a flow in Glific that accepts a message from the user , maps it to an intent and delivers the response (as computed by the agent ) to the user. + +Below are details on each of these steps. + +**Step 1 : GCP Account and project** + +Refer to the DialogFlow Quick start guide - [https://cloud.google.com/dialogflow/es/docs/quick/setup](https://cloud.google.com/dialogflow/es/docs/quick/setup) - and execute the following steps before you configure Glific + +- Create a project +- Enable Billing +- Enable the API +- Set up Authentication (till you download the private key file.) You will use the content of this key file to set up your GOTH credentials in Glific. + +Dialog Flow can be used in flows to send responses to end-users based on their intent when a specific keyword doesn’t match. + +**Step 3 : Open your DialogFlow account and create an Dialog flow agent connected with the project from step one.** + +- Go to [https://dialogflow.cloud.google.com/](https://dialogflow.cloud.google.com/) + +- Log in with your gmail id + +- Click on " Create Agent" + +- Choose Import an existing Project (You should be able to see your project from step 1 if you are in the same browser window) + +**Step 4 : Create some intents within your Dialog flow agent.** + +1 . Create an intent + +1 . Go to Google Dialog flow [https://dialogflow.cloud.google.com/](https://dialogflow.cloud.google.com/) + +2 . Click on `Create intent`button + + + + + +3 . Enter the `name` of the intent. + + + + + +4 . Enter the `phrases` you can expect user will send to BOT. Enter one phrase and hit enter to add it in the phrases list. + + + +5 . Click on `Save` button. + + + + + +6 . It will be changed to `Done` after successful save + + + + + +7 . Click on `setting` icon on top of the screen + + + + + +8 . Click on `ML Settings` and then click on `Train` button. + + + +9 . Click on `Save` button. + + + + + +10 . After saving, click on `intents` menu. + +11 . To test type any phrase entered earlier in the `try it now` section and hit enter. + + + +12 . It will show the `intent` name matched to your phrase + + + +13 . Click on `Diagnostic info` button at the bottom of the section. It will open an `API response`. Search for **Confidence** in the text to find the confidence level of the response match to the phrase. **Confidence** level **1** is the highest level. Any thing above .75 is good matches to the phrase + + + + + +14 . Click on `Close` button. You are ready to use NLP in your flow. + +NOTE : You can also create an intent by creating a Knowledge Base. This basically is a collection of FAQs that can be split across multiple documents. + +a. Since this is a beta feature you will need to enable Beta features and API in your agent settings - under the General Tab. + +b. Once done you will be able to create a Knowledge Base. Follow the instructions to point DialogFlow to your FAQ document(s) + +c. Each knowledgebase is mapped to an auto-generated intent. You can test the knowledge base just like to test any intent. Ask a question from your FAQ and the agent should respond with corresponding answer. + +Troubleshooting tip : Added a new intent in Dialog Flow agent does not reflect in Glific split by intent dropdown ? IN settings open Dialogflow settings and just hit save without making a change. + +## Step 2 : Configure Dialog Flow in Glific to connect to your GCP Project + +1 . Click on `setting` icon. + + + + + +2 . Click on `edit` icon of Dialog flow + + + + + +3 . Enter `Goth Credentials` of your Dialog flow. It is same as it is for your GCS account. Check the "Is active" box as well. + + + +4 . Click on **Save** button + +## Give Google account Dialog flow access permissions + +Note : This is only needed if your service account doesn't have complete owner privilege. + +1 . Go to [https://console.cloud.google.com/](https://console.cloud.google.com/) + +2 . Click on `IAM` menu from left menu list. + + + + + + +3 . Click on `members` button. + + + + + +4 . Scroll down to the account you are using to link with Glific and check if user is having Dialog flow access permission. If not then click on `edit` icon next to the account permission section. + + + + + +5 . Click on `+ADD ANOTHER ROLE` link. + + + +6 . From the dropdown search and select `Dialogflow API Admin` and `Dialogflow Console Agent Editor` role. + + + + + +7 . Click on `Save` button at the bottom. + + + + + + + +## Step 5 : Create a flow in Glific that uses your DialogFlow Agent + +1 . Create a new Flow, or edit any existing flow. + +2 . Use **Wait for response** action type to receive the intent phrase input from user. + + + + + +3 . Next linked node will be `Split by intent` + + + +4 . Select Dialog flow from the 2nd drop down. + +5 . Fill the details of your intent. + +a) select `has top intent` + +b) select your **intent name** created in dialog flow. + +c) Enter the confidence level. (Enter the confidence you have got in intent to match it exactly with the phrase. or enter **.5** for now) + +d) Enter category of the intent Ex. **intent name** + +e) Enter the variable name to receive the input in `Result Name` section + + + +6 . Click `ok` to save. + + + +7 . You will get the **nlp response**, **nlp confidence** and **nlp intent** to use in your flow. syntax are + +Response: **_@results.df_intent.response_** + +Confidence: **_@results.df_intent.confidence_** + +Intent: **_@results.df_intent.intent_** + + + + + +**Flow Sample** + + + + + +**Flow Results** + +**Success case** + + + + + +**No Match found case** + + diff --git a/versioned_docs/version-1.0.0/4. Integrations/Setting up Exotel.md b/versioned_docs/version-1.0.0/4. Integrations/Setting up Exotel.md new file mode 100644 index 000000000..7c88fb369 --- /dev/null +++ b/versioned_docs/version-1.0.0/4. Integrations/Setting up Exotel.md @@ -0,0 +1,102 @@ +> ### **3 minute read `Intermediate`** +___ + +This is for you if: +- **You are struggling to acquire users for your chatbot due to challenges with users clicking the link or users not typing the keyword and want to ease the friction of them starting chatbot flows easily.** +- **You are operating your WhatsApp chatbot on Glific and have an Exotel number.** + +## Setting up on Exotel +1. After logging in, make sure you have a number for the state where you expect most calls from. + +2. Go to address book and create 2 lists – success and failure (success is for those whose missed call returned a response from Glific server successfully and failure for where it fails) + + +
+ +3. Go to App Bazaar in the menu and create a new app + +
+ +4. Proceed to Edit the app and select and drop into the selection box the component called “Passthrough” + +
+ +5. When you drop it in place, you will see a new box opening up like below. Paste the link in this format – https://api.xxx.tides.coloredcow.com/webhook/exotel/optin where xxx is your org’s name. For example: https://api.staging.tides.coloredcow.com/webhook/exotel/optin + +
+ +6. In the “In response” section, drag list manager in both boxes. Click on the list manager for “Once URL returns OK” and in the box which opens next, select the list for successful calls and in the section called “next” below, drag and drop Hangup. + +
+ +7. In the previous card, click on the list manager under the head “If the URL returns anything else” and in the box which opens, select the list for all failed calls. In the Next header, drag and drop Hangup. + +
+ +8. Select save. This completes the setup on Exotel side. +___ +## Integrating Exotel in Glific + +1. You need to be an admin to get this access. + +2. Login and go to flows and identify the flow your Exotel missed call should start. Select `Edit` to open the next screen + +
+ +3. In the URL, note down the Flow ID as highlighted. Click on `CONFIGURE` to make sure you have done the next 2 steps. + +
+ +4. Start the flow with the Card for `Update Contact.` See next step to configure it. + +
+ +5. In the drop down `Select what to update`, Select `Settings` and in the box below type “optin”. This will set the opt-in flag to true in WhatsApp. This is essential for the next step. Without this, no HSM template can be sent. + +
+ +6. Via Gupshup create a marketing template with a button. FaceBook seems to only approve marketing messages as of now – maybe it is due to the increased revenue this type of message offers. This button can be anything. The button will send a message from the user’s side after the flow has been started, so that the bot can actually send messages to the user. + +
+ +7. Map this message like this after the Optin message as shown in Steps 5 and 6 above. To create this – Select “send a message” in the dropdown, and then click on WhatsApp tab in the top right of the card and configure as show in the second image in this step – you have to select the template you just got approved in Gupshup. + + +
+ + +
+ + +8. Save the flow and go to `Settings` screen. Select `Edit` in the Exotel box as shown in the screen below. Remember, only admins can do this. + +
+ + +9. Set `is Active` to true. Enter the Glific Flow ID you noted in Step 3 above. Set direction of call to `Inbound` and write your Exotel number in the last box and save. + +
+ + +10. This completes your Exotel setup and linkage of Exotel to the bot. + + +A trick with your mobile number +1. On the mobile with your Chatbot number, activate unconditional call forwarding to the Exotel number. This way, your user can call the chatbot number and they will see their chatbot responding to them on WhatsApp. + + +___ +## Best Practices +1. Test the missed call function thoroughly. Best way to do this is to use mobiles from different carriers, and prepaid and postpaid services. +2. Monitor the “failed calls” list weekly and contact those whose missed call failed. +3. If you have a prepaid number for the chatbot, set a calendar reminder to recharge 2 days in advance. If the balance expires, and then you recharge, the call forwarding is broken. In this case, you need to disable call forwarding on your mobile to Exotel and then re-enable after 5 minutes. All missed calls in this downtime are lost. + +**Typical Costs** (this can change and is provided as an estimate for you to budget and plan expenses): +Exotel charges Missed call at Rs 0.3 +WhatsApp sends marketing template messages at Rs 0.7 + +___ +## Reference Article + +- Reap Benefit has experimented with Exotel for their onboarding. [Click Here](https://glific.org/missed-call-feature-solving-the-design-flaw-for-easy-onboarding-and-continuous-re-engagement-of-your-beneficiaries-into-your-glific-chatbot/) to read more. + diff --git a/versioned_docs/version-1.0.0/4. Integrations/_category_.json b/versioned_docs/version-1.0.0/4. Integrations/_category_.json new file mode 100644 index 000000000..436611c29 --- /dev/null +++ b/versioned_docs/version-1.0.0/4. Integrations/_category_.json @@ -0,0 +1,5 @@ +{ + "link": { + "type": "generated-index" + } +} \ No newline at end of file diff --git a/versioned_docs/version-1.0.0/6. FAQ/01. Find opt-in link of our NGO.md b/versioned_docs/version-1.0.0/6. FAQ/01. Find opt-in link of our NGO.md new file mode 100644 index 000000000..26a9e241d --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/01. Find opt-in link of our NGO.md @@ -0,0 +1,9 @@ +1. Login to your Gupshup account from [https://www.gupshup.io/developer/home](https://www.gupshup.io/developer/home) +1. Go to the WhatsApp dashboard [https://www.gupshup.io/whatsappassistant/#/whatsapp-dashboard](https://www.gupshup.io/whatsappassistant/#/whatsapp-dashboard) +1. Click on settings icon of your App. + + + +1. Clink on the copy link under `Click URL` option to copy your opt-in link. + + diff --git a/versioned_docs/version-1.0.0/6. FAQ/02. Check if contact is not opted in.md b/versioned_docs/version-1.0.0/6. FAQ/02. Check if contact is not opted in.md new file mode 100644 index 000000000..af62989ba --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/02. Check if contact is not opted in.md @@ -0,0 +1,3 @@ +Check if there is stop icon in the contact messages. If it is there, contact is has not opted in, please ask contact to send **optin** keyword to the BOT. + + diff --git a/versioned_docs/version-1.0.0/6. FAQ/03. Check if user is opted-in in the flow.md b/versioned_docs/version-1.0.0/6. FAQ/03. Check if user is opted-in in the flow.md new file mode 100644 index 000000000..995d515de --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/03. Check if user is opted-in in the flow.md @@ -0,0 +1,13 @@ +You can use variable `@contact.optin_status` to check. It will return **True** if user is opted it otherwise return False. + + + + + +Use it in `split by expression` to make decision, if user is opted in or not. + +`<%= if @contact.optin_status == true, do: 1, else: 2%>` + + + + diff --git a/versioned_docs/version-1.0.0/6. FAQ/04. Change admin in our FB business account.md b/versioned_docs/version-1.0.0/6. FAQ/04. Change admin in our FB business account.md new file mode 100644 index 000000000..fea851971 --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/04. Change admin in our FB business account.md @@ -0,0 +1 @@ +Refer this article [Change access and permissions for a business account](https://www.facebook.com/business/help/299504287548592) \ No newline at end of file diff --git a/versioned_docs/version-1.0.0/6. FAQ/05. Update my profile picture of BOT.md b/versioned_docs/version-1.0.0/6. FAQ/05. Update my profile picture of BOT.md new file mode 100644 index 000000000..64e49d32c --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/05. Update my profile picture of BOT.md @@ -0,0 +1,3 @@ +You can update the profile picture of your BOT account of WhatsApp from Gupshup settings page. - **_Go to Home >>Dashboard >> Profile settings._** + +_Refer_ [_GupShup article_](https://support.gupshup.io/hc/en-us/articles/360011977580-How-to-change-my-business-display-picture-) _for more details_ diff --git a/versioned_docs/version-1.0.0/6. FAQ/06. Make sure flow is not interrupted if contact sends any keyword in between the flow..md b/versioned_docs/version-1.0.0/6. FAQ/06. Make sure flow is not interrupted if contact sends any keyword in between the flow..md new file mode 100644 index 000000000..177a75e74 --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/06. Make sure flow is not interrupted if contact sends any keyword in between the flow..md @@ -0,0 +1,5 @@ +Select the **Ignore Keyword** check box from edit flow screen to make sure the flow should not be interrupted in between if user sends keyword of another flow. + + + + diff --git a/versioned_docs/version-1.0.0/6. FAQ/08. Make a flow inactive.md b/versioned_docs/version-1.0.0/6. FAQ/08. Make a flow inactive.md new file mode 100644 index 000000000..12cd5ecf3 --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/08. Make a flow inactive.md @@ -0,0 +1,15 @@ +**You can inactivate a flow, which is not in use. This will prevent the flow from executing if a user enters keyword mapped to it.** + +1 . Go to the `Flows` screen. + +2 . Click on `Edit` icon next to the flow. + + + + + +3 . Uncheck the `is active` check box. + +4 . Click on `SAVE` button + + diff --git a/versioned_docs/version-1.0.0/6. FAQ/12. Format the text in messages..md b/versioned_docs/version-1.0.0/6. FAQ/12. Format the text in messages..md new file mode 100644 index 000000000..3d5ef1137 --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/12. Format the text in messages..md @@ -0,0 +1,25 @@ +Basic WhatsApp text formatting option are available in flow editor. Refer [this article](https://faq.whatsapp.com/general/chats/how-to-format-your-messages/?lang=en) for more details + +## Text Formatting + +1 . User ***** to make the text bold. - ***Bold*** + +2 . User **_** to make the text italic. **_Italic_** + +3 **** . **** User **~** to strikethrough the text .**~strikethrough~** + +4 . Use **'''** for monospace- **'''monospace'''** + + + + + +## Add Emojis + +Generally, all browser provide Emojis extension. Once you have added the extension, you can add emojis with right click in the text editor of message. + +Below example is from chrome. + + + + diff --git a/versioned_docs/version-1.0.0/6. FAQ/13. Send a link of a specific flow to new contacts to join the BOT.md b/versioned_docs/version-1.0.0/6. FAQ/13. Send a link of a specific flow to new contacts to join the BOT.md new file mode 100644 index 000000000..79dc03b35 --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/13. Send a link of a specific flow to new contacts to join the BOT.md @@ -0,0 +1,28 @@ +You can configure a link like below and send to the contacts through SMS or emails. + +Once they will click on the link, it will redirect them to a WhatsApp with the message, which they can send to start the conversation. + + + +Method 1 : Commonly used to onboard existing users to chatbot. + +[https://wa.me/+91<10 digit bot phone number>?text=](https://wa.me/+917772309999?text=Hi)<text you want user to send> + +Eg: A URL like the one below can be used to trigger your new contact flow with optin. [https://wa.me/+91<your bot phone number>?text=Hi](https://wa.me/+917772309999?text=Hi) + +Whatsapp documentation for the same : [https://faq.whatsapp.com/452366545421244/?helpref=uf_share](https://faq.whatsapp.com/452366545421244/?helpref=uf_share) + +Method 2: + +https://api.whatsapp.com/send?phone=**BOTNumber**&text=**Message** + +- **https://api.whatsapp.com/send?phone=** - link prefix +- **Your BOT Number** - Ex. 917302307943 +- **text=** - fixed content of the link +- **Message** - This will be message which will be posted on the WhatsApp. Ex. Hi + +[https://api.whatsapp.com/send?phone=917302307943&text=Hi%20Glific%20team](https://api.whatsapp.com/send?phone=917302307943&text=Hi%20Glific%20team) + +Message will look as given below for contacts in WhatsApp + + diff --git a/versioned_docs/version-1.0.0/6. FAQ/14. Get upload attachment option in Send message.md b/versioned_docs/version-1.0.0/6. FAQ/14. Get upload attachment option in Send message.md new file mode 100644 index 000000000..dc858b890 --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/14. Get upload attachment option in Send message.md @@ -0,0 +1,11 @@ +To get **upload attachment** option, one needs to setup GCS and make it active in Glific. + +### **Upload Attachment** + + + + + +### **Activate GCS in Glific** + + diff --git a/versioned_docs/version-1.0.0/6. FAQ/15. Give permissions to individuals in Google Cloud Storage GCS.md b/versioned_docs/version-1.0.0/6. FAQ/15. Give permissions to individuals in Google Cloud Storage GCS.md new file mode 100644 index 000000000..fa25f8674 --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/15. Give permissions to individuals in Google Cloud Storage GCS.md @@ -0,0 +1,33 @@ +1 . Go to google console ([https://console.cloud.google.com](https://console.cloud.google.com/home/dashboard?project=tides-saas-309509)). + +2 . From top click on 3 lines icon next to Google Cloud Platform + +3 . From left panel mouse over on `IAM & Admin` menu item. + + + + + +4 . It will open a sub menu. Click on `IAM` sub menu item. + + + + + +5 . Permission page will open up. Click on `Add` link from top of the page. + + + + + + + +6 . In `New principals` filed, type the `email id`of the person to whom you need to give the permissions. + + + +7 . Click on `Roles` field dropdown and type `owner` and select it from the options given in the dropdown. You can select any other roles (Browser, editor, viewer) for the person based on your requirement. + + + +8 . Click on `Save` button to give the permissions. The user will receive an email with the access link and accept the permission. diff --git a/versioned_docs/version-1.0.0/6. FAQ/16. Add bulk contacts to my Glific account.md b/versioned_docs/version-1.0.0/6. FAQ/16. Add bulk contacts to my Glific account.md new file mode 100644 index 000000000..c04dbafb9 --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/16. Add bulk contacts to my Glific account.md @@ -0,0 +1,25 @@ +# + +Currently in Glific, the bulk contact uploads can only be performed by the Glific Tech team. NGOs can use the discord channel or any other communication medium to share the required details with the team. The team requires all the list of contacts with specific details in an Excel format sheet. Once the required sheet is available it takes 24hrs or less to add them to the NGOs Glific account. + +## File Format + +Here is a sample [Excel format](https://docs.google.com/spreadsheets/d/1YZQgn2epiRWNqzDjow5EoR14YxCg_KV2hQKrUJvOfz4/edit#gid=0) that NGO needs to provide to the Glific team for bulk contacts onboarding. + + + +## + +## Sharing the details for the column below: + + + +**Name:** It should contain the name of the beneficiary. This is a mandatory field for the onboarding process and it also makes sure that the organization knows their contacts and doesn't perform any spamming activity. + +**Phone (WhatsApp number):** It should contain the active WhatsApp number of the beneficiary from which they will send or receive the messages. + +_Please make sure to add the_ **_country code_** _to the number. For example 91 for India based contact_ + +**Optin:** It should contain the DateTime string of when you have taken permission from the user to send them a message. This is a mandatory field and it ensures that NGOs have taken permission from their beneficiaries to communicate with them through WhatsApp. + +**_Note:_** _WhatsApp policy is very strict about this and if the users started blocking the numbers on WhatsApp, as per the policy WhatsApp will connect with NGOs for the consent details and also might ban the business number for a lifetime._ diff --git a/versioned_docs/version-1.0.0/6. FAQ/17. Add the display Name of the BOT number and show it to end-users.md b/versioned_docs/version-1.0.0/6. FAQ/17. Add the display Name of the BOT number and show it to end-users.md new file mode 100644 index 000000000..ccb85b11c --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/17. Add the display Name of the BOT number and show it to end-users.md @@ -0,0 +1,11 @@ +# Display Name, Picture & Guidelines for ChatBot + +- [Add Display Picture](https://support.gupshup.io/hc/en-us/articles/360011977580-How-to-change-display-picture-) + +- [Add Display Name](https://support.gupshup.io/hc/en-us/articles/360011977600-Why-is-a-Display-name-required-) + +- [Display Name Guidelines](https://developers.facebook.com/docs/whatsapp/overview/display-name) + +- [Showing Display Name to end-users](https://support.gupshup.io/hc/en-us/articles/360012076019-How-to-get-a-verified-tick-How-will-my-display-name-show-to-end-users-) + +- [Get Verified Green Tick](https://support.gupshup.io/hc/en-us/articles/360012076019-How-to-get-a-verified-tick-How-will-my-display-name-show-to-end-users-) diff --git a/versioned_docs/version-1.0.0/6. FAQ/18. Create a flow to capture multiple answers for a single question.md b/versioned_docs/version-1.0.0/6. FAQ/18. Create a flow to capture multiple answers for a single question.md new file mode 100644 index 000000000..3736db453 --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/18. Create a flow to capture multiple answers for a single question.md @@ -0,0 +1,45 @@ +While creating a program you might have a requirement to capture multiple answers for a single question. This requirement doesn't work with interactive messages but you can still use regular text to accomplish this. + + + +For multiple answers, it's always better to add a note and an input example that will help users to know how to answer in the correct way. For example, + + + + + +And the Wait For Response can be something like this + + + + + +Your message flow will look something like this + + + + + + + +## For Conditional Flow + + + +If you want to create a conditional flow with multiple answers, you can create your program like this. + + + + + + + +You can set the Wait For Response like this, + + + + + +Your message flow will look like this + + diff --git a/versioned_docs/version-1.0.0/6. FAQ/19. Check WhatsApp Quality Rating and Messaging Limits.md b/versioned_docs/version-1.0.0/6. FAQ/19. Check WhatsApp Quality Rating and Messaging Limits.md new file mode 100644 index 000000000..659bb82a9 --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/19. Check WhatsApp Quality Rating and Messaging Limits.md @@ -0,0 +1,69 @@ +## Check Whatsapp Messaging limits + +Messaging limits determine the maximum number of business-initiated conversations you can initiate using each of your phone numbers in a rolling 24-hour period. A business-initiated conversation begins when the first template message is delivered to a customer and ends 24 hours later. + +The phone number tier of your WhatsApp API account will determine your messaging limit - the number of Contacts an account can message. + + +There are five tiers a phone number inside a WABA can reach, including: + +_**Unverified Trial Tier**_: Send messages to 50 unique Contacts in a rolling 24-hour period. + +_**Tier 1**_: Send template messages to 1K Contacts in a rolling 24-hour period. + +_**Tier 2**_: Send template messages to 10K unique Contacts in a rolling 24-hour period + +_**Tier 3**_: Send template messages to 100K Contacts in a rolling 24-hour period + +_**Tier 4**_: Send template messages to unlimited unique Contacts in a rolling 24-hour period + + +If a sender has initiated X or more conversations with unique customers(where X is your current messaging limit divided by 2) in the last 7days, then the tier will be up by 1 level. For example- If you are in tier 1 and send 500 business conversations to unique users in 7days, you would be moved from Tier1 to Tier2. + + +**Example 1**: A WhatsApp Sender begins by being able to initiate business conversations to 1000 unique customers per day. On day 1, the Sender starts 500 business conversations to unique customers by 3pm. The message limit for the Sender is raised to 10,000 unique customers by day 2 at 3pm. + +**Example 2**: A WhatsApp Sender begins by being able to initiate business conversations to 1000 unique customers per day. On day 1, the Sender starts 100 business conversations to unique customers. On day 2, the Sender starts another 300 business conversations to unique customers. On day 3, the Sender starts another 100 business conversations to unique customers by 3pm. This brings the total number of unique business conversations in the last 7 days to 500. The message limit for the Sender is raised to 10,000 unique customers by day 4 at 3pm. + + +## Quality Rating + +Your quality rating is based on how messages have been received by recipients over the past seven days and is weighted by recency. It is determined by a combination of quality signals from conversations between businesses and users. Examples include user feedback signals like blocks, reports and the reasons users provide when they block a business. + + +**Maintaining High Quality** +* Make sure messages follow the Whatsapp Businnes Policy (https://www.whatsapp.com/legal/business-policy/) and Commerce Policy ( https://www.whatsapp.com/legal/commerce-policy/). +* Only send messages to users who have opted into receiving messages from your business. +* Make the messages highly personalized and useful to users. Avoid sending open-ended welcome or introductory messages. +* Be mindful of messaging frequency; avoid sending customers too many messages a day. Be thoughtful of informational messages, optimizing for content and length. + + +**Please refer the following link for more information :** + + https://developers.facebook.com/docs/whatsapp/messaging-limits/ + + + +## How to check how many HSM template messages are sent from BOT. + +1 . Login to Gupshup [https://www.gupshup.io](https://www.gupshup.io/developer/home) + +2 . From the `Dashboard` dropdown click on the `My Wallet` link + + + + + +3 . Click on `View Usage` button + + + + + +4 . Under the `Messages breakup` section, check the `Template Sent`and `Template Media` details. + + + +5 . To filter the results use `Filter by App` and `month` dropdown. You can also download the report from `Download report` the button. + + diff --git a/versioned_docs/version-1.0.0/6. FAQ/20. Read Receipts.md b/versioned_docs/version-1.0.0/6. FAQ/20. Read Receipts.md new file mode 100644 index 000000000..b2a651fa9 --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/20. Read Receipts.md @@ -0,0 +1,25 @@ +The read receipts data is important for tracking user engagement. It lets you categorize the status of different messages you've sent into `Sent`, `Delivered`, `Read (blue tick)`etc + +## Steps to configure read receipts in the Gupshup account. + + + +1 . Log in to your Gupshp account. + + + + +2 . Click on the settings icon on your app. + + + +3. Scroll down to the `Message Events` section and active all the checkboxes. + + + +- Once you configure Gupshup, you will be able to see the status (delivered, read, sent etc) in the column name `bsp_status` of `Messages table` in BigQuery. + + + + +- You can add this table in your dashboards to create a Funnel Chart which will help you with more insights on the different drop-off areas/ leakages in your flow. This helps you understand your flow using data & helps you tweak it to enhance engagement. diff --git a/versioned_docs/version-1.0.0/6. FAQ/21. Find the QR Code of BOT for opt-in contacts..md b/versioned_docs/version-1.0.0/6. FAQ/21. Find the QR Code of BOT for opt-in contacts..md new file mode 100644 index 000000000..1900abc1c --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/21. Find the QR Code of BOT for opt-in contacts..md @@ -0,0 +1,23 @@ +1. Login to your Gupshup account + + + + + + + +2. Click on the `settings` icon for your app + + + + + +3. Click on Down arrow for `Onboarding machanisums`. + + + + + +4. Scoll down `Smart mechanisms to get active and opted in users` section to get the QR code + + diff --git a/versioned_docs/version-1.0.0/6. FAQ/22. Gupshup wallet balance and Usage.md b/versioned_docs/version-1.0.0/6. FAQ/22. Gupshup wallet balance and Usage.md new file mode 100644 index 000000000..53b2cd9e7 --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/22. Gupshup wallet balance and Usage.md @@ -0,0 +1,55 @@ +## Recharge Gupshup Walltet + +Steps to recharge your Gupshup wallet account. + +1 . Log in to your Gupshp account. + + + +2 . After login from the `dashboard` dropdown lick on `My Wallet` + + + + + +3 . `My Wallet & Usage` the page will open up. Click on `Add Balance`and pay it from your credit card. + + + + + +2 . Update your `billing address`. + + + + + +3 . Pay with your credit card. + + + + + +## Check Coversation usage + +1 . On `My Wallet & Usage` page, click on `View Usage` button. + + + + + +2 . Click on the `WhatsApp` tab. + + + + + +3 . Select the `month` from the dropdown you want to see the usage. Click on `Download Report` the button to download. + + + + + +or scroll down to see the usage on the web page. + + diff --git a/versioned_docs/version-1.0.0/6. FAQ/23. Update collection with bulk contacts or contact fields.md b/versioned_docs/version-1.0.0/6. FAQ/23. Update collection with bulk contacts or contact fields.md new file mode 100644 index 000000000..25a7b5d6e --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/23. Update collection with bulk contacts or contact fields.md @@ -0,0 +1,37 @@ +1 . Login to Glific + +2 . From left bottom corner click on `Contact management` link + + + + + + + +3 . From **Contact management** page click on `Download sample file` link. + + + + + +4 . Enter the details in the given sample data in excel and save it as .csv file. Enter the name of the collections in `collection` column comma separated in which you want to move the contacts. + + + +For **Contact filed addition** please use the below .csv file format. + + + +[contact_fields_csv.csv](https://slabstatic.com/prod/uploads/8k89m6if/posts/attachments/APignKgSOPLIqMEf1hrK0L62.csv) + + + +5 . Click on `select file` button and select the saved .csv file. + +6 . Click on `Upload`button to process the file. + + + + + +7 . Verify the contacts are moved into a collection. diff --git a/versioned_docs/version-1.0.0/6. FAQ/24. Get a data of a particular flow from BigQuery.md b/versioned_docs/version-1.0.0/6. FAQ/24. Get a data of a particular flow from BigQuery.md new file mode 100644 index 000000000..5e7955955 --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/24. Get a data of a particular flow from BigQuery.md @@ -0,0 +1,8 @@ +- Login to your Google account https://console.cloud.google.com/ +- Click on Big Query Tab +- Click on small trangle next to your project ID +- Click on small trangle next to the your BOT number +- Click on any of the table. +- In the right pane clikc on Query Tab in the Split tab +- Write the below query to get the results of a single flow +- **SELECT * FROM `your_dataset.messages` where flow_name = `flow_name` order by inserted_at DESC** diff --git a/versioned_docs/version-1.0.0/6. FAQ/25. Get WABA ID.md b/versioned_docs/version-1.0.0/6. FAQ/25. Get WABA ID.md new file mode 100644 index 000000000..87c464d0d --- /dev/null +++ b/versioned_docs/version-1.0.0/6. FAQ/25. Get WABA ID.md @@ -0,0 +1,9 @@ +1. Login to your Gupshup account. + +2. Click on Dashbaord + +3. CLick on Settings tab + +4. Check the waba ID under APP type + +
diff --git a/versioned_docs/version-1.0.0/6. FAQ/26. How to get Green Tick in Whatsapp Business.md b/versioned_docs/version-1.0.0/6. FAQ/26. How to get Green Tick in Whatsapp Business.md
new file mode 100644
index 000000000..cf3ef2755
--- /dev/null
+++ b/versioned_docs/version-1.0.0/6. FAQ/26. How to get Green Tick in Whatsapp Business.md
@@ -0,0 +1,26 @@
+By displaying the green tick badge, WhatsApp enables users to swiftly spot official brand accounts on the platform. This badge confirms the account's authenticity as it is WhatsApp-verified, assuring users that it genuinely represents the claimed company.
+
+## Steps
+
+1. **Comply with WhatsApp Guidelines**: Review WhatsApp's Business Policy and API Terms of Service to ensure that your account and business operations comply with their guidelines and policies.
+
+2. **Provide Business Information**: Make sure that your business information is accurate and up-to-date in your WhatsApp Business API account. This includes your business name, address, phone number, and a brief description of your business.
+
+3. **Verify Your Business**: WhatsApp may require additional verification to ensure the authenticity and legitimacy of your business. The verification process may involve submitting official documents or going through a review process.
+
+4. **Contact WhatsApp Support**: Reach out to WhatsApp support or your WhatsApp Business Solution Provider (BSP) to inquire about the green tick verification process for your WhatsApp Business API account.
+
+5. **Follow Instructions**: WhatsApp support or your BSP will provide you with specific instructions on how to proceed with the verification process. This may include providing documentation, going through a verification call or fulfilling other requirements.
+
+6. **Wait for Verification**: Be patient during the verification process, as it may take some time for WhatsApp to review your account and complete the verification.
+
+7. **Receive the Green Tick Verification**: If your WhatsApp Business API account meets the verification criteria and is approved, it will receive a green tick badge, indicating that it is a verified business account.
+
+8. **Maintain Compliance**: After receiving the green tick verification, continue to adhere to WhatsApp's Business Policy and API Terms of Service to retain the verification status.
+
+## Reference Article
+
+- [How will my Display Name show to end-users?](https://support.gupshup.io/hc/en-us/articles/360012076019-How-to-get-a-verified-tick-How-will-my-display-name-show-to-end-users-)
+
+- [How to apply for Whatsapp Green Tick Verification](https://www.wati.io/blog/whatsapp-green-tick-verification/)
+
diff --git a/versioned_docs/version-1.0.0/6. FAQ/27. Using Glific APIs for OTP Authentication.md b/versioned_docs/version-1.0.0/6. FAQ/27. Using Glific APIs for OTP Authentication.md
new file mode 100644
index 000000000..3d4951ec0
--- /dev/null
+++ b/versioned_docs/version-1.0.0/6. FAQ/27. Using Glific APIs for OTP Authentication.md
@@ -0,0 +1,19 @@
+## Prerequisites:
+
+- [WhatsApp Session Time](https://www.twilio.com/docs/whatsapp/key-concepts#the-24-hour-window-or-24-hour-session)
+- [WhatsApp Templates](https://www.twilio.com/docs/whatsapp/key-concepts#whatsapp-templates-are-required-for-notifications)
+- [User opt-in](https://developers.facebook.com/docs/whatsapp/overview/getting-opt-in/)
+
+## Steps:
+
+1. Apply for an OTP template in Glific if not already present. Get the ID of the template from the URL. Will be used later to send the message.
+
+
+2. Check if the contact is present on Glific using the [ContactByPhone API](https://api.glific.com/#bfc8d05b-c5a4-45d2-9874-e9db9727678c).
+
+
+3. If the contact is present and the bspStatus of the contact is not null then you can send an OTP template message using [createAndSendMessage API](https://api.glific.com/#c09fbc20-193d-4c36-a927-e2c30c4cc14a). Also you can check other fields like collections and fields of the contact using the API in point no 2.
+If the contact is not present on Glific then you need to
+Create a contact using [createContact API](https://api.glific.com/#4573b3d2-5def-4475-bb94-368b9fa83bbf)
+Optin the contact using [optin API](https://api.glific.com/#73271fe4-ce79-4975-9048-92d6036c2ba4) provided you have taken consent from the user in any form
+Send the OTP template using the API mentioned in point 3
diff --git a/versioned_docs/version-1.0.0/6. FAQ/28. Get Glific Support.md b/versioned_docs/version-1.0.0/6. FAQ/28. Get Glific Support.md
new file mode 100644
index 000000000..3fa4fe162
--- /dev/null
+++ b/versioned_docs/version-1.0.0/6. FAQ/28. Get Glific Support.md
@@ -0,0 +1,54 @@
+If you have a query or you facing any issue while using Glific. Please don't wait and take help from Glific team.
+
+Steps to follow to take support.
+
+## Glific Doucmentation
+ 1. From the left navigation click on help link.
+ 2. It will open a documentation link http://docs.glific.org/
+ 3. From right top corner click on the search box
+ +There are three ways to use WhatsApp, a basic app which we generally use to talk to our friends and family. WhatsApp business is meant for small businesses for small scale interactions with customers and allows basic automations like greeting and away messages. The third one is WhatsApp Business API which is meant for large scale two-way communication and it empowers businesses to do a lot more such as automate any amount of conversations, generate insights from it, schedule messages, send messages with buttons and a lot more - see here. WhatsApp Business API powers the WhatsApp based chatbots. When using WhatsApp chatbot, while end-users use their WhatsApp application, businesses log onto a different interface. +
+2. **Conversation Types**
+Whenever a user messages the chatbot, businesses have 24-hrs to respond to their query (this is where chatbot helps). If the 24-hrs window closes, businesses can nudge the users to re-initiate conversation with a pre-approved template message only. To send messages outside of 24-hrs, businesses also need to get users to opt-in(or subscribe) to their number. If the contacts are not opted in and the window has closed, then you can only interact with them when they message you. +
+3. **Conversation Costs**
+With WhatsApp chatbot businesses have to incur costs to talk to their end-user, read in detail here. In addition to this, there’s also platform costs where the chatbot runs. +
+4. **Chatbot Phone Number**
+You can use any kind of phone number that is active - either a special number or any regular number works, it can also be a virtual or a landline number. You only need the number on the mobile phone during the initial set up phases for OTP verifications. You must not link the chatbot number with any WhatsApp or WhatsApp business application. It gets linked with WhatsApp business API when you set up the chatbot. +
+5. **Constraints & Features**
+ a. **Optins:** Businesses must get end-users to initiate the first conversation and get them to explicitly mark that they are okay with receiving WhatsApp messages from your organization. This process can happen through forms, redirecting users from your Facebook page, or getting them to optin directly on whatsapp when they send you the first message (at Glific we enable you to do it easily on WhatsApp).
+ b. **No Groups:** WhatsApp business API doesn’t support groups functionality. You can only talk to your end-users in a 1-to-1 manner. You can broadcast messages to a large number of contacts but the conversation will be 1-to-1. +
+ + - Message Approvals: When sending messages outside of to opted-in users, you need to follow the guidelines set by WhatsApp and get your message approved by them. These messages are called HSM templates. Within 24-hrs you can send any message without approval.
+6. **Messaging Limits**
+ When you start your chatbot program, you can get as many end-users to send you a message as you want, but while sending a nudge message(HSM template) you can only send to 1000 contacts to begin with. When you messages to 2000 unique-contacts within a 7-days period, your messaging limit increases to 10,000 and similarly to 1,00,000. +
+7. **Facebook Business Manager Verification**
+ The most critical step to getting access to WhatsApp business API and starting your chatbot is to get your business verified from Meta. Your business should be registered, it should have a facebook page and a website. Read more here to know the complete process. + +___ + +## Quick Links +- Product Information + - [Glific Two Pager](https://drive.google.com/file/d/1jWlB4wh8ZsUVlQf4xZ3UOVUkmG5QgQYx/view?usp=sharing) (What you can do with Glific) + - [Product Video](https://www.youtube.com/watch?v=r6pI3YnINws) (5 min product overview video) + - [Detailed Product Demo](https://www.youtube.com/watch?v=EO-W0cFy_i8) (Deep dive into the Product) + - [Dashboard](https://datastudio.google.com/reporting/fdc97942-72e5-4d7d-92c4-4a4c7da9be86/page/p_t8287rtztc) (Sample) + - [Tutorial Videos](https://www.youtube.com/channel/UCIJfQhrbJSCWQtzdI484nng/playlists) + - [FAQ](https://chintugudiya.org/glific-faqs/) + - [Onboarding Support Docs](https://glific.github.io/docs/docs/category/onboarding/) + - [Platform Pricing](https://tides.coloredcow.com/pricing) +- [Case Studies](https://glific.org/tag/case-study/) (What other NGOs have done) + - [Arogya World](https://glific.org/influencing-healthy-behaviours-on-whatsapp-through-ai-driven-nudges/) + - [Digital Green](https://glific.org/reaching-farmers-directly-scaling-reach-reducing-time-to-get-analytics-from-months-to-seconds/) + - [The Apprentice Project](https://glific.org/activities-quizzes-gamification-taps-education-program-on-whatsapp/) + - [Reap Benefit](https://glific.org/reap-benefit-glific-google-sheets-makes-a-great-chatbot-to-help-covid-affected-families/) + - [TAP](https://glific.org/activities-quizzes-gamification-taps-education-program-on-whatsapp/) + - [Antarang](https://glific.org/antarang-foundation-ab-tests-their-user-registration-process-using-the-split-randomly-node/) + - For more visit our [Blogs](https://glific.org/blogs/) + +- VodCast + - [TAP](https://www.youtube.com/watch?v=ixAF0XX9DRs) + - [Quest Alliance](https://www.youtube.com/watch?v=7tTLozX0fKE) + - [Arogya World](https://www.youtube.com/watch?v=nraet2442a0) + - [LAHI](https://www.youtube.com/watch?v=XsGIAYY4RVg) + - [VOPA](https://www.youtube.com/watch?v=Mv8H_6fbAlg) + - [STiR Education](https://www.youtube.com/watch?v=_LUuNTgIiPQ) + - [Antarang](https://www.youtube.com/watch?v=pqCb5SYcWzk) + - [Mukkamaar](https://www.youtube.com/watch?v=GyCONkQ1-vI) + - [Digital Green](https://www.youtube.com/watch?v=5leX9Wp53cw) + - [The Apprentice Project](https://www.youtube.com/watch?v=6n7jnEWByLo) + - [Dhwani RIS](https://www.youtube.com/watch?v=u4iyoDAezck) + +- Please checkout our [Discord Community](https://discord.gg/cHnTF9x) if you'd like to see our support channel and interact with any of the NGO partners. + diff --git a/versioned_sidebars/version-1.0.0-sidebars.json b/versioned_sidebars/version-1.0.0-sidebars.json new file mode 100644 index 000000000..b5e714fc4 --- /dev/null +++ b/versioned_sidebars/version-1.0.0-sidebars.json @@ -0,0 +1,13 @@ +{ + "tutorialSidebar": [ + { + "type": "autogenerated", + "dirName": "." + }, + { + "type": "link", + "label": "Join Discord Community", + "href": "https://discord.gg/BP8WCy8sZf" + } + ] +} diff --git a/versions.json b/versions.json new file mode 100644 index 000000000..5e1abcd8a --- /dev/null +++ b/versions.json @@ -0,0 +1,3 @@ +[ + "1.0.0" +]