Docs
Get started

One-tap copy code on WhatsApp

The copy code button drops any string straight onto the customer's clipboard with a single tap. Use it for promo codes, OTPs, account IDs, referral handles, anything you'd hate them to mistype. No copy gesture, no "Ctrl+C from the chat".

Overview

The copy code button is a multimedia message with image, title, subtitle and a button that performs a clipboard copy on tap. When the user taps, the predefined code is copied and the WhatsApp UI shows a brief confirmation toast ("The code has been copied"). It's a small UX detail that meaningfully boosts redemption rates on promotions.

★

Pair this button with a checkout URL or a link to your app. Customer copies the code, taps "go to checkout", paste, done. No keyboard, no typos, no abandoned carts.

Command syntax

#ButtonMix|Title|Subtitle|image*IMAGE_URL|copy*ButtonText*CodeValue

Field by field

  1. #ButtonMix declares a multimedia + button message.
  2. Title the bold heading above the image.
  3. Subtitle body text below the title.
  4. image*IMAGE_URL hero image (JPG, up to ~5 MB).
  5. copy*ButtonText*CodeValue defines the copy button:
    • ButtonText is the label of the button (for example Copy code).
    • CodeValue is the exact string that gets copied to the user's clipboard.

Example

A promo-code drop with hero image and a "Copy code" button:

#ButtonMix|Your VIP discount|Use this code at checkout for 20% off.|image*https://cdn.example.com/promo.jpg|copy*Copy code*VIP20WAZZAP

Result on WhatsApp

  1. The user receives a message with an image, a title, a subtitle and a Copy code button.
  2. Tapping the button copies the predefined code (VIP20WAZZAP in the example) to their clipboard.
  3. A short confirmation appears in WhatsApp ("The code has been copied").
  4. They paste wherever they need it.

Important notes

  1. The image must be in .jpg format. Maximum size depends on your CRM, commonly 5 MB. See the HighLevel integration.
  2. Use short, clear button text: Copy code, Grab promo, Copy OTP.
  3. Make sure the code value is correct and final before sending. Users copy it verbatim.
  4. This button does not send a response ID back to your CRM. It performs a pure clipboard copy. If you need to know who tapped, send the code with a unique value per recipient and listen for redemption on your checkout/auth side.
!

Send the command from the Conversations tab of your CRM, never from the WhatsApp app on your phone. The command must be the only content in the message body.

Troubleshooting

The button copies an empty string

The CodeValue field was empty in your command. Double-check the template: copy*ButtonText*CodeValue. There must be a non-empty value after the second *.

The customer says nothing happened when they tapped

WhatsApp's confirmation toast is brief. Some users miss it. The code is still copied. Suggest they paste in their next message field to verify, or add a follow-up message reminding them where to paste.

The card sends as plain text

The command was malformed or sent from the WhatsApp app. Use the exact template, send from your CRM's Conversations tab, and make sure the command line has nothing before or after it.

★

Combine this with a URL button follow-up: first message drops the code on their clipboard, second message links to checkout. Two taps from chat to conversion.

Was this page helpful?