kakada/chatfuel

chatfuel-rails is a small rails app communicate with chatfuel to build interactive chatbot.

How it works?

1. First, user communicate with chatbot in facebook page
2. Chatfuel will collect info (user's attributes) that user input and send to our rails app , in this case chatfuel-rails
3. chatfuel-rails grabs those attributes through rails params, then, process result and response to chatfuel via JSON response
4. It is possible to redirect to blocks dynamically, base on app logic.

Plugins

• set user attribute : use to capture value that user answer in messager.
• json api : use to send request, unidirect flow from chatfuel to rails app
• redirect to blocks : redirect user to specific block in design flow

Challenge

• re-engagement

  • story: send remind static message to user if he/she does not complete questionair form.
  • subscribe user to a sequence, then unsubscribe once finish.

• advance re-engagement

  • story: as a chat admin, The bot should follow up the user only question that he/she does not answer yet or not yet complete the current form.
  • solution: keep track for each question, redirect user to last block, which is where his/her question that not yet complete.

For more defail,

• Chatfuel doc

chatfuel's Issues

Localization (En & Kh)

Chatbot - Schedule follow up with the user who is incomplete interaction flow

As an OWSO chief
I want the system to follow up incompleted user after last received x hours with the last question received to maximize the engagement
So that the user can get notifies to keep continue and engage with the Page for the rest flow

Note: x can be set by system admin

Authentication & Authorization

Role:

1. System admin - Manage site & site admin user(create, disable, ..etc.)
2. Site admin - manage site user, listing, dashboard
3. Site ombudsmen - can view-only dashboard with complaint statistic

IVR - Notify incompleted tracking user when their ticket completed after an interval x

As a system at Kamrieng District
I would like to send the voice alert on OWSO IVR to the citizen when completed with voice audio recording set by system admin
So that citizen can come to pick up at convenience OWSO busy hour

Chatbot - Schedule Notify on the late pick up within x day

As a system at Kamrieng District
I would like to send a text alert on OWSO Chatbot to the citizen to remind if they haven’t picked it up in x days after the service is completed in some cases with a template message set by the system admin
So that the citizen will get notifies to remind on this matter

Note: x can be set by the system admin

Chatbot - Notify incompleted tracking user when their ticket completed after an interval x

As a system at Kamrieng District
I would like to send the alert text on OWSO Chatbot to the citizen when completed with a template message set by system admin
So that citizen can come to pick up at convenience OWSO busy hour

Session Interaction Listing

Linechart - # of service access, applied, completed, total & average per day

Dockerize

Quota for broadcast messages in Messenger

Base on send-api rule, Messenger allows to broadcast messages follow:

1. Rate Limit:
   https://developers.facebook.com/docs/messenger-platform/reference/send-api

2. Block Rate:
   https://www.facebook.com/Owso-105474597800095/insights/?section=navMessages

Import sites via CSV with a pre-define template

"Piechart - an average day spent per each service

• Service A: 3.4 days
  • Service B: 2.8 days
  • ..etc."

Prevent null variable value

Site Management(CRUD) with site code

Site Telegram setting and configuration

As a system admin
I want to be able to configure Telegram bot(ID & Token) for each site and be able to configure a flag of notification option(immediately, or digest in day/week/month) and each site ombudsman can update setting later on
So that ombudsman will receive alert(s) via Telegram group from the citizen feedback following the option chosen

Telegram message template

As a system admin
I want to be able to design a message template for Telegram notification to ombudsmen group with an embed of some variables(caller id, text/voice recording url, ..etc.)
So that I can update template text/audio from time to time

Line chart - # of complaint received + average per day

Listview: monthly report with a total number of service served in each category

Variable Dictionary Mapping Design

IVR & Chatbot - Default incompleted & completed audios

As a system admin
I want to be able to set/upload incompleted & completed template text/audios(.mp3)
So that it will be used for incompleted & completed response when a citizen checking their ticket

IVR - Schedule Notify on the late pick up within x day

As a system at Kamrieng District
I would like to send a voice alert on OWSO IVR to the citizen to remind if they haven’t picked it up in x days after the service is completed in some cases with an audio voice recording set by the system admin
So that the citizen will get notifies to remind on this matter