Skip to main content

Integrations

Payment processors

  • Stripe
  • PayPal (login required)
  • 1MerchantPay
  • PayMaya - a local provider operating in the Philippines.
  • HyperPay - a local provider operating in Saudi Arabia.

EHR/EMR systems

  • AthenaHealth - this is a one-way integration where Athena is the source of truth when it comes to provider practices and calendars. No practices/calendars are created in Healee but it reflects and displays the Athena schedules to patients. When a time slot is booked in either Athena or Healee, the data is sent over the API and the slot is booked in the respective platform. When patients books slots in Healee, not only is the appointment data sent to Athena but also the patient details such as name, DoB and phone number. If the patient record does not exist yet in Athena, it will get automatically created.

Messaging tools

  • AWS - used for sending out email notifications to patients and practitioners. This integration is turned on by default for all client replicas and is automatically covered for all pricing tiers. Clients need to provide their custom email address which will be utilized as the mailer daemon.
  • Twilio - allows the platform to send out automated SMS notifications that mirror the majority of email notifications. Clients need to sign up for Twilio and purchase a specific telephone number (this is valid for clients based in the United States due to national regulations).
  • Viber - sends automatic appointment reminders to patients.

e-Prescribing platforms

  • Bravado/DoseSpot - this API integration allows practitioners to log in via SSO into Bravado/DoseSpot from Healee. All e-prescriptions are created in the interface of Bravado/DoseSpot.

Calendars

  • Apple Calendar
  • Google Calendar
  • Outlook

Health tracking platforms

  • Apple Health

Setting up a Stripe integration

Webhook listeners

From the Stripe dashboard you would need to add the webhook listeners that subscriptions need. To do this:

  1. Go to the 'Developers' section, then from the menu on the left select 'Webhooks'
  2. In the 'Hosted endpoints' table select the /stripe-webhook one
  3. Then click the button with the 3 dots that is on the right from the webhook name (under the webhook ID)
  4. Select 'Update details'
  5. From the 'Events to send' dropbox select the following events:

customer.subscription.created customer.subscription.updated customer.subscription.deleted product.created product.updated product.deleted price.created price.updated price.deleted checkout.session.completed

  1. Click 'Update endpoint'

Products

If you have pre-existing products you'd like to use for subscriptions, you'll need to:

  1. Edit each of them
  2. Click 'Additional options'
  3. Click 'Add metadata'
  4. Enter 'isSubscription' as key, and 'true' as value
  5. Click 'Save product' from the top right

Upon saving the product, it will automatically be added to the database and be used in Healee. Same metadata field needs to be added when creating new products too.

If a product already contains the 'isSubscription' metadata, but for some reason is missing from the database and not showing in Healee, it can be added from the admin. Once you open the admin you go to 'Other' -> 'Updates' -> 'Sync Stripe Products with DB'.

Prices

When setting up a price for a subscription you need to make sure it is set as the Default one and that it is recurring. If you want to add a one-time fee to the subscription you need to:

  1. Create a new one-time price for the product of the subscription
  2. Copy the ID of the newly created price
  3. Inside the product's metadata (where the "isSubscription" property from the previous section is specified), add a new property called "oneTimeFee" and for its value - paste the ID of the newly created price
  4. Save the product

Also, if you want you can set a title for the one-time fee that will show in the product card on the "New subscription" screen. You can do it by going to the price creation or edit screen, click "Additional Options" and add it in the "Price description" box. If you don't provide one, a default "One-time fee" title will be shown.

Provider Webhook listeners

From the Stripe dashboard you would need to add the webhook listeners for account connect:

  1. Go to the 'Developers' section, then from the menu on the left select 'Webhooks'
  2. In the 'Hosted endpoints' table add new webhook
    1. Endpoint {healee-md-url}/stripe-connect-account-webhook
    2. Select Events on Connected accounts
    3. Add event account.updated
  3. Update config-md.json stripeConfig apiKey, secretApiKey, connectAccountEndpointSecret

AthenaHealth calendar integration

Requirements

  • Access should be given to the Healee app in Athena

How it works

A Healee practice is connected to a specific department-doctor practice in Athena. Reasons for visit will be automatically imported from Athena and used instead of the Healee list.

Calendars are taken from Athena - no workhours setup is possible in Healee.

Bookings made in Athena would not show up in Healee.

Bookings made in Healee are sent to Athena as well. Cancellations or Reschedules of those appointments can be made both in Healee and in Athena and the integration would sent the change to the other platform as well.

When making a booking in Healee, the integration first attempts to find the patient in Athena (by using date of birth, phone number, email, etc) and if there is a good match the booking will be attached to the existing patient. If a match has not been found, Healee will create a new patient in Athena.

Changes in Healee are sent to Athena immediately. Changes in Athena can take up to 5 minutes to show up in Healee.

Possible extension

We can easily add an possibility to work with Healee calendars instead. In this scenario the doctor will have no calendar working hours in Athena and will manage his working hours through Healee. Every time a booking is made, Healee will first create the slot in Athena and then book it.