RxSavings & PharmacySelect Webhooks

Akute's automated Prescription Medication Adherence programs (RxSavings & PharmacySelect) are also available to be routed to your clinic via webhook if you are on our Developer plan. This allows you to send the messages to the patient via your own pre-designated channels with patients, increasing trust with your patients and providing more control over brand image.

The webhook will be sent to your designated endpoint at the time a prescription is approved. When this occurs, your endpoint will receive a webhook with the following structures:

{
  "event_id": "evt-7c9e2b1a4f6d4058a3e2c1d0b9a8f7e6",
  "event_type": "create",
  "resource_type": "Prescription Adherence",
  "patient_id": "3d813cbb-47fb-32ba-91ac-fac188df6d12",
  "external_patient_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "data": {
    "prescription_id": 460266521,
    "pharmacy_select_link": "https://pharmacyconnect-staging.rxlink.com/?p=Ge9MM",
    "coupon_price_cents": 130,
    "has_pharmacy_changed": false,
    "sms_type": "pharmacy_select",
    "coupon_card": {
      "bin": "019876",
      "pcn": "CHIPPO",
      "group_id": "VKDOSE",
      "member_id": "RK5FPTH6ZX"
    },
    "sms_templates": [
      {
        "language": "en",
        "manufacturer_coupon": false,
        "body": "Your prescription for Met*** is being sent to Shollenberger Pharma.\r\nBy switching pharmacies, you can save money on this prescription.\r\nIf you’d like to pick this up at another pharmacy, please click: pharmacyconnect-staging.rxlink.com/?p=Ge9MM\r\nTo save, show code below at Shollenberger Pharma for discount.\r\n\r\nBIN: 019876\r\nPCN: CHIPPO\r\nGRP: VKDOSE\r\nID: RK5FPTH6ZX\r\n\r\nReply 1 to repeat in Spanish. Responda 1 para español por mensaje de texto.\r\nSTOP to end. HELP for help."
      }
    ]
  }
}

OR

{
  "event_id": "evt-2b4f8c1e9a7043d6b5c4a3f2e1d0c9b8",
  "event_type": "create",
  "resource_type": "Medication Adherence",
  "patient_id": "3d813cbb-47fb-32ba-91ac-fac188df6d12",
  "external_patient_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "data": {
    "prescription_id": 1676,
    "pharmacy_select_link": "https://p-staging.rxlink.com/x?p=6SiT1",
    "coupon_price_cents": 3543,
    "has_pharmacy_changed": false,
    "sms_type": "rx_savings",
    "coupon_card": {
      "bin": "610378",
      "pcn": "SC1",
      "group_id": "RSDOSE",
      "member_id": "RXEE8NMQC"
    },
    "sms_templates": [
      {
        "language": "en",
        "manufacturer_coupon": false,
        "body": "Dr. Dicken wrote you a prescription for Ibu*** and Hyd***. \r\n\r\nProvide the code below at Ohio CVS Stores LLC and compare to their price so you don't overpay.\r\n\r\nBIN: 610378\r\nPCN: SC1\r\nGRP: RSDOSE\r\nID: RXEE8NMQC\r\n\r\nSTOP to end. Email help@rxlink.com for help"
      }
    ]
  }
}

where the primary differentiator is the data.sms_type  field indicating if the webhook is for a PharmacySelect event or RxSavings event.

Fields of Note:

  1. data.sms_templates[n].body
    1. To make forwarding to the patient simple, the webhook data includes pre-written message templates. Currently only english is included as the default language.
  2. data.coupon_card
    1. If you'd like to form your own custom message to send to patients, you can utilize the fields within this coupon_card object to send all the necessary coupon information to the patient.
  3. data.coupon_price_cents
    1. This provides the exact price the coupon will result in for the patient. Keep in mind that this number is in cents. So, if you plan to send this to the patient, consider converting to dollars to be more readable in the typical format.
  4. data.pharmacy_select_link
    1. The link the patient can use to change the pharmacy that the script is routed to on. their own, without intervention from the clinic. There is an expiration time on this link, and it is 20 minutes after the prescription is approved in Akute.

How to Setup:

  • As with all other webhooks, go to Settings->Developer, and add a new webhook. The resource type for these would be "Prescription Adherence" and "create" is the only trigger option. This will include webhooks for both PharmacySelect & RxSavings

Tips:

  1. For PharmacySelect webhooks, there is currently a 20 minute time limit on when the pharmacy_select_link can be utilized by the patient. And the 20 minutes starts from when the prescription was initially approved in Akute.

    For this reason, we highly encourage sending these messages out to patients ASAP once received to prevent delays and ensure a positive experience for your patients.

  2. If sending these messages yourself, the interactive elements of the message body such as: "reply 1 to repeat, "text HELP for help", "reply STOP to end" need to be either removed from any actual messages sent or updated to include your keywords. These are the templates designed for how Akute would send them, and we have setup handlers for replies such as STOP, HELP, and 1.