> ## Documentation Index
> Fetch the complete documentation index at: https://docs.referbro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Template Library

> Ready-to-use WhatsApp message templates for every Referbro touchpoint

Below are ready-to-use WhatsApp template examples for all 8 Referbro touchpoints. Copy and customize these for your brand, then create them on your WhatsApp provider's platform.

When you're ready to map approved templates in the app, use the [WhatsApp templates setup Scribe](https://scribehow.com/viewer/How_to_Configure_WhatsApp_Templates_in_Referbro__UZFYf1rdTy6GsTengQCjag).

<Note>
  Templates must be **approved by Meta** before they can be used. Submit them on your provider's platform (e.g., Pragma, Meta Business Suite) and wait for approval before mapping them in Referbro.
</Note>

***

## 1. Referral Invitation

**Trigger:** Customer clicks "Share on WhatsApp"

<CodeGroup>
  ```text Template Body theme={null}
  Hey! 🎉

  We’ve generated a referral link for you.
  Share it with friends, and they'll get {{1}} OFF, while you earn {{2}} when they buy.

  👇 Tap to shop using this link: {{3}}
  See you there!
  ```

  ```json Referbro Parameter Mapping theme={null}
  {
    "body.1": "{{FRIEND_REWARD}}",
    "body.2": "{{CREDIT_AMOUNT}}",
    "body.3": "{{REFERRAL_LINK}}&source=widget",
    "languageCode": "en",
    "button.url.0.1": "{{REFERRAL_CODE}}&source=widget_cta"
  }
  ```

  ```text Example Rendered Message theme={null}
  Hey! 🎉

  We’ve generated a referral link for you.
  Share it with friends, and they'll get ₹500 OFF, while you earn ₹500 when they buy.

  👇 Tap to shop using this link: https://yourstore.com?ref=JOHN-AB12&source=widget
  See you there!
  ```
</CodeGroup>

***

## 2. Order Confirmation

**Trigger:** After customer completes an order

<CodeGroup>
  ```text Template Body theme={null}
  Thanks for your order, {{1}}! 🛍️

  Love what you got? Share with friends — they get {{2}} OFF, and you earn {{3}} when they buy!

  Share now 👇
  {{4}}
  ```

  ```json Referbro Parameter Mapping theme={null}
  {
    "body.1": "{{FIRST_NAME}}",
    "body.2": "{{FRIEND_REWARD}}",
    "body.3": "{{CREDIT_AMOUNT}}",
    "body.4": "{{REFERRAL_LINK}}&source=order",
    "languageCode": "en",
    "button.url.0.1": "{{REFERRAL_CODE}}&source=order_cta"
  }
  ```

  ```text Example Rendered Message theme={null}
  Thanks for your order, John! 🛍️

  Love what you got? Share with friends — they get ₹150 OFF, and you earn ₹150 when they buy!

  Share now 👇
  https://yourstore.com?ref=JOHN-AB12&source=order
  ```
</CodeGroup>

***

## 3. Delivery Notification

**Trigger:** When the order is marked as delivered

<CodeGroup>
  ```text Template Body theme={null}
  Your order has arrived, {{1}}! 📦

  Loved what you got? Share with friends and earn {{2}} for every friend who buys.

  Spread the love 👇
  {{3}}
  ```

  ```json Referbro Parameter Mapping theme={null}
  {
    "body.1": "{{FIRST_NAME}}",
    "body.2": "{{CREDIT_AMOUNT}}",
    "body.3": "{{REFERRAL_LINK}}&source=delivery",
    "languageCode": "en",
    "button.url.0.1": "{{REFERRAL_CODE}}&source=delivery_cta"
  }
  ```

  ```text Example Rendered Message theme={null}
  Your order has arrived, John! 📦

  Loved what you got? Share with friends and earn ₹150 for every friend who buys.

  Spread the love 👇
  https://yourstore.com?ref=JOHN-AB12&source=delivery
  ```
</CodeGroup>

***

## 4. Post Delivery Followup

**Trigger:** X days after delivery

