From 9187c458f8b16f84911a8d68b31ea39bf48cce4a Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:23:19 +0530 Subject: [PATCH 01/25] Delete docs/5. Integrations/Dialogflow for Natural Language Processing.md --- ...logflow for Natural Language Processing.md | 245 ------------------ 1 file changed, 245 deletions(-) delete mode 100644 docs/5. Integrations/Dialogflow for Natural Language Processing.md diff --git a/docs/5. Integrations/Dialogflow for Natural Language Processing.md b/docs/5. Integrations/Dialogflow for Natural Language Processing.md deleted file mode 100644 index c4639cd48..000000000 --- a/docs/5. Integrations/Dialogflow for Natural Language Processing.md +++ /dev/null @@ -1,245 +0,0 @@ -> ### **6 minutes 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 - - - -
- -_The UI of the platform has been updated since the webinar was conducted. The functionalities shown all remain the same_ - -## 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 - -![image](https://user-images.githubusercontent.com/32592458/212662142-af6ce124-9d8a-4c63-a6a6-7749a0189e21.png) - - - -3 . Enter the `name` of the intent. - -![image](https://user-images.githubusercontent.com/32592458/212662172-7a471ced-f64d-472b-b367-7c8e381ba16b.png) - - - -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. - -![image](https://user-images.githubusercontent.com/32592458/212662208-500f69f1-4899-4226-9e98-0a85e96f8cd2.png) - -5 . Click on `Save` button. - -![image](https://user-images.githubusercontent.com/32592458/212662375-6351b60a-233e-47f1-8abd-9bf8bddf4374.png) - - - -6 . It will be changed to `Done` after successful save - -![image](https://user-images.githubusercontent.com/32592458/212662399-b0f8064e-af64-4e76-8beb-f23f64939ee7.png) - - - -7 . Click on `setting` icon on top of the screen - -![image](https://user-images.githubusercontent.com/32592458/212662419-dd2bb531-cd79-4855-a91a-638c3478a2dc.png) - - - -8 . Click on `ML Settings` and then click on `Train` button. - -![image](https://user-images.githubusercontent.com/32592458/212662443-3f0340b2-868a-493d-ad6e-15a618d27507.png) - -9 . Click on `Save` button. - -![image](https://user-images.githubusercontent.com/32592458/212662478-eb77daee-ba1d-4e43-bcec-a1758bbd0cb5.png) - - - -10 . After saving, click on `intents` menu. - -11 . To test type any phrase entered earlier in the `try it now` section and hit enter. - -![image](https://user-images.githubusercontent.com/32592458/212662511-1aeedc29-328b-4336-b031-6e17cbc3c42d.png) - -12 . It will show the `intent` name matched to your phrase - -![image](https://user-images.githubusercontent.com/32592458/212662537-a3bcc33b-d364-44ab-b8e3-f4bf7fb57993.png) - -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 - -![image](https://user-images.githubusercontent.com/32592458/212662560-bb9b4b7b-6984-45b2-9b83-319102fe82e0.png) - - - -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 `NGO main account`, find `Settings` and go to `Dialogflow`. - -Screenshot 2024-03-04 at 3 11 54 PM - - - -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. - -Screenshot 2024-03-04 at 3 12 39 PM - -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. - -![image](https://user-images.githubusercontent.com/32592458/212662736-ad4a830c-e91e-4395-a8b5-4b9098bf811a.png) - - - -3 . Click on `members` button. - -![image](https://user-images.githubusercontent.com/32592458/212662771-c0a57b1e-bb61-4f3e-ba31-ca5822c62b5e.png) - - - -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. - -![image](https://user-images.githubusercontent.com/32592458/212662810-736cb0d7-75f0-45bf-8e42-4f01cce5feb2.png) - - - -5 . Click on `+ADD ANOTHER ROLE` link. - - - -6 . From the dropdown search and select `Dialogflow API Admin` and `Dialogflow Console Agent Editor` role. - -![image](https://user-images.githubusercontent.com/32592458/212662843-3db1b51a-48c6-4d96-bf71-7b67d675d034.png) - - - -7 . Click on `Save` button at the bottom. - -![image](https://user-images.githubusercontent.com/32592458/212662874-fbf6bd44-349b-4964-a50a-c5cb025c73ea.png) - - - - - -## 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. - -![image](https://user-images.githubusercontent.com/32592458/212662895-1d90e9f5-42c6-4f30-be85-096e2ec49710.png) - - - -3 . Next linked node will be `Split by intent` - -![image](https://user-images.githubusercontent.com/32592458/212662937-f7ca433b-b85d-4a35-a81b-2f52800f7913.png) - -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 - -![image](https://user-images.githubusercontent.com/32592458/212663016-95e4d7c8-2ac5-44fb-9cc1-121717375daf.png) - -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_** - - - -![image](https://user-images.githubusercontent.com/32592458/212663042-68f1fa3b-9c24-4bfe-9aaf-aefb3c84ff2b.png) - -**Flow Sample** - -![image](https://user-images.githubusercontent.com/32592458/212663070-d7d43c7e-3c3f-47f2-8a0b-ccb0bc6e0471.png) - - - -**Flow Results** - -**Success case** - -![image](https://user-images.githubusercontent.com/32592458/212663085-2fe17b6b-df29-4e56-905f-952fec2b27c2.png) - - - -**No Match found case** - -![image](https://user-images.githubusercontent.com/32592458/212663103-a76a7e11-2adf-4e1c-8cd7-bad58f735de9.png) From cd4075cff3f5c45215ab68a897160f648c9932c8 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:24:27 +0530 Subject: [PATCH 02/25] Delete docs/4. Product Features/09. Reporting & Dashboard/00. Analytics Page.md --- .../00. Analytics Page.md | 55 ------------------- 1 file changed, 55 deletions(-) delete mode 100644 docs/4. Product Features/09. Reporting & Dashboard/00. Analytics Page.md diff --git a/docs/4. Product Features/09. Reporting & Dashboard/00. Analytics Page.md b/docs/4. Product Features/09. Reporting & Dashboard/00. Analytics Page.md deleted file mode 100644 index 20684c847..000000000 --- a/docs/4. Product Features/09. Reporting & Dashboard/00. Analytics Page.md +++ /dev/null @@ -1,55 +0,0 @@ -> ### **3 minutes read                                                                                                                         `Beginner`** - -_Analytics page provides out of the box generic insights into your chatbot's metrics_ - -1. Go to `Analytics` page from the side menu -Screenshot 2024-09-25 at 12 04 09 PM - - -3. Enter the phone number and password (these are the same credentials that you use for logging into the Glific account). Please enter the phone number complete with the country code. -Screenshot 2024-09-25 at 12 06 13 PM - -4. This should take you to the analytics page. - -### Understanding the Analytics page - -1. Filter as per the start date and end date to get the analytics for a specified period of time - -2. Use the bookmarks option to add links to other dashboards that you may have set-up to get more detailed insights. - Screenshot 2024-09-25 at 12 08 25 PM - - 3. Daily contacts and daily conversations shows the numbers of contacts and conversations on a day to day basis. Change the filters to get a shorter or broader view of the contacts or conversations. - -Conversations is defined as per WhatsApp business API's [defintion](https://developers.facebook.com/docs/whatsapp/conversation-types/) : Conversations are 24-hour message threads between you and your customers and are the basis for pricing. -Screenshot 2024-09-25 at 11 54 25 AM - -4. most active hour shows the time of maximum activity based on inbound and outbound messages - -Screenshot 2024-09-25 at 11 54 59 AM - -5. Opt-in and opt-out contacts shows the number of contacts who opt-ed in and opt-ed out in the given timeframe. - -6. Inbound messages is the no of messages being received by the chatbot -7. Outbound messages is the no of messages being sent by the chatbot - -Screenshot 2024-09-25 at 11 55 18 AM - -9. Monthly conversations is the conversations aggregated on a monthly basis -10. Contacts in flows shows the no of contacts in middle of flows in the given time period -11. Monthly flows started is the number of times flows were triggered due to a keyword and business initiated conversations due to broadcasts -12. Monthly flows completed tracks the number of times the started flows were reached to the end by the contacts -Screenshot 2024-09-25 at 11 55 31 AM -13. Total valid contacts shows the number of contacts who have valid phone numebrs -14. Invalid contacts the number of contacts whose phone numbers are either invalid or they no longer exist on WhatsApp -15. Opt-ed in contacts show the number of contacts who have given the permsission to be messaged by the business -16. Opted-out contacts are the ones who did not give the persmission to message or in the given time period decide to opt-out -17. Non-opted contacts are the contacts whose opt-in persmission is not available -Screenshot 2024-09-25 at 11 55 40 AM - -18. Incoming message are the number of messages being sent to your chatbot by the users -19. Outgoing messages are the number of messages being sent by your chatbot -20. HSM messages is the number of HSM messages sent to the users -21. Error messages shows the number of messages that were not delivered due to errors in the processing of the messgages - -Screenshot 2024-09-25 at 11 55 46 AM - From 37e341c218189e3bfe481037ac5480c619cee287 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:27:50 +0530 Subject: [PATCH 03/25] Delete docs/8. FAQ/01. Find opt-in link of our NGO.md --- docs/8. FAQ/01. Find opt-in link of our NGO.md | 9 --------- 1 file changed, 9 deletions(-) delete mode 100644 docs/8. FAQ/01. Find opt-in link of our NGO.md diff --git a/docs/8. FAQ/01. Find opt-in link of our NGO.md b/docs/8. FAQ/01. Find opt-in link of our NGO.md deleted file mode 100644 index 26a9e241d..000000000 --- a/docs/8. FAQ/01. Find opt-in link of our NGO.md +++ /dev/null @@ -1,9 +0,0 @@ -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. - -![image](https://user-images.githubusercontent.com/32592458/220825528-1f1974e7-173a-4dd7-a13d-8c7b073aa883.png) - -1. Clink on the copy link under `Click URL` option to copy your opt-in link. - -![image](https://user-images.githubusercontent.com/32592458/220825541-f01c8946-0caa-4e00-914d-5e47eed1667c.png) From b566f7c3b0bb742114d8fc5e8ad456ea498f2c69 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:28:42 +0530 Subject: [PATCH 04/25] Delete docs/8. FAQ/03. Check if user is opted-in in the flow.md --- .../03. Check if user is opted-in in the flow.md | 13 ------------- 1 file changed, 13 deletions(-) delete mode 100644 docs/8. FAQ/03. Check if user is opted-in in the flow.md diff --git a/docs/8. FAQ/03. Check if user is opted-in in the flow.md b/docs/8. FAQ/03. Check if user is opted-in in the flow.md deleted file mode 100644 index 995d515de..000000000 --- a/docs/8. FAQ/03. Check if user is opted-in in the flow.md +++ /dev/null @@ -1,13 +0,0 @@ -You can use variable `@contact.optin_status` to check. It will return **True** if user is opted it otherwise return False. - -![image](https://user-images.githubusercontent.com/32592458/220825610-b3e59398-3837-4a7a-906c-da0aa795cd6b.png) - - - -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%>` - - - -![image](https://user-images.githubusercontent.com/32592458/220825618-23afc2c8-35ab-46fa-994d-b2a5ad56dac4.png) From 5210c10ed8cb68905c475caf81dbb04fdb87e167 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:28:53 +0530 Subject: [PATCH 05/25] Delete docs/8. FAQ/04. Change admin in our FB business account.md --- docs/8. FAQ/04. Change admin in our FB business account.md | 1 - 1 file changed, 1 deletion(-) delete mode 100644 docs/8. FAQ/04. Change admin in our FB business account.md diff --git a/docs/8. FAQ/04. Change admin in our FB business account.md b/docs/8. FAQ/04. Change admin in our FB business account.md deleted file mode 100644 index fea851971..000000000 --- a/docs/8. FAQ/04. Change admin in our FB business account.md +++ /dev/null @@ -1 +0,0 @@ -Refer this article [Change access and permissions for a business account](https://www.facebook.com/business/help/299504287548592) \ No newline at end of file From efd815907d365e60c17fc4af9c89982f57a3d596 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:29:38 +0530 Subject: [PATCH 06/25] Delete docs/8. FAQ/05. Update my profile picture of BOT.md --- docs/8. FAQ/05. Update my profile picture of BOT.md | 3 --- 1 file changed, 3 deletions(-) delete mode 100644 docs/8. FAQ/05. Update my profile picture of BOT.md diff --git a/docs/8. FAQ/05. Update my profile picture of BOT.md b/docs/8. FAQ/05. Update my profile picture of BOT.md deleted file mode 100644 index 64e49d32c..000000000 --- a/docs/8. FAQ/05. Update my profile picture of BOT.md +++ /dev/null @@ -1,3 +0,0 @@ -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_ From 586c87ef4fc3583c2e683b5e3074c7be24fdf622 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:32:11 +0530 Subject: [PATCH 07/25] Delete docs/3. Starter Kit/Send a link of a specific flow to new contacts to join the BOT.md --- ...ic flow to new contacts to join the BOT.md | 39 ------------------- 1 file changed, 39 deletions(-) delete mode 100644 docs/3. Starter Kit/Send a link of a specific flow to new contacts to join the BOT.md diff --git a/docs/3. Starter Kit/Send a link of a specific flow to new contacts to join the BOT.md b/docs/3. Starter Kit/Send a link of a specific flow to new contacts to join the BOT.md deleted file mode 100644 index 995cff16d..000000000 --- a/docs/3. Starter Kit/Send a link of a specific flow to new contacts to join the BOT.md +++ /dev/null @@ -1,39 +0,0 @@ -> ### **3 minute read                                                                                                                         `Beginner`** - -## Send a link of a specific flow to new contacts to join the BOT - -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 - -![image](https://user-images.githubusercontent.com/32592458/220826084-fe5c3a72-dcd0-4cf1-bfc6-d4a626246b67.png) - -## Creating multiple QR codes - -To able to make multiple QR codes according to the specific flow follow the below steps: - -1) Create the link of a specific flow. [Read Here](https://glific.github.io/docs/docs/FAQ/Send%20a%20link%20of%20a%20specific%20flow%20to%20new%20contacts%20to%20join%20the%20BOT/) to know more on how to create link. - -2) Go to [Bitly.com](https://bitly.com/) and then generate QR codes. From d41000d2ac5c53e1e005a8836d9b529e28f3ca2c Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:32:42 +0530 Subject: [PATCH 08/25] Delete docs/8. FAQ/15. Give permissions to individuals in Google Cloud Storage GCS.md --- ...individuals in Google Cloud Storage GCS.md | 33 ------------------- 1 file changed, 33 deletions(-) delete mode 100644 docs/8. FAQ/15. Give permissions to individuals in Google Cloud Storage GCS.md diff --git a/docs/8. FAQ/15. Give permissions to individuals in Google Cloud Storage GCS.md b/docs/8. FAQ/15. Give permissions to individuals in Google Cloud Storage GCS.md deleted file mode 100644 index fa25f8674..000000000 --- a/docs/8. FAQ/15. Give permissions to individuals in Google Cloud Storage GCS.md +++ /dev/null @@ -1,33 +0,0 @@ -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. - -![image](https://user-images.githubusercontent.com/32592458/220826170-fea17b70-75df-42ca-8ed6-66e54ea74dc7.png) - - - -4 . It will open a sub menu. Click on `IAM` sub menu item. - -![image](https://user-images.githubusercontent.com/32592458/220826180-6162b681-c041-453f-9c42-81c7d496db4c.png) - - - -5 . Permission page will open up. Click on `Add` link from top of the page. - - - -![image](https://user-images.githubusercontent.com/32592458/220826189-3b9e1d11-945f-4558-b63d-223c5540439b.png) - - - -6 . In `New principals` filed, type the `email id`of the person to whom you need to give the permissions. - -![image](https://user-images.githubusercontent.com/32592458/220826204-91cbb82f-bd67-47ae-87f3-18a31f9158e1.png) - -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. - -![image](https://user-images.githubusercontent.com/32592458/220826217-806b27e0-b663-423b-962a-3ef1f81f2800.png) - -8 . Click on `Save` button to give the permissions. The user will receive an email with the access link and accept the permission. From 20f777911ff81247fb94a49ef35d97100c17b191 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:33:39 +0530 Subject: [PATCH 09/25] Delete docs/8. FAQ/17. Add the display Name of the BOT number and show it to end-users.md --- ...Name of the BOT number and show it to end-users.md | 11 ----------- 1 file changed, 11 deletions(-) delete mode 100644 docs/8. FAQ/17. Add the display Name of the BOT number and show it to end-users.md diff --git a/docs/8. FAQ/17. Add the display Name of the BOT number and show it to end-users.md b/docs/8. FAQ/17. Add the display Name of the BOT number and show it to end-users.md deleted file mode 100644 index ccb85b11c..000000000 --- a/docs/8. FAQ/17. Add the display Name of the BOT number and show it to end-users.md +++ /dev/null @@ -1,11 +0,0 @@ -# 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-) From 3d94100e70bea31c4faa77ca1f747ad6d1871e6d Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:34:18 +0530 Subject: [PATCH 10/25] Delete docs/8. FAQ/20. Read Receipts.md --- docs/8. FAQ/20. Read Receipts.md | 28 ---------------------------- 1 file changed, 28 deletions(-) delete mode 100644 docs/8. FAQ/20. Read Receipts.md diff --git a/docs/8. FAQ/20. Read Receipts.md b/docs/8. FAQ/20. Read Receipts.md deleted file mode 100644 index 2cc558336..000000000 --- a/docs/8. FAQ/20. Read Receipts.md +++ /dev/null @@ -1,28 +0,0 @@ -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. - - -![image](https://user-images.githubusercontent.com/32592458/220826509-62b892dd-a45f-4b7a-9473-0a9dacaef9fe.png) - -2 . Click on the on your Gupshup App Name. - -image - - -3. Go to the `Webhooks` section and active all the checkboxes. - -image - -image - - -- 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. - -![2e1b384f-5fcc-4378-b377-1407a3b0d809](https://user-images.githubusercontent.com/132430123/268231468-1469fd93-2c9e-4f10-9ce7-21de4b2a3d01.jpg) - - -- 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. From 9d4b2e37a4b27cd3368ff0d920e8ad69bcc86eb2 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:34:48 +0530 Subject: [PATCH 11/25] Delete docs/8. FAQ/21. Find the QR Code of BOT for opt-in contacts..md --- ...the QR Code of BOT for opt-in contacts..md | 38 ------------------- 1 file changed, 38 deletions(-) delete mode 100644 docs/8. FAQ/21. Find the QR Code of BOT for opt-in contacts..md diff --git a/docs/8. FAQ/21. Find the QR Code of BOT for opt-in contacts..md b/docs/8. FAQ/21. Find the QR Code of BOT for opt-in contacts..md deleted file mode 100644 index db68fcd40..000000000 --- a/docs/8. FAQ/21. Find the QR Code of BOT for opt-in contacts..md +++ /dev/null @@ -1,38 +0,0 @@ -1. Login to your Gupshup account - - - -![image](https://user-images.githubusercontent.com/32592458/220826581-84febd93-1abc-47e9-9129-02162d13515a.png) - - - -2. Click on the arrow icon beside your `App Name` - -image - -3. Click on `Opt-ins` - -image - - - -4. Click on Down arrow for `Onboarding machanisums`. - -![image](https://user-images.githubusercontent.com/32592458/220826599-b9caa656-118e-4313-b5c8-5e14c15898b4.png) - - - -5. Scoll down `Smart mechanisms to get active and opted in users` section to get the QR code - -image - -PS :This method generates a QR code for a fixed keyword like "Hi" or "Welcome," which might not be the right one, and you won't be able to edit or change the keyword. - -## Creating multiple QR codes - -To able to make multiple QR codes according to the specific flow follow the below steps: - -1) Create the link of a specific flow. [Read Here](https://glific.github.io/docs/docs/FAQ/Send%20a%20link%20of%20a%20specific%20flow%20to%20new%20contacts%20to%20join%20the%20BOT/) to know more on how to create link. - -2) Go to [Bitly.com](https://bitly.com/) and then generate QR codes. - From 9132deb323240efde638baf53cfef92b54549411 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:35:25 +0530 Subject: [PATCH 12/25] Delete docs/8. FAQ/22. Gupshup wallet balance and Usage.md --- .../22. Gupshup wallet balance and Usage.md | 71 ------------------- 1 file changed, 71 deletions(-) delete mode 100644 docs/8. FAQ/22. Gupshup wallet balance and Usage.md diff --git a/docs/8. FAQ/22. Gupshup wallet balance and Usage.md b/docs/8. FAQ/22. Gupshup wallet balance and Usage.md deleted file mode 100644 index 74ce2876f..000000000 --- a/docs/8. FAQ/22. Gupshup wallet balance and Usage.md +++ /dev/null @@ -1,71 +0,0 @@ -## Recharge Gupshup Walltet - -Steps to recharge your Gupshup wallet account. - -1 . Log in to your Gupshp account. - -![image](https://user-images.githubusercontent.com/32592458/220826639-50b7360b-2855-487b-a9e9-385412681437.png) - -2 . After login from the `dashboard` dropdown lick on `My Wallet` - - - -![image](https://user-images.githubusercontent.com/32592458/220826649-dd789396-884c-402e-8779-9152a44032b2.png) - -3 . `My Wallet & Usage` the page will open up. Click on `Add Balance`and pay it from your credit card. - -![image](https://user-images.githubusercontent.com/32592458/220826664-b6dcb971-417c-4abf-a593-67a168f15006.png) - - - -2 . Update your `billing address`. - - - -![image](https://user-images.githubusercontent.com/32592458/220826677-75cb385e-3437-42dc-953a-199b4527f0df.png) - -3 . Pay with your credit card. - -![image](https://user-images.githubusercontent.com/32592458/220826720-b4de5073-9ee5-4f7a-8017-6a21bacbf058.png) - - - -## Check Coversation usage - -1 . On `My Wallet & Usage` page, click on `View Usage` button. - -![image](https://user-images.githubusercontent.com/32592458/221192072-ff3de188-8dbc-4478-9a8f-56542de66ab6.png) - - - -2 . Click on the `WhatsApp` tab. - -![image](https://user-images.githubusercontent.com/32592458/221192087-2f1bbc9e-8143-45f8-a80a-85585cfbe4e6.png) - - - -3 . Select the `month` from the dropdown you want to see the usage. Click on `Download Report` the button to download. - -![image](https://user-images.githubusercontent.com/32592458/221192104-04078137-d5c1-4060-9875-991a0313f699.png) - - - -or scroll down to see the usage on the web page. - -![image](https://user-images.githubusercontent.com/32592458/221192146-b28d10d5-bd16-4cbc-8d04-376841080da7.png) - -## Gupshup Refund policy - -**Eligiblity for refund:** - -In the event that the WhatsApp self-serve platform is not used after recharge, the User may request a refund within 7 days from the recharge date. - -The refund will be processed after deducting applicable taxes and charges. - -If the refund request is made after the 7-day period, GupShup may, at its sole discretion and based on the merits of the request, credit WhatsApp notifications to the User's wallet instead. - -**Applicability of Refund Policy:** - -This policy is applicable for ALL the regions.[For more information](https://www.gupshup.io/terms-and-conditions#refund-policy) - -image From 2dec35c0d0df1e1216c14570442612f831185e65 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:37:00 +0530 Subject: [PATCH 13/25] Delete docs/8. FAQ/23. Update collection with bulk contacts or contact fields.md --- ...on with bulk contacts or contact fields.md | 29 ------------------- 1 file changed, 29 deletions(-) delete mode 100644 docs/8. FAQ/23. Update collection with bulk contacts or contact fields.md diff --git a/docs/8. FAQ/23. Update collection with bulk contacts or contact fields.md b/docs/8. FAQ/23. Update collection with bulk contacts or contact fields.md deleted file mode 100644 index 50e70187c..000000000 --- a/docs/8. FAQ/23. Update collection with bulk contacts or contact fields.md +++ /dev/null @@ -1,29 +0,0 @@ -1 . Login to Glific - -2 . From left menu select `Manage` then select `Contacts` - - -Screenshot 2024-03-04 at 3 16 52 PM - - -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. - -![image](https://user-images.githubusercontent.com/32592458/221194489-bfb20287-7c7b-4974-b49b-4fd566a14074.png) - -For **Contact filed addition** please use the below .csv file format. - -![image](https://user-images.githubusercontent.com/32592458/221194510-4d154d4e-7550-418c-bae5-22d71fb62aa1.png) - -[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. From 2cc1affbe725336f70b47733906d28532309aef5 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:38:22 +0530 Subject: [PATCH 14/25] Create 07. Get a data of a particular flow from BigQuery.md --- ...data of a particular flow from BigQuery.md | 45 +++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 docs/4. Product Features/09. Reporting & Dashboard/07. Get a data of a particular flow from BigQuery.md diff --git a/docs/4. Product Features/09. Reporting & Dashboard/07. Get a data of a particular flow from BigQuery.md b/docs/4. Product Features/09. Reporting & Dashboard/07. Get a data of a particular flow from BigQuery.md new file mode 100644 index 000000000..6117c66d3 --- /dev/null +++ b/docs/4. Product Features/09. Reporting & Dashboard/07. Get a data of a particular flow from BigQuery.md @@ -0,0 +1,45 @@ +## Get Data for a Specific Flow from BigQuery: + +- 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** + + ## Extract Data by Flow from BigQuery: + +- The following query can be used to extract data by flow. + +```sql +WITH extracted_json AS ( + SELECT + contact_phone, + contact_name, + JSON_EXTRACT_SCALAR(results, '$.feedback_positive.input') AS feedback_positive, + JSON_EXTRACT_SCALAR(results, '$.result_q1_pos.input') AS result_q1_pos, + JSON_EXTRACT_SCALAR(results, '$.result_q2_pos.input') AS result_q2_pos, + JSON_EXTRACT_SCALAR(results, '$.result_q3_pos.input') AS result_q3_pos + FROM + `your_project.your_dataset.your_table` where uuid = "flow_uuid" +) +SELECT * FROM extracted_json; +``` + +- All flow results must be added in a similar manner: + +`JSON_EXTRACT_SCALAR(results, '$.flow_result.input') AS flow_result,` + +- Running the query will generate a table displaying phone numbers, names, and their flow results, which can then be exported as a CSV. + + + + + + + + + + From 5e700c9b885a1354a5aed9747bf988f29a8f8e46 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:38:43 +0530 Subject: [PATCH 15/25] Delete docs/8. FAQ/24. Get a data of a particular flow from BigQuery.md --- ...data of a particular flow from BigQuery.md | 46 ------------------- 1 file changed, 46 deletions(-) delete mode 100644 docs/8. FAQ/24. Get a data of a particular flow from BigQuery.md diff --git a/docs/8. FAQ/24. Get a data of a particular flow from BigQuery.md b/docs/8. FAQ/24. Get a data of a particular flow from BigQuery.md deleted file mode 100644 index a1294aa2e..000000000 --- a/docs/8. FAQ/24. Get a data of a particular flow from BigQuery.md +++ /dev/null @@ -1,46 +0,0 @@ -## Get Data for a Specific Flow from BigQuery: - -- 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** - - ## Extract Data by Flow from BigQuery: - -- The following query can be used to extract data by flow. - -```sql -WITH extracted_json AS ( - SELECT - contact_phone, - contact_name, - JSON_EXTRACT_SCALAR(results, '$.feedback_positive.input') AS feedback_positive, - JSON_EXTRACT_SCALAR(results, '$.result_q1_pos.input') AS result_q1_pos, - JSON_EXTRACT_SCALAR(results, '$.result_q2_pos.input') AS result_q2_pos, - JSON_EXTRACT_SCALAR(results, '$.result_q3_pos.input') AS result_q3_pos - FROM - `your_project.your_dataset.your_table` where uuid = "flow_uuid" -) -SELECT * FROM extracted_json; -``` - -- All flow results must be added in a similar manner: - -`JSON_EXTRACT_SCALAR(results, '$.flow_result.input') AS flow_result,` - -- Running the query will generate a table displaying phone numbers, names, and their flow results, which can then be exported as a CSV. - - - - - - - - - - - From 89ad65fedb28d708bb56d00ae394421df8ecb98a Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:38:54 +0530 Subject: [PATCH 16/25] Delete docs/8. FAQ/25. Get WABA ID.md --- docs/8. FAQ/25. Get WABA ID.md | 9 --------- 1 file changed, 9 deletions(-) delete mode 100644 docs/8. FAQ/25. Get WABA ID.md diff --git a/docs/8. FAQ/25. Get WABA ID.md b/docs/8. FAQ/25. Get WABA ID.md deleted file mode 100644 index 87c464d0d..000000000 --- a/docs/8. FAQ/25. Get WABA ID.md +++ /dev/null @@ -1,9 +0,0 @@ -1. Login to your Gupshup account. - -2. Click on Dashbaord - -3. CLick on Settings tab - -4. Check the waba ID under APP type - -Screenshot 2023-04-06 at 7 20 31 PM From 1c3d28806ced7bad4edcc0a5fd0b3b791a7f3e12 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:39:32 +0530 Subject: [PATCH 17/25] Delete docs/8. FAQ/Enable Google Sheet API and link to Glific.md --- ...ble Google Sheet API and link to Glific.md | 49 ------------------- 1 file changed, 49 deletions(-) delete mode 100644 docs/8. FAQ/Enable Google Sheet API and link to Glific.md diff --git a/docs/8. FAQ/Enable Google Sheet API and link to Glific.md b/docs/8. FAQ/Enable Google Sheet API and link to Glific.md deleted file mode 100644 index a0cb73d46..000000000 --- a/docs/8. FAQ/Enable Google Sheet API and link to Glific.md +++ /dev/null @@ -1,49 +0,0 @@ -### **3 minute read                                                                                                                         `Beginner`** - -## Enable Google Sheet API and link to Glific - -1) Go to [Google Cloud Console](https://console.cloud.google.com) and sign in with your Gsuite account. - -2) Click on **API & Services** - -image - - -3) Click on **+ Enable APIS and Services** - -image - -4) Search for **Google Sheets API** in the search section and select it. - -image - -image - - -5) Enable the **Google Sheets API** from the enable button - -image - -Please Note: The above screenshot has Manage Button as here the Google Sheet API is already enabled. If you are enabling it for first time instead of Manage Button you will find the Enable Button. - -## Link Google Sheet API to Glific - -1) Login to `Glific Account` - -2) Go to `Setting` - -Screenshot 2024-04-30 at 12 55 33 PM - -3) Click on `Google Sheet` from the left panel - -4) Mark it `Active` - -5) Add the `GOTH Credentials` - -6) Click on `Save` button - -image - -## How to get GOTH Credenatils on [Google Cloud Console](https://console.cloud.google.com) - -Click here to know how to get [GOTH Credentials](https://glific.github.io/docs/docs/Product%20Features/Reporting%20&%20Dashboard/BigQuery%20Setup%20and%20link%20with%20Glific/) From 6ba7639523311025b2025a119c151912489809f9 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:40:16 +0530 Subject: [PATCH 18/25] Delete docs/8. FAQ/GCS_Bucket.md --- docs/8. FAQ/GCS_Bucket.md | 27 --------------------------- 1 file changed, 27 deletions(-) delete mode 100644 docs/8. FAQ/GCS_Bucket.md diff --git a/docs/8. FAQ/GCS_Bucket.md b/docs/8. FAQ/GCS_Bucket.md deleted file mode 100644 index 784d8d2c2..000000000 --- a/docs/8. FAQ/GCS_Bucket.md +++ /dev/null @@ -1,27 +0,0 @@ -> ### **3 minute read                                                                                                                         `Beginner`** - - -## What's the reason for setting the GCS bucket to public? - -The `GCS (Google Cloud Storage)` bucket is set to public to make it easier to share files—like PDFs, images, videos etc — without needing user authentication. - -This is especially useful when files need to be accessed directly through chatbot flows or shared publicly with partners and beneficiaries. -When a file is public, anyone with the link can open or download it without logging in. This avoids errors or delays caused by restricted access. - -Example: - -If an NGO’s bot sends a PDF through a the chatbot, and the file is stored in a public bucket, the end user can simply tap the link and view it — no login or permission required. -Note: Only non-sensitive, public-facing files should be stored in the public bucket. Private or personal data should always be stored securely with proper access controls. - -## Is it possible to keep my GCS bucket private instead of making it public? - -It's perfectly fine to keep your `GCS bucket` private as long as you don't plan to share any content publicly. - -However, if you need to send media as attachments (instead of sharing via links), the bucket would need to be public for access. - -Also, just to clarify — `BigQuery tables` and `GCS buckets` serve different purposes. - -- BigQuery tables are used to store structured data (like databases). -- GCS buckets are used to store media files such as images, audio, and documents. - - From 687e3387c290f9816c9cf34478bb4a5a8ef5743b Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:40:58 +0530 Subject: [PATCH 19/25] Delete docs/8. FAQ/Grant access to the Service Account in Google Console.md --- ...o the Service Account in Google Console.md | 24 ------------------- 1 file changed, 24 deletions(-) delete mode 100644 docs/8. FAQ/Grant access to the Service Account in Google Console.md diff --git a/docs/8. FAQ/Grant access to the Service Account in Google Console.md b/docs/8. FAQ/Grant access to the Service Account in Google Console.md deleted file mode 100644 index 1e91f31d5..000000000 --- a/docs/8. FAQ/Grant access to the Service Account in Google Console.md +++ /dev/null @@ -1,24 +0,0 @@ ->### **3 minute read                                                                                                                         `Beginner`** - - -### Assign access to the Service Account in Google Console - -- Go to [Google Cloud Console](https://console.cloud.google.com) and sign in with your Gsuite account. - -![image](https://user-images.githubusercontent.com/32592458/212658353-8fed1d92-2e9d-4a9f-99c9-a359dc08698f.png) - -- Click on `IAM & Admin` and select `Service Accounts`. - -image - -image - -- Access the created `Service Account` and go to `Permissions`. - -image - -- Click on Grant Access, select `New Principal`, enter the desired email address (e.g., reporting@projecttech4dev.org), and assign the role as `Owner`. - -image - -- Click `Save`. From 9d3887d15b1f82212a41c8ff27d54a018244c1f1 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:41:30 +0530 Subject: [PATCH 20/25] Delete docs/8. FAQ/How to add new contacts in bulk.md --- .../8. FAQ/How to add new contacts in bulk.md | 39 ------------------- 1 file changed, 39 deletions(-) delete mode 100644 docs/8. FAQ/How to add new contacts in bulk.md diff --git a/docs/8. FAQ/How to add new contacts in bulk.md b/docs/8. FAQ/How to add new contacts in bulk.md deleted file mode 100644 index 9dbee0bc8..000000000 --- a/docs/8. FAQ/How to add new contacts in bulk.md +++ /dev/null @@ -1,39 +0,0 @@ -### **3 minute read                                                                                                                         `Beginner`** - -## Adding new contacts to your Glific account -This feature enables NGO staff to upload a large number of new contacts into their Glific account and mark them opt-in contacts. Doing this will enable NGOs to initiate the first message to these contacts. - -### Before uploading new contacts: -1. Ensure you have prior permission / consent from the contacts to message them through the chatbot. -2. Ensure the first message being sent to the newly onboarded contacts is the opt-in message - -### Note -1. Contacts get an option to “block or report” a chatbot number when the business initiates the first conversation. -2. More no of contacts blocking a chatbot for a given message can lead to the reduction in quality rating of the chatbot or sometimes permanent suspension of the chatbot accoun. -3. Kindly plan to message large number of new contacts in batches to avoid having quality rating of your chatbot reduced or having your chatbot blocked by Meta - -### How to use -1. Go to `Manage` and `Contacts` -2. Find the `Import contacts` and click `Continue` -Screenshot 2024-08-29 at 2 59 22 PM - -5. Download the sample csv and provide the information of the contacts in the format of the sample csv - -6. Select the `collection` where the contacts will be added (it is advised to add contacts being uploaded in a new collection) -Screenshot 2024-08-29 at 3 02 34 PM - -7. Check the Opt-in status -8. Import the csv by clicking on `Select file`, this allows you to upload the csv file from your computer -Screenshot 2024-08-29 at 3 10 37 PM - -10. Check the notifications page to see the status of the upload. -Screenshot 2024-08-29 at 3 11 37 PM - - - -### Sample csv and what information to upload -Screenshot 2024-08-29 at 3 02 49 PM - -1. Ensure that the country code is present in the phone number. -2. This feature uploads all the contacts into the platform and does not validate the phone number (if it is less than 10 digits or if the number exists on WhatsApp or no). Any invalid number which gets added, when broadcasted to will not get the message. -3. Language field is to provide the language preference. Leaving it blank will cause the language preference to be the default language selected in the org’s Glific platform From 6d7ba48acd895e41579cfb0bd071b00a733a6086 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:43:13 +0530 Subject: [PATCH 21/25] Create 5. Language Supported --- .../03. Flows/5. Language Supported | 137 ++++++++++++++++++ 1 file changed, 137 insertions(+) create mode 100644 docs/4. Product Features/03. Flows/5. Language Supported diff --git a/docs/4. Product Features/03. Flows/5. Language Supported b/docs/4. Product Features/03. Flows/5. Language Supported new file mode 100644 index 000000000..10026e658 --- /dev/null +++ b/docs/4. Product Features/03. Flows/5. Language Supported @@ -0,0 +1,137 @@ +> ### **2 minutes 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. + + +Screenshot 2024-02-29 at 5 08 31 PM + + +3. Verify the languages are available to create a flow. + + +Screenshot 2024-02-29 at 5 09 06 PM + + +## Create flow in a different language + + + +4. Click on the `language` option to add translation of the message for that language. + + +Screenshot 2024-02-29 at 5 09 47 PM + +5. Click on the message you want add another language content for. + + +Screenshot 2024-02-29 at 5 13 01 PM + + + +6. Enter the message text in the selected language and click `OK` button to save it. + +Screenshot 2024-02-29 at 5 10 39 PM + + + +7. Your message is saved. You can repeat the process for all the languages and all the messages. + +Screenshot 2024-02-29 at 5 11 14 PM + + + + +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. + +Screenshot 2024-02-29 at 5 17 16 PM + + +b) Change the language from the dropdown. + +Screenshot 2024-02-29 at 5 17 52 PM + + + + +## 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.** + +Screenshot 2024-02-29 at 5 19 15 PM + +# How to change the language of your interface. + +1 . Login in your Glific account. + +2 . Click on bottom most button on the left profile `NGO main account` select `My account`icon from the menu. + +Screenshot 2024-02-29 at 5 20 06 PM + + +4 . On `My Account` page click on the `change interface language` dropdown to select the available languages for interface. + + +Screenshot 2024-02-29 at 5 21 35 PM + + +5 . Interface language is changed in your preferred language. +Screenshot 2024-02-29 at 5 23 01 PM + + + +## 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. + + +Screenshot 2024-02-29 at 5 24 12 PM + + +2 . Click on `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. + +Screenshot 2024-02-29 at 5 25 12 PM + + + +4 . Scroll down and click on Save button to save the changes. + +5 . Verify the new language added in the flow editor. + +## Languages Supported for Template Messages + +- Message templates are supported in approximately 71 languages by Gupshup. + +- Check out the help link for details.[Read more](https://support.gupshup.io/hc/en-us/articles/360013321939-Which-languages-are-supported-for-message-templates) + From ea8040214f79ed9e74b0025b6d2727d5cdd79561 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:43:21 +0530 Subject: [PATCH 22/25] Delete docs/4. Product Features/10. Others/03. Languages.md --- .../10. Others/03. Languages.md | 138 ------------------ 1 file changed, 138 deletions(-) delete mode 100644 docs/4. Product Features/10. Others/03. Languages.md diff --git a/docs/4. Product Features/10. Others/03. Languages.md b/docs/4. Product Features/10. Others/03. Languages.md deleted file mode 100644 index bd31b8537..000000000 --- a/docs/4. Product Features/10. Others/03. Languages.md +++ /dev/null @@ -1,138 +0,0 @@ -> ### **2 minutes 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. - - -Screenshot 2024-02-29 at 5 08 31 PM - - -3. Verify the languages are available to create a flow. - - -Screenshot 2024-02-29 at 5 09 06 PM - - -## Create flow in a different language - - - -4. Click on the `language` option to add translation of the message for that language. - - -Screenshot 2024-02-29 at 5 09 47 PM - -5. Click on the message you want add another language content for. - - -Screenshot 2024-02-29 at 5 13 01 PM - - - -6. Enter the message text in the selected language and click `OK` button to save it. - -Screenshot 2024-02-29 at 5 10 39 PM - - - -7. Your message is saved. You can repeat the process for all the languages and all the messages. - -Screenshot 2024-02-29 at 5 11 14 PM - - - - -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. - -Screenshot 2024-02-29 at 5 17 16 PM - - -b) Change the language from the dropdown. - -Screenshot 2024-02-29 at 5 17 52 PM - - - - -## 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.** - -Screenshot 2024-02-29 at 5 19 15 PM - -# How to change the language of your interface. - -1 . Login in your Glific account. - -2 . Click on bottom most button on the left profile `NGO main account` select `My account`icon from the menu. - -Screenshot 2024-02-29 at 5 20 06 PM - - -4 . On `My Account` page click on the `change interface language` dropdown to select the available languages for interface. - - -Screenshot 2024-02-29 at 5 21 35 PM - - -5 . Interface language is changed in your preferred language. -Screenshot 2024-02-29 at 5 23 01 PM - - - -## 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. - - -Screenshot 2024-02-29 at 5 24 12 PM - - -2 . Click on `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. - -Screenshot 2024-02-29 at 5 25 12 PM - - - -4 . Scroll down and click on Save button to save the changes. - -5 . Verify the new language added in the flow editor. - -## Languages Supported for Template Messages - -- Message templates are supported in approximately 71 languages by Gupshup. - -- Check out the help link for details.[Read more](https://support.gupshup.io/hc/en-us/articles/360013321939-Which-languages-are-supported-for-message-templates) - - From 9b727775ffc9b73232e80377000351d0f2b1e196 Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:44:58 +0530 Subject: [PATCH 23/25] Create How To Set Up HSM Delivery Dashboard.md --- .../How To Set Up HSM Delivery Dashboard.md | 103 ++++++++++++++++++ 1 file changed, 103 insertions(+) create mode 100644 docs/4. Product Features/09. Reporting & Dashboard/How To Set Up HSM Delivery Dashboard.md diff --git a/docs/4. Product Features/09. Reporting & Dashboard/How To Set Up HSM Delivery Dashboard.md b/docs/4. Product Features/09. Reporting & Dashboard/How To Set Up HSM Delivery Dashboard.md new file mode 100644 index 000000000..0541351fe --- /dev/null +++ b/docs/4. Product Features/09. Reporting & Dashboard/How To Set Up HSM Delivery Dashboard.md @@ -0,0 +1,103 @@ +### **4 minute read                                                                                                                         `Advanced`** + + +### Problem: How to find the number of contacts who did not get the business initiated message due to frequency capping regulations imposed by Meta on Marketing HSMs. + +Context: Meta recently introduced something called as Frequency capping. Explaining in a simple manner, it noticed that users get a lot of Marketing messages from businesses, and to limit SPAM daily, it restricts how many Marketing messages a user can get during a rolling period of X days. + +To prevent misuse and gaming the system, they haven’t told us how many messages are allowed in how many days. You can read more about this in their own words [here.](https://www.gupshup.io/resources/blog/all-you-need-to-know-about-whatsapp-business-api-frequency-capping) + +### Solution: To understand contacts, templates, and campaigns affected (based on dates the broadcast was initaited) by having information of errors that were encountered visialized on a lookerstudio dashboard. This will reduce the effort in repeteadly quering this infomration from the database for every braodcast made, and to make this information easily accessible to the program / operations team to work with. + +``` +SELECT +JSON_EXTRACT_SCALAR(m.errors, '$.app') AS app, +JSON_EXTRACT_SCALAR(m.errors, '$.payload.destination') AS destination, +JSON_EXTRACT_SCALAR(m.errors, '$.payload.type') AS type, +JSON_EXTRACT_SCALAR(m.errors, '$.payload.payload.reason') AS reason, +DATE(m.sent_at) AS sent_on, +m.flow_name AS flow_name, +m.template_uuid AS template_id, +m.body AS message, +m.media_url, +m.is_hsm, +m.contact_name, +m.contact_phone +FROM `project-name.bot-number.messages` AS m +WHERE m.bsp_status = "error" +GROUP BY +app, destination, type, reason, sent_on, flow_name, template_id, message, m.media_url, m.is_hsm, m.contact_name, m.contact_phone; + +``` +- For this query to work for your organization, reaplce the 'projet-name' with the name of your Google Cloud project within which the Big Qusery instance is set up. +- Replace the 'bot-number' with the chatbot number being used, pre-fixed with the country code. + +Screenshot 2025-05-12 at 2 36 12 PM + + +## How to set this up + +### 1. Sign into Bigquery using the appropriate email account and select the options to run a query. +- Navigate to bigquery. Expand the phone number (aka dataset) and select `Contacts` table + +Screenshot 2025-05-12 at 2 40 53 PM + +- Click on the “Query’ button to create an empty query + +Screenshot 2025-05-12 at 2 41 14 PM + +- You will get an empty query which looks like this +Screenshot 2025-05-12 at 2 41 33 PM + +- Copy paste the query above into the query window. Replace the phrase “dataset” with the values from the empty query. Copy everything (projectname.dataset) from the ‘ symbol till the .(dot) before contacts and paste it in the 2 places it says “dataset”. Delete the empty query so that only what you pasted is visible on the screen. + +- Hit the ‘Run’ button. You will see Query Results coming once the query has run + +Screenshot 2025-05-12 at 2 42 16 PM + +- Click on Save and select “Save View” + +Screenshot 2025-05-12 at 2 42 42 PM + +- In the popup you see, select the correct values. Name the table “error_hsm_and_media” + +Screenshot 2025-05-12 at 2 43 05 PM + +- You will now see a new table/view popping up in the list of tables in the left of the screen +Screenshot 2025-05-12 at 2 44 10 PM + +Now that the data is formatted as you need it, +lets move to Part 2 + +### 2. Setting up the visualization. + +- Sign in to your Look Studio space using your work google account associated with BigQuery + +- Open this link - https://lookerstudio.google.com/u/0/reporting/859eb34f-2f9a-410c-8baa-dacf28af6c33/page/oBhGF/preview in your browser +- In the top right corner, you will see 2 buttons next to your user profile icon +Screenshot 2025-05-12 at 3 09 14 PM + +- Click on Use my own data + +- Navigate the options, to select your project. Then the data set, and then finally the view we just created. Your dashboard is ready! + + Screenshot 2025-05-12 at 3 09 46 PM + +- Finish off the steps by clicking "Edit and Share" + +- This will lead you to the same preview link as shared above. +- Navigate to the lookerstudio homepage by clicking the top left "Lookerstudio" icon, next to the "HSM and Media Errors" name of the dashboard +Screenshot 2025-05-22 at 2 02 40 PM + +- See that a new copy of the dashboard has been created. +Screenshot 2025-05-22 at 2 03 20 PM + +- Go to this copy of the dashboard, go to edit and change the name to include your org's name for future reference. +Screenshot 2025-05-22 at 2 03 48 PM + +#### Editing and modifying further +- To see a list of users and numbers or any other such details, select Edit. +- Then Select Add a chart. Select a table. +- Drag and drop the fields contact_name and contact_phone under “Dimension”. +- You can now extract all the affected users when apply the relevant filters by Hovering on the top right corner of the chart, +- clicking on “more”, then Export and selecting the format you prefer! From deb8bf1d58042ecaa1831d8128567e786a2fd3de Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:45:05 +0530 Subject: [PATCH 24/25] Delete docs/8. FAQ/How To Set Up HSM Delivery Dashboard.md --- .../How To Set Up HSM Delivery Dashboard.md | 103 ------------------ 1 file changed, 103 deletions(-) delete mode 100644 docs/8. FAQ/How To Set Up HSM Delivery Dashboard.md diff --git a/docs/8. FAQ/How To Set Up HSM Delivery Dashboard.md b/docs/8. FAQ/How To Set Up HSM Delivery Dashboard.md deleted file mode 100644 index 0541351fe..000000000 --- a/docs/8. FAQ/How To Set Up HSM Delivery Dashboard.md +++ /dev/null @@ -1,103 +0,0 @@ -### **4 minute read                                                                                                                         `Advanced`** - - -### Problem: How to find the number of contacts who did not get the business initiated message due to frequency capping regulations imposed by Meta on Marketing HSMs. - -Context: Meta recently introduced something called as Frequency capping. Explaining in a simple manner, it noticed that users get a lot of Marketing messages from businesses, and to limit SPAM daily, it restricts how many Marketing messages a user can get during a rolling period of X days. - -To prevent misuse and gaming the system, they haven’t told us how many messages are allowed in how many days. You can read more about this in their own words [here.](https://www.gupshup.io/resources/blog/all-you-need-to-know-about-whatsapp-business-api-frequency-capping) - -### Solution: To understand contacts, templates, and campaigns affected (based on dates the broadcast was initaited) by having information of errors that were encountered visialized on a lookerstudio dashboard. This will reduce the effort in repeteadly quering this infomration from the database for every braodcast made, and to make this information easily accessible to the program / operations team to work with. - -``` -SELECT -JSON_EXTRACT_SCALAR(m.errors, '$.app') AS app, -JSON_EXTRACT_SCALAR(m.errors, '$.payload.destination') AS destination, -JSON_EXTRACT_SCALAR(m.errors, '$.payload.type') AS type, -JSON_EXTRACT_SCALAR(m.errors, '$.payload.payload.reason') AS reason, -DATE(m.sent_at) AS sent_on, -m.flow_name AS flow_name, -m.template_uuid AS template_id, -m.body AS message, -m.media_url, -m.is_hsm, -m.contact_name, -m.contact_phone -FROM `project-name.bot-number.messages` AS m -WHERE m.bsp_status = "error" -GROUP BY -app, destination, type, reason, sent_on, flow_name, template_id, message, m.media_url, m.is_hsm, m.contact_name, m.contact_phone; - -``` -- For this query to work for your organization, reaplce the 'projet-name' with the name of your Google Cloud project within which the Big Qusery instance is set up. -- Replace the 'bot-number' with the chatbot number being used, pre-fixed with the country code. - -Screenshot 2025-05-12 at 2 36 12 PM - - -## How to set this up - -### 1. Sign into Bigquery using the appropriate email account and select the options to run a query. -- Navigate to bigquery. Expand the phone number (aka dataset) and select `Contacts` table - -Screenshot 2025-05-12 at 2 40 53 PM - -- Click on the “Query’ button to create an empty query - -Screenshot 2025-05-12 at 2 41 14 PM - -- You will get an empty query which looks like this -Screenshot 2025-05-12 at 2 41 33 PM - -- Copy paste the query above into the query window. Replace the phrase “dataset” with the values from the empty query. Copy everything (projectname.dataset) from the ‘ symbol till the .(dot) before contacts and paste it in the 2 places it says “dataset”. Delete the empty query so that only what you pasted is visible on the screen. - -- Hit the ‘Run’ button. You will see Query Results coming once the query has run - -Screenshot 2025-05-12 at 2 42 16 PM - -- Click on Save and select “Save View” - -Screenshot 2025-05-12 at 2 42 42 PM - -- In the popup you see, select the correct values. Name the table “error_hsm_and_media” - -Screenshot 2025-05-12 at 2 43 05 PM - -- You will now see a new table/view popping up in the list of tables in the left of the screen -Screenshot 2025-05-12 at 2 44 10 PM - -Now that the data is formatted as you need it, -lets move to Part 2 - -### 2. Setting up the visualization. - -- Sign in to your Look Studio space using your work google account associated with BigQuery - -- Open this link - https://lookerstudio.google.com/u/0/reporting/859eb34f-2f9a-410c-8baa-dacf28af6c33/page/oBhGF/preview in your browser -- In the top right corner, you will see 2 buttons next to your user profile icon -Screenshot 2025-05-12 at 3 09 14 PM - -- Click on Use my own data - -- Navigate the options, to select your project. Then the data set, and then finally the view we just created. Your dashboard is ready! - - Screenshot 2025-05-12 at 3 09 46 PM - -- Finish off the steps by clicking "Edit and Share" - -- This will lead you to the same preview link as shared above. -- Navigate to the lookerstudio homepage by clicking the top left "Lookerstudio" icon, next to the "HSM and Media Errors" name of the dashboard -Screenshot 2025-05-22 at 2 02 40 PM - -- See that a new copy of the dashboard has been created. -Screenshot 2025-05-22 at 2 03 20 PM - -- Go to this copy of the dashboard, go to edit and change the name to include your org's name for future reference. -Screenshot 2025-05-22 at 2 03 48 PM - -#### Editing and modifying further -- To see a list of users and numbers or any other such details, select Edit. -- Then Select Add a chart. Select a table. -- Drag and drop the fields contact_name and contact_phone under “Dimension”. -- You can now extract all the affected users when apply the relevant filters by Hovering on the top right corner of the chart, -- clicking on “more”, then Export and selecting the format you prefer! From 3047dc5700fca15a874832bae5f0b353aae1179a Mon Sep 17 00:00:00 2001 From: Akansha Sakhre Date: Thu, 28 Aug 2025 12:45:19 +0530 Subject: [PATCH 25/25] Rename How To Set Up HSM Delivery Dashboard.md to 08. How To Set Up HSM Delivery Dashboard.md --- ...y Dashboard.md => 08. How To Set Up HSM Delivery Dashboard.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/4. Product Features/09. Reporting & Dashboard/{How To Set Up HSM Delivery Dashboard.md => 08. How To Set Up HSM Delivery Dashboard.md} (100%) diff --git a/docs/4. Product Features/09. Reporting & Dashboard/How To Set Up HSM Delivery Dashboard.md b/docs/4. Product Features/09. Reporting & Dashboard/08. How To Set Up HSM Delivery Dashboard.md similarity index 100% rename from docs/4. Product Features/09. Reporting & Dashboard/How To Set Up HSM Delivery Dashboard.md rename to docs/4. Product Features/09. Reporting & Dashboard/08. How To Set Up HSM Delivery Dashboard.md