---
title: URL Button
slug: url-button
docTags: 
createdAt: 2025-08-18T14:07:49.350Z
---

### Introduction

This command allows you to send an image with buttons that redirect the user to external links. It is useful for CTAs such as “Visit Website”, “Open Account”, or “Contact Us”.

:::hint{type="info"}
⚠️ URLs must be properly **encoded** before being used in the command.
:::

::Image[]{src="https://api.archbee.com/api/optimize/srzEvL3tK0Cgq-VfwOzrO/pthoEr89-syCAo6V4OGDt_image.png" size="44" width="552" height="544" position="center" caption="Preview" showCaption="true"}

### Command Syntax

:::BlockQuote
\#ButtonMix|Title|Subtitle|image\*IMAGE\_URL|url\*ButtonText1\*ENCODED\_URL1/url\*ButtonText2\*ENCODED\_URL2
:::

### How it works

1. **#ButtonMix** → Defines the message type (multimedia with buttons).
2. **Title** → Main text displayed above the image.
3. **Subtitle** → Secondary text displayed below the title.
4. **image\*IMAGE\_URL** → Link to the image file in .jpg format (file size depends on CRM, commonly up to 5 MB).
5. **url*ButtonText*ENCODED\_URL** → Defines a URL button:
   - ButtonText → The text displayed on the button (e.g., *Visit Web*).
   - ENCODED\_URL → The link that opens when the user clicks the button.
   - The URL **must be encoded** using a tool such as https\://www\.urlencoder.org/.

### Example

Command:

:::BlockQuote
\#ButtonMix|Title|Subtitle|image\*https\://wisphub.io/static/img/wisp-bg-5.jpg|url\*Visit Web\*https%3A%2F%2Fwww\.google.com/url\*Contact\*https%3A%2F%2Fwww\.facebook.com
:::

Encoding example (Google):

- Original URL:
- After encoding with https\://www\.urlencoder.org/ → press **Encode** and copy the result as plain text:

::Image[]{src="https://api.archbee.com/api/optimize/srzEvL3tK0Cgq-VfwOzrO/QWyqE8DeWFyFm340SDxo1_image.png" size="30" width="413" height="722" position="center" showCaption="false"}

### Result 

1. The user receives a message with an **image**, a **title, subtitle**, and **URL buttons**.
2. When a button is clicked, the user is redirected to the encoded URL.
3. The CRM may log the click event, depending on integration.

### ⚠️ Important Notes

1. The image must be in **.jpg** format only. Maximum file size depends on your CRM (commonly 5 MB).
   - Highlevel CRM Integration
2. All URLs must be **encoded before use**, otherwise the button will not work.
3. Use clear and short button texts (e.g., *Visit Web*, *Contact*).
4. URLs should always be pasted as **plain text** after encoding.