<CodeGroup>
  ```text Template Body theme={null}
  Hi {{1}}! 😊

  It's been a few days — how are you enjoying your purchase? Your friends would love it too!

  Share your link and earn {{2}} for every friend who buys 👇
  {{3}}
  ```

  ```json Referbro Parameter Mapping theme={null}
  {
    "body.1": "{{FIRST_NAME}}",
    "body.2": "{{CREDIT_AMOUNT}}",
    "body.3": "{{REFERRAL_LINK}}&source=followup",
    "languageCode": "en",
    "button.url.0.1": "{{REFERRAL_CODE}}&source=followup_cta"
  }
  ```

  ```text Example Rendered Message theme={null}
  Hi John! 😊

  It's been a few days — how are you enjoying your purchase? Your friends would love it too!

  Share your link and earn ₹150 for every friend who buys 👇
  https://yourstore.com?ref=JOHN-AB12&source=followup
  ```
</CodeGroup>

***

## 5. Post-Referral Follow-up

**Trigger:** After a successful referral

<CodeGroup>
  ```text Template Body theme={null}
  Great news, {{1}}! 🙌

  Your friend just used your referral link and placed an order. Your reward of {{2}} will be credited after the return window.

  Keep sharing to earn more! 👇
  {{3}}
  ```

  ```json Referbro Parameter Mapping theme={null}
  {
    "body.1": "{{FIRST_NAME}}",
    "body.2": "{{CREDIT_AMOUNT}}",
    "body.3": "{{REFERRAL_LINK}}&source=post_referral",
    "languageCode": "en",
    "button.url.0.1": "{{REFERRAL_CODE}}&source=post_referral_cta"
  }
  ```

  ```text Example Rendered Message theme={null}
  Great news, John! 🙌

  Your friend just used your referral link and placed an order. Your reward of ₹150 will be credited after the return window.

  Keep sharing to earn more! 👇
  https://yourstore.com?ref=JOHN-AB12&source=post_referral
  ```
</CodeGroup>

***

## 6. Referrer Delivery Notification

**Trigger:** When a referred friend's order is delivered

<CodeGroup>
  ```text Template Body theme={null}
  Hey {{1}}! 🎁

  Your friend just received their order — they're going to love it! Your reward will be credited soon.

  Keep sharing to earn even more 👇
  {{2}}
  ```

  ```json Referbro Parameter Mapping theme={null}
  {
    "body.1": "{{FIRST_NAME}}",
    "body.2": "{{REFERRAL_LINK}}&source=referrer_delivery",
    "languageCode": "en",
    "button.url.0.1": "{{REFERRAL_CODE}}&source=referrer_delivery_cta"
  }
  ```

  ```text Example Rendered Message theme={null}
  Hey John! 🎁

  Your friend just received their order — they're going to love it! Your reward will be credited soon.

  Keep sharing to earn even more 👇
  https://yourstore.com?ref=JOHN-AB12&source=referrer_delivery
  ```
</CodeGroup>

***

## 7. Reward Notification

**Trigger:** When referrer's reward is issued

<CodeGroup>
  ```text Template Body theme={null}
  🎉 Congratulations, {{1}}!

  You've earned {{2}} from a successful referral. Your reward has been credited to your account.

  Use this link to auto-apply your discount on your next purchase! 👇
  {{3}}
  ```

  ```json Referbro Parameter Mapping theme={null}
  {
    "body.1": "{{REFERRER_NAME}}",
    "body.2": "{{DISCOUNT_VALUE}}",
    "body.3": "{{DISCOUNT_URL}}",
    "languageCode": "en",
    "button.url.0.1": "{{DISCOUNT_CODE}}"
  }
  ```

  ```text Example Rendered Message theme={null}
  🎉 Congratulations, John!

  You've earned ₹150 off from a successful referral. Your reward has been credited to your account.

  Use this link to auto-apply your discount on your next purchase! 👇
  https://yourstore.com/discount/SAVE-123
  ```
</CodeGroup>

