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. 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 (Pro)

Export:

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

5. 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

6. Bio Pages

A Bio page is a professional landing page that aggregates all your links in one place — perfect for Instagram & TikTok bios.

How to create:

1. Go to /bio
2. Pick one of 12 ready templates
3. Add your photo, name, bio, links (YouTube, Instagram, X, WhatsApp, etc.)
4. Get your link zaye.cc/b/your-handle

Every Bio tracks per-link clicks — so you know what actually engages your audience.

7. 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.

7. 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}}

8. Gulf Calendar Links

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

Supported seasons:

• Ramadan (1-29/30 Ramadan)
• Eid al-Fitr (1-3 Shawwal)
• Eid al-Adha (10-13 Dhul-Hijjah)
• Saudi National Day (Sep 23)
• Founding Day (Feb 22)
• Hajj (8-13 Dhul-Hijjah)

9. 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 from each link detail page → Webhooks tab. Each webhook ships with an HMAC-SHA256 signature for authenticity verification.

10. API Access

Full REST API to automate link creation and analytics. Limits: Pro up to 5 keys, Business up to 10, Enterprise has no daily caps.

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

11. 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).

12. 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: 14 days from payment date
• Cancellation: any time from /account

13. 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.

14. 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: Free 48h • Starter 24h • Pro 6h • Business 1h