WeChat platform is the most popular messages and social media platform in China. What if we could better reach the Chinese with an integrated chat bot that could help people learn more about the Bible.

What it does

Provide a simple reading plan for someone who has never encountered the Bible. Answer basic questions and respond with topical information and verse lookup via the WeChat messages app.

Begin by subscribing to the Gospel Guide bot on wechat. The bot responds with a welcome and instructions. Commands such as Start, Stop, Next, allow the user to begin a new 14 day intro to the Bible reading plan. The bot will auto send you todays reading each day and keep track of what reading your are currently on. The bot also accepts voice commands using WeChat's built in voice recognition. The voice recognition currently only works for mandarin Chinese, however our app is multilingual and can accept these Chinese voice commands without issue.

Alt text Alt text

In addition to the reading plan, users can ask basic questions such as 'What is God like?', 'Who is Jesus?', 'Who is the Holy Spirit?', and 'What is love?'. Questions that do not have automatic responses are forwarded to another WeChat user who can send a response back. This person could be a pastor or spiritual leader. The bot is also able to receive voice message responses.

Alt text Alt text

The Gospel Guide bot can respond with Bible text lookups. Simply send a message containing a Bible verse, chapter, or range, and the bot will send you the full text. If you would like more information about a verse or passage you can send a mesage containing keywords such as 'explain', 'I don't understand', 'commentary' followed by a scripture passage and the bot will send you a link to a Bible commentary on that passage!

Multilingual English/Chinese

Alt text Alt text Alt text

How we built it

We built the Gospel Guide bot using Python, Flask, and Redis running on a server.

Challenges we ran into

Overall, the coding went smoothly. The biggest issue we had was understanding the limited WeChat documentation on message passing. Because the documentation was translated from Chinese, many questions we had were left unanswered and were solved through trial and error. Other challenges included bugs from working with utf-8 characters and handling the different use cases for text messages, video messages, and audio messages.

Accomplishments that we're proud of

We built a working Chat bot!

What we learned

I (Ben) learned Python this weekend, thanks to the help of Femi!

What's next for WeChat Bible bot

More Chinese integration

C4TK #c4tksanfrancisco

Built With

Share this project: