WhatsApp deep links

Joy is Rehabify's WhatsApp care assistant, on +234 806 152 5811. A WhatsApp deep link opens a chat with Joy that's pre-filled with a referral's tracking code. When the patient sends the message, Joy links the conversation to that referral, and intake starts straight away.

Format

https://wa.me/2348061525811?text=START%20RHB-XXXXXXXXXX

• 2348061525811 is Joy's WhatsApp number.
• text=START%20RHB-XXXXXXXXXX pre-fills the message START RHB-XXXXXXXXXX. %20 is the URL-encoded space, and RHB-XXXXXXXXXX is the referral's tracking code (RHB- followed by 10 digits).

Example:

https://wa.me/2348061525811?text=START%20RHB-4829173655

Where to get the link

You don't need to build it yourself. Rehabify returns it ready to use:

If you do need to build one from a stored tracking code, URL-encode the message:

const trackingCode = "RHB-4829173655";
const url = `https://wa.me/2348061525811?text=${encodeURIComponent(`START ${trackingCode}`)}`;
console.log(url); // https://wa.me/2348061525811?text=START%20RHB-4829173655

How attribution works

1. You create a referral (by API, referral link or the Partner Portal). It gets a unique tracking_code that belongs to your organisation.
2. The patient taps the deep link and sends START RHB-… to Joy.
3. Joy matches the tracking code to your referral (tracking codes are case-insensitive). If the referral is still received, it moves to contacted, and referral.contacted fires to your webhook endpoint.
4. The patient is attributed to you, so their verified paid bookings earn you commission under your commercial terms.

A plain https://wa.me/2348061525811 link, with no tracking code, opens a chat with Joy but isn't linked to any referral or partner.

Sharing the link

• SMS or email: send it right after you create the referral, for example: "Tap to start your physiotherapy with Rehabify on WhatsApp: https://wa.me/2348061525811?text=START%20RHB-4829173655".
• In your app: show it as a "Chat with Joy on WhatsApp" button.
• QR code: encode the full URL with any QR generator, for example on a printed referral slip for that patient. Each code belongs to one referral, so don't reuse one patient's QR code for another patient. For posters and shared QR codes, use a referral link instead.

Good practice

• Use the exact URL from the API. Don't invent tracking codes or change their format.
• Don't add patient names or health details to the text parameter. The tracking code is all Joy needs.
• Each referral's tracking page (links.tracking_url, at https://physioaroundme.com/track/<tracking_code>) shows only the status timeline, so it's safe to share alongside the deep link.