Aditya Vaidyam, Apoorva Bhagwat, Hayley Chan, Justin Joco, Kunal Sinha, Celine Chang


A new Alexa skill that helps make the process of visiting the doctor easier made at HackIllinois 2017. You can tell MyDoctor your symptoms, and MyDoctor will send your symptoms to your doctor using medical industry standard codes and create an appointment. You're welcome to add as many symptoms as you'd like, and we'll send your doctor what we think is the symptom you're describing as well as alternatives.


We discovered that most medical software happens to be designed for interaction between healthcare providers, but very few bridge the gap between patient and physician effectively by eliminating a pain point. We opted to build a tool with a dead simple interaction model -- which happens to be voice input. We didn't want to be armchair physicans and diagnose the user, using technology and abilities we didn't have -- that would not just be unhelpful, but likely dangerous. We instead figured that we needed to find a way to get the patient to the physician much faster. The answer was MyDoctor (or YourDoctor, depending on what you like).


  1. Obtain an email address, IMO API, Twilio API, and API.AI API keys. (Preface of
  2. Obtain PythonAnywhere, Microsoft Azure, Google App Engine, or Firebase platform hosting.
  3. Create a new Alexa skill and use the configuration in to configure it.
  4. Select the 2nd option when prompted for SSL certification.
  5. Create a new API.AI Intent and load the symptom contexts ("User says...") from
  6. Create (purchase) a managed phone number in Twilio.
  7. Create a new Gmail account.
  8. Load into the hosting platform you selected earlier.
  9. ???
  10. Profit!


Ex. 1)

  • Hey Alexa, talk to MyDoctor
    Alexa: I'm Your Doctor. You can list your symptoms to me and say Done when you're finished. I'll make an appointment for you.
  • I have a symptom.
    Alexa: Your symptom was symptom name. Anything else?
  • I have a symptom.
    Alexa: Your symptom was symptom name. Anything else?
  • Done.
    Alexa: Your symptoms seem to be symptom list. I've made an appointment for appointment time with your doctor.
    Twilio: Hello doctor name. Your patient user name has made an appointment for appointment time with the following symptoms: symptom list. Thank you.
    Email: {user spoken symptom => detailed possible IMO codes}

Contributor Guide



Share this project: