Zayenha Link Usage Guide

1. Getting Started

Welcome to Zayenha Link. You can get started in 3 simple steps:

1. Log in with your Zayenha Hub account — one unified account for all Zayenha apps
2. Go to your Dashboard — /dashboard
3. Paste a long URL and click "Shorten"

2. Shorten Your First Link

From your dashboard, paste your long URL in the input field and click "Shorten". In a second, you get a short link on the zaye.cc domain.

Example:

Original:  https://example.com/very/long/path/to/article?utm_source=email&...
Shortened: https://zaye.cc/article23

3. Custom Alias

Instead of random codes like zaye.cc/abc123, choose a custom alias that reflects your brand:

https://zaye.cc/my-product
https://zaye.cc/summer-sale
https://zaye.cc/ramadan2026

• Supports Latin letters, digits, hyphens, and underscores
• 2 to 32 characters
• Available in Starter plan and above

4. UTM Builder

Add UTM parameters (utm_source, utm_medium, utm_campaign...) to your link in Google Analytics-compatible format, either at link-creation time or via the standalone tool.

Free tool (no signup): /tools/utm-builder. The parameters are actually appended to the destination URL and show up in Google Analytics or any other marketing tool.

5. Smart Redirect

One link, multiple destinations: automatically route visitors by their phone OS (iOS/Android), country, or time of visit — without ever changing the link you shared.

• By device: open the correct app store (App Store/Play Store) based on visitor OS
• By country: from your dashboard → link details → Geo-targeting, set a different destination per country
• By time: smart rules triggered by the hour of the visit (Riyadh time) — available in Pro+ plans

6. Reading Analytics

Every link has a detailed analytics dashboard showing:

• Total clicks — with daily/weekly/monthly breakdown
• Geography — country and city (Business)
• Devices — mobile, tablet, desktop, OS
• Referrer — where the visitor came from
• Time — hourly heat map (available on every plan)

Export:

Export your data to CSV using the "Export" button on the link page — useful for archiving campaigns.

7. QR Codes

Every link comes with a free downloadable QR code in high resolution (PNG / SVG / PDF). Each QR scan counts as a click in your analytics.

Use cases:

• Restaurant menus & business cards
• Print ads (billboards, newspapers)
• Events & exhibitions
• Product packaging

Full guide: turn a link into a QR code ←

8. Zayenha Bio (separate product)

Want a "link in bio" page that gathers all your links in one place for Instagram, TikTok, and Snapchat? That is Zayenha Bio — a separate sibling product to Zayenha Link, with an Arabic-first interface, Gulf analytics, and dozens of templates.

Open Zayenha Bio ← bioz.cc

9. Digital Business Card + NFC

Replace paper business cards with a single short-URL card. Manage at /dashboard/business-card. Available in Pro+.

Supported fields

• Name, job title, company (Arabic + English)
• Short bio ≤ 280 chars
• Mobile, WhatsApp, email, website, address
• Social handles: LinkedIn, X, Instagram, GitHub, YouTube, TikTok
• Profile photo + custom primary color

How to use it with NFC

1. Create your card and pick a short slug (e.g. john-doe)
2. Your public URL becomes: zaye.cc/card/john-doe
3. Buy a blank NFC sticker/card from any store (~5 SAR)
4. Install "NFC Tools" on Android, write the URL onto the card
5. Now anyone who taps their phone on your card → opens your digital card instantly

VCF download

Your public card has a "Save Contact" button that downloads a standards-compliant vCard (RFC 6350). iPhone + Android both save it directly to Contacts.

Every view and every VCF download is logged in your card stats — so you know who viewed and who saved.

10. WhatsApp Campaigns

A unique Zayenha Link feature: create ready-to-use WhatsApp links with customizable messages and dynamic variables:

Format:
https://zaye.cc/wa/{{name}}/{{phone}}/{{message}}

Example:
https://zaye.cc/wa/علي/966500000000/مرحباً+من+الحملة

• Ready templates (marketing, invite, reminder, offer)
• Track link opens AND WhatsApp message clicks
• Dynamic variables: {{name}}, {{phone}}, {{link}}

11. Gulf Calendar Links

Unique in the Arab world: links that automatically change destination based on the Hijri calendar and Saudi occasions.

Built-in occasions:

• Ramadan (1-29/30 Ramadan)
• Eid al-Fitr (1-3 Shawwal)
• Eid al-Adha (10-13 Dhul-Hijjah)
• Hijri New Year (1 Muharram)
• Saudi National Day (Sep 23)
• Founding Day (Feb 22)
• UAE National Day (Dec 2)
• Custom occasion — you set the start and end dates (repeats yearly)

Hijri dates follow the official Umm al-Qura calendar and are covered through 2030 (no drifting approximation).

How to set it up:

1. From your dashboard, open the advanced options (⋮) next to the link.
2. Choose “Gulf Calendar Links”.
3. Pick the occasion, set its destination, and save. The page shows you which destination is live today.

12. Per-link Webhooks

Get instant notifications in Slack, Discord, or your own system on every link click. Available in Pro+ plans.

Supported events:

• click — on every click
• unique_click — on each unique visitor
• daily_summary — daily roll-up at 8am Riyadh time

Manage them from your dashboard: open the advanced options (⋮) next to a link, then Webhooks. Each webhook ships with an HMAC-SHA256 signature for authenticity verification.

13. API Access

Full REST API to automate link creation and analytics. Limits: Pro up to 5 keys and 1,000 calls/day, Business up to 10 keys and 5,000 calls/day. Enterprise: higher ceilings set by contract.

Create + manage keys:

From /account/api-keys click "New Key". The full key is shown once — save it immediately in a password manager. We cannot retrieve it later (only hash is stored).

Example — shorten a link:

curl -X POST https://zaye.cc/api/links \
  -H "Authorization: Bearer zlk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/very-long","alias":"my-link"}'

# Response:
{
  "ok": true,
  "link": {
    "id": "lnk_...",
    "short_url": "https://zaye.cc/my-link",
    "long_url": "https://example.com/very-long",
    "created_at": "2026-05-19T08:30:00Z"
  }
}

Full API docs: /docs/api

14. Security & Privacy

• HTTPS enforced — no HTTP links
• PDPL compliant (Saudi Personal Data Protection Law)
• No raw IP storage — only truncated hash to prevent cross-tracking
• HMAC-SHA256 on every Hub webhook
• Strict CSP + HSTS + frame-ancestors none
• 2FA available in your Hub account
• Cloudflare edge in Jeddah + Riyadh — Saudi visitors are served from local POPs (≈20-40ms). Central storage currently in the EU via Cloudflare D1 (will migrate to a Saudi region as soon as Cloudflare offers one).

15. Billing & Subscription

All invoices and subscriptions are managed in Zayenha Hub — centrally via your unified account.

• ZATCA certified e-invoices — Saudi e-invoicing compliant
• Payment: Mada, Visa, Master, Apple Pay, STC Pay
• Refund: 7 days from your first paid subscription (full refund policy)
• Cancellation: any time from /account

16. Troubleshooting

Link not working?

• Make sure the source URL starts with https://
• Check link expiration in link settings
• If password-protected, ensure correct password

Analytics not showing?

• Data appears within 60 seconds of click
• Check the date filter on the analytics dashboard

Exceeded plan limit?

Upgrade from /pricing or wait until the next month for the counter to reset.

17. Support

If your answer isn’t in this guide:

• FAQ: /faq
• Support ticket: /support (via Zayenha Hub)
• Email: z@zayenha.com
• Contact form: /contact

Response times (priority support): Business plan — within 4 hours • Enterprise — within 1 hour (other plans: standard support, no hour-specific SLA)