Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create Migration to Glific.md #211

Merged
merged 1 commit into from
Sep 11, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
94 changes: 94 additions & 0 deletions docs/2. Onboarding/Migration to Glific.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
>### **5 minute read                                                                                                                         `Beginner`**

# Migration to Glific

## Initial Checks:

### Existing Users:


- **Inactive Bots:** If the bot is inactive as in has no active users, proceed with the migration easily as you don't need to worry about end-user experience


- **Active Bots:**

- Avoid creating a Gupshup App immediately.
- Initiate the Glific setup using dummy values for the App name and API key to create a Glific account using the T&C form. Reach out to us when you are doing this step to get the values to fill.
- Manually create the account with the help of Developers as OTPs will not be received to set the password for the account you are creating.

### Setting Up Flows:

### Creating Flows and User Experiences:

- Log into Glific to create flows and user experiences that align with the current system. Consider giving migrating NGO-users access to a staging account for flow creation which they can later import.

- Keep in mind what they need as default language in their environment. It will be difficult to migrate when you create a flow in an environment whose default language is English with an enabled language is Hindi to an environment whose default language is Hindi, with English as an enabled language.There could be translation issues, esp with Interactive messages.

- Every chatbot platform has different ways to create a chatbot flow. Anticipate differences in flow creation method and request that in the onboarding for Glific.

- Utilize the simulator for testing since the bot is not connected to WhatsApp. _Consult Developers for proxy use without an app name_

- Put into place a plan to test with the real bot on their numbers as soon as the bot is live before they announce successful migration or if they have active users, have a plan to unstuck users if they are

### User Experience:

### Ensuring a Smooth Transition:

- Create the flows you’d want your user to experience when they interact with your bot on Glific. Use the phone simulator to test it and be sure of how it works.

- Create a Gupshup account during low-activity periods to minimize user impact, as it requires the NGO to share the phone number and an OTP to complete the migration. More details on steps below.

- Encourage partners to inform their users about the migration.

### Technical Considerations:

### Understanding the Existing Bot System:

- Determine if the system is prepaid or postpaid for balance recharge.

- Understand the flow design tools (e.g., RapidPro, Botpress) used by the current system to plan onboarding.

### Migration Steps:

**Preparing for Migration:**

- Ensure Glific is set up with necessary flows.

- Disable two-factor authentication on the existing bot system by emailing your current service provider. Some of them allow you to disable to this in your settings panel.

- Only if required, delete the bot number from your Facebook Business Manager’s WhatsApp Page. In this scenario, reach out to us so that we can help you with this.

**Addressing Blockers:**

- Check for any blockers in the existing bot system and ensure all bills are paid.

- Recharge the SIM

- Have the development team on standby for support before the next step

**Creating Gupshup Account:**

- Create the app and log in via Facebook to auto-select the existing FB Business Manager profile.

- Follow the migration instructions, choosing the phone option for OTP to avoid SMS delays.

- Encourage the organisation to do a minor recharge of USD 10 to keep balance - show them how to do it, and how to monitor credit in Glific

**Post Gupshup app going live**

- Once done, Collect App name, API key and share with Developers so that they can update our DB entry for the bot.

- While they are updating our Db, disable auto optin messages etc.

- Excute the test plan to make sure the bot is working as planned/required before “soft relaunching” it











Loading