The Webhooks page and unmatched webhooks
Qualiphy sends your site a status update, called a webhook, whenever a consultation result, prescription or tracking number comes in, and Quidget uses it to update the matching order. From version 1.2.5 there’s nothing to set up: the plugin registers your site’s webhook address with Qualiphy itself, and the Webhooks page shows whether that worked and what has arrived.
Automatic registration
- Each API key is registered separately: your main key and, with Location Based API Keys, every verified clinic key.
- Registration runs whenever a key is verified (the setup wizard, re-verifying on the API Key card, clinic key checks and the connection test), and a daily check catches a changed key or site address. Existing sites register shortly after updating.
- If Qualiphy refuses a consultation because the address isn’t registered, the plugin registers it on the spot and sends the invite once more.
You don’t need to add a webhook address in your Qualiphy account.
Verified and unverified webhooks
Each webhook is checked to confirm it came from Qualiphy. Only verified webhooks can refund a Not approved order automatically. Unverified webhooks still update the order (status, emails and subscriptions), but the refund is left to you, with the note “Refund not issued automatically: this webhook couldn’t be verified as coming from Qualiphy. Refund manually if appropriate.” When you see it, refund by hand if appropriate, then check the Webhooks page shows Registered for the key the order used.
Opening the Webhooks page
- Go to Qualiphy → Settings.
- In General Settings, turn on Advanced Settings.
- On the Webhooks row, click View webhooks. The row shows an “N unmatched” badge when webhooks are waiting.
The page isn’t in the Qualiphy menu; the “Qualiphy webhooks need attention” notification and the System Log also link to it. Only administrators can open it. It has three cards.
Webhook registration
One row per API key (“Main account”, “Clinic: [name]”) showing Registered, Not registered with Qualiphy’s reason, or Not registered yet, plus the last 4 characters of its signing key. Buttons: Register now, Re-register (new signing key) and Check all.
Unmatched webhooks
A webhook that matches no order is kept here for 30 days, and you get a “Qualiphy webhooks need attention” notification. This usually means the order’s invite failed or the consultation was sent outside that order. For each row:
- Pick the order (orders with the patient’s email are suggested first) and press Process. The order then updates, and later updates for that consultation match on their own.
- Leave it on “Match automatically” to retry, or press Process all to retry every row.
- Press Dismiss to delete it.
Rows marked “Not verified as sent by Qualiphy. Processing it will not refund automatically.” still update the order when processed. Assigning an order doesn’t make them verified.
Recent webhooks
The last 100 outcomes, such as Processed, Processed (repeat of a decision already applied), No matching order, Dismissed, or Rejected with a reason like “too many requests” or “invalid request body”. Only order and consultation IDs are kept, no patient details. Repeats are normal: Qualiphy sends each result more than once and Quidget applies it once.
When registration shows a problem
Fix the cause shown on the row, then press Register now.
Updates not reaching your site
If a consultation happened but nothing appears under Recent webhooks, the update never arrived. Check security and firewall plugins, firewall rules at your host or CDN, maintenance mode, password protection and caching rules: anything that blocks inbound requests from Qualiphy to your site’s WordPress REST API stops status updates. See Known plugin conflicts. What each update does to an order is in Consultation results.
Still stuck? We're quick to respond.
Email [email protected]. Available 7 days a week, 7 AM to 6 PM PT.