Home
This is the WIKI for the bangpharma application which collects daily sales data from pharmacies. At the moment, this system is very simple and only asks one question per call.
-
Enrolled pharmacy flashes phone sitting at icddr,b office (local bangladesh number)
-
Upon receiving a missed call, the application Tasker sends an http request to bangpharma with the missed call number
-
Bangpharma then initiates a call back to the pharmacy (via Twillio)
-
Data from the call is sent back to and stored in bangpharma database
When we have no recorded sales data from a pharmacy within $max_lag hours bangpharma will initiate a call to one of the numbers from that pharmacy (TO DO: link to section on how phone number is chosen).
- Call initiated by bangpharma to pharmacy user
- Pharmacy user enters data and it is sent back and stored in bangpharma database
Study staff will register new pharmacies in the field. They will use SMS to provide the primary contact number for the pharmacy and the primary contact name.
- Study staff sends an sms "register " to +88xxxxxx (the phone at icddr,b)
- The phone at icddr,b will forward the sms to bangpharma
- the sms form will be checked and if it seems correct it will be logged in the database.
- Upon successful receipt of the name and number, bangpharma will send a confirmation along with the pharmacy id number. With the pharmacy id number, the pharmacy can now use the system and register new numbers by calling themselves.
TO DO:
The cellphone at icddr,b uses a program called tasker to pass incoming calls and texts to bangpharma. Tasker should be set up on the phone but in case it needs to be re-setup, the following section includes all the neccesary details.
-
Tasker should be on the phone but in case it is not it can be downloaded through google play. You may need to sign on to the google account (ADD account details here) to download tasker.
-
After installing.....
-
Go to the TASK tab
-
Create new task with + button
-
Set the name to
Incoming SMS -
(+) button -> Net button -> HTTP Post
-
Use the following settings:
-
Server:Port ->
my_domain/bangpharma -
Path ->
new_sms -
Data / File ->
sender=%SMSRFtext=%SMSRB -
Timeout ->
20seconds
-
-
Click the check mark to save this task
-
Now create another task called
Incoming Call(using the + button) -
- button -> Net button -> HTTP Get
-
Use the following settings:
-
Server:Port ->
my_domain/bangpharma -
Path ->
make_call/%CNUM/1 -
Timeout ->
20
-
Click the check mark to save this task
-
Now go to the Profiles tab and create a new profile (using the + button)
-
New Profile Name -> Missed Call
-
Select Event -> Phone -> Missed Call
-
Do not enter anything in the Caller field and press the check button
-
Task Selection -> Incoming Call
-
Now the profile for missed calls is set up. Next we will set up the profile for incoming SMS messages in a similar manner.
-
Press the + button from the Profiles tab
-
Profile Name -> Receive SMS
-
Select Event -> Phone -> Received Text
-
Do not enter anything any field and press the check mark
-
Task Selection -> Incoming SMS
-
Now your profiles and tasks are set up
-
Now you can press the On button in the bottom right corner to turn tasker profiles on (green indicates that it is on)
-
You should see the tasker logo on the top menu bar when active
-
You can now exit the program by pressing the home button
Problem: Tasker not forwarding calls or messages
Solution: First try turning tasker off then restarting. If this doesn't work try resetting the phone. Remember tasker is off, pharmacies cannot interact with bangpharma so try to do this quickly.
- error codes
- 1 --> failed during /how_many_ors
- 2 --> failed during /verify_ors
- 7 --> fallback error (general)
We are using mailgun to send emails. At the moment we only have 200 free emails a day so we need to be careful and monitor this.
TO DO: describe how sms conversations are tracked