<Tip>
  Reward Notification variables depend on the configured referrer reward type:

  * **Gift Card**: Use `{{REFERRER_NAME}}`, `{{GIFT_CODE}}`, `{{PRODUCT_NAME}}`, `{{GIFT_URL}}`
  * **Discount Code (Flat/Percentage)**: Use `{{REFERRER_NAME}}`, `{{DISCOUNT_CODE}}`, `{{DISCOUNT_VALUE}}`, `{{DISCOUNT_URL}}`
  * **Store Credit**: Use `{{REFERRER_NAME}}`, `{{CREDIT_AMOUNT}}`, `{{CURRENCY_CODE}}`, `{{BALANCE_AFTER}}`

  Do not mix gift and discount placeholders in the same template unless your flow guarantees both sets are present.
</Tip>

***

## 8. Nudge Reminder

**Trigger:** Scheduled reminder for dormant referrers

<CodeGroup>
  ```text Template Body theme={null}
  Hey {{1}}! 👋

  You haven't shared your referral link in a while. Your friends are missing out on {{2}} OFF!

  Share now and earn for every friend who buys 👇
  {{3}}
  ```

  ```json Referbro Parameter Mapping theme={null}
  {
    "body.1": "{{FIRST_NAME}}",
    "body.2": "{{FRIEND_REWARD}}",
    "body.3": "{{REFERRAL_LINK}}&source=nudge",
    "languageCode": "en",
    "button.url.0.1": "{{REFERRAL_CODE}}&source=nudge_cta"
  }
  ```

  ```text Example Rendered Message theme={null}
  Hey John! 👋

  You haven't shared your referral link in a while. Your friends are missing out on ₹150 OFF!

  Share now and earn for every friend who buys 👇
  https://yourstore.com?ref=JOHN-AB12&source=nudge
  ```
</CodeGroup>

***

## CTA Button Configuration

A Call-To-Action (CTA) URL button allows your customers to seamlessly share a customized message provided by your brand with a single tap. **This is applicable to all templates** in the library.

When creating templates in your WhatsApp provider (e.g., Meta, Pragma), configure a **URL Button**:

* **Button Text:** `Share on WhatsApp` (or similar)
* **Base URL:** `https://server.referbro.com/whatsapp/share?referralCode=`
* **URL Variable (e.g., `{{1}}`):** This parameter needs to be mapped like `button.url.0.1` in your JSON parameter mapping, using `{{REFERRAL_CODE}}` (and optionally `&source=...`).

<Note>
  The exact parameter mapping format changes based on your specific WhatsApp provider (e.g., Meta vs. Pragma). Please check your provider's setup documentation on how to correctly map button URL fields in your JSON payload.
</Note>

***

## Tips for Writing Templates

* **Do not start or end with a variable** — Avoid placeholders like `{{1}}` at the beginning or end of text; keep clear context before and after each variable.
* **Number variables sequentially** — Always use placeholders in chronological order (`{{1}}`, then `{{2}}`, then `{{3}}`, etc.). Never use `{{2}}` before `{{1}}`.
* **Separate nearby variables** — Do not place placeholders back-to-back (for example, `{{1}} {{2}}`). Add words or punctuation between them so intent is clear.
* **Body length limit: 1,024 characters max** — Keep message bodies within Meta's limit to avoid approval issues.
* **Header length limit: 60 characters max** — Keep headers concise and compliant.
* **Button length limit: 25 characters per button** — Keep CTA labels short and readable.
* **Use emojis sparingly** — 1–2 per message adds personality. More than that looks spammy.
* **Include a clear CTA** — Every message should end with a link or button to take action.
* **Personalize with `{{FIRST_NAME}}`** — Messages with the customer's name have significantly higher engagement.
* **Track sources with `&source=`** — Append `&source=touchpoint_name` to your referral links to see which messages drive the most conversions in Analytics.

<Tip>
  For faster setup, paste your approved template text and Referbro placeholder docs into ChatGPT (or any AI agent) and ask it to generate the full Referbro parameter mapping JSON. Review the output once before saving in WhatsApp Settings.
</Tip>