# Zalo Settings (Proxies, Tags & Message Templates)

Alongside channel accounts, OmnyBot provides three operational tools for Zalo and Inbox workflows: **Proxies**, **Tags**, and **Message Templates**.

## 1. Proxies (`/{slug}/channels/zalo?tab=proxies`)

Proxies isolate IP addresses when operating multiple Zalo accounts simultaneously. Access this section via the **Proxy** tab inside **Channels → Zalo** (or directly at `/{slug}/proxies`; the legacy route `/{slug}/zalo-settings/proxies` redirects to `/{slug}/proxies`).

:::note[Required permission for Proxies]
Viewing, adding, testing, and deleting proxies requires the **`nick:operate`** permission.
:::

### Bulk Import Proxies

1. Click **Add Proxy** and choose an input method:
   - **Paste list**: One proxy per line using `host:port` (no auth) or `host:port:user:pass` (with auth).
   - **Upload file**: Select a `.txt` or `.csv` file with one proxy per line in the same format.
2. In the right-hand settings panel, configure:
   - **Protocol (Scheme)**: `HTTP`, `HTTPS`, or `SOCKS5` (applied to all proxies in the batch).
   - **Max accounts per proxy**: Choose `1`, `2`, `3` (default), `4`, `5`, or `10`.
3. Confirm the import. Up to **500 proxies** can be imported per batch; malformed lines and duplicate `host:port` entries are automatically skipped.

### Health Checks & Management

- **Filter & Sort**: Search by host, filter by health status (`HEALTHY`, `DEAD`, `UNKNOWN`), and sort by host/region, latency (`latencyMs`), or last checked timestamp.
- **Test Proxies**: Run single or bulk health checks to measure latency and update status (rate-limited to **20 tests/minute**).
- **Delete Proxies**: Delete individual proxies or select multiple rows for bulk deletion.

## 2. Tags (`/{slug}/tags`)

Tags help categorize and filter contacts in the Inbox. Access them under **Build → Tags** in the sidebar (the legacy route `/{slug}/zalo-settings/tags` redirects to `/{slug}/tags`).

:::note[Required permissions for Tags]
- **View tags**: **`inbox:read:all`**.
- **Create, edit, or delete tags**: **`inbox:reply`** or **`workspace:manage`**.
:::

- **Create a tag**: Click **Add Tag**, enter a unique name (up to **20 characters**), and pick a color.
- **Search & Sort**: Search by tag name and sort by tagged contact count, name, or creation date.
- **Edit & Delete**:
  - Renaming or recoloring a tag cascades automatically to all contacts carrying that tag.
  - Deleting a tag strips it from all associated contacts.

## 3. Message Templates (`/{slug}/zalo-settings/templates`)

**Message Templates** (canned replies / snippets) store reusable responses for quick insertion while replying in the Inbox (`/{slug}/message-templates` and `/{slug}/zalo-settings` redirect here automatically).

:::note[Required permission for Message Templates]
Viewing, creating, editing, and deleting message templates requires the **`inbox:reply`** permission.
:::

- **Create / Edit a template**: Click **Add Template** (or click an existing item) and fill in:
  - **Title**: Descriptive label (up to **120 characters**).
  - **Shortcut**: Optional trigger (up to **50 characters**, e.g. `/hello`, `/bank`) for quick recall in chat.
  - **Content**: Template message body (up to **20,000 characters**).
- **Search & Delete**: Filter by title or body content, and delete unused templates via the **`⋮`** menu.

## Related Guides

- [Connect Zalo](/channels/zalo/)
- [Channels Overview](/channels/overview/)