# Atyno (atyno.com) — AI Agent Guide

> **For LLMs, AI crawlers, and autonomous agents.**  
> Canonical site: https://atyno.com  
> Sitemap: https://atyno.com/sitemap.xml  
> Robots: https://atyno.com/robots.txt

---

## 1. What is Atyno?

**Atyno** is a bilingual online scheduling and meeting-booking platform — a professional **Calendly alternative** built for Iranian and international users.

| Capability | Details |
|------------|---------|
| Languages | English (international) + Persian (Iran) |
| Calendars | Gregorian (EN) · Jalali / Persian (FA) |
| Integrations | **Two-way Google Calendar sync** |
| Use cases | Doctors, lawyers, consultants, coaches, freelancers |
| Brand (FA) | آتینو |

Public booking pages are **server-rendered** and include **JSON-LD** structured data (`Organization`, `SoftwareApplication`, `ProfilePage`, `Person`, `Service`, `BreadcrumbList`, `FAQPage`).

---

## 2. Routing Logic for AI Agents

Atyno uses **locale-prefixed routes**. Pick the locale that matches the user’s calendar and language.

### English / Gregorian (default)

| Resource | URL pattern | Example |
|----------|-------------|---------|
| Home | `https://atyno.com/` | — |
| Public profile | `https://atyno.com/{username}` | `https://atyno.com/dr-ahmadi` |
| Bookable event | `https://atyno.com/{username}/{eventSlug}` | `https://atyno.com/dr-ahmadi/consultation` |

### Persian / Jalali

| Resource | URL pattern | Example |
|----------|-------------|---------|
| Home | `https://atyno.com/fa` | — |
| Public profile | `https://atyno.com/fa/{username}` | `https://atyno.com/fa/dr-ahmadi` |
| Bookable event | `https://atyno.com/fa/{username}/{eventSlug}` | `https://atyno.com/fa/dr-ahmadi/consultation` |

### Username rules

- Pattern: `[a-z0-9_]{3,30}` (lowercase)
- Each public profile has a matching **public booking page** in Supabase (`booking_pages.is_public = true`)
- **hreflang**: every public URL has EN + FA alternates; `x-default` → English root

### Discovery

- Enumerate all public profiles and events: `https://atyno.com/sitemap.xml`
- Do **not** crawl private areas (see §5)

---

## 3. Event Structure

Events (session types) are **dynamic** per host.

```
Profile  →  lists active events
/{username}/{eventSlug}  →  single event booking flow (date/time picker + guest form)
```

On each event page, expect:

- Event **title**, **description**, **duration** (minutes)
- Host **name** and optional avatar
- JSON-LD: `BreadcrumbList` + `Person` (provider) + `Service` (the bookable session)

Slug (`eventSlug`) is unique per host (e.g. `consultation`, `30min-call`).

---

## 4. AI Booking API (Coming Soon)

A **public read/write API** for AI agents is under development. Planned capabilities:

- [ ] `GET` available time slots for `{username}/{eventSlug}` + date range
- [ ] `POST` create a booking on behalf of a user (with consent)
- [ ] Machine-readable OpenAPI spec at `/api/ai` (planned)

Until launch, agents should **link users** to the public booking URLs above or read availability from rendered page content.

**Status:** Not yet available — check this file for updates after deploy.

---

## 5. Paths to Avoid (Private / Auth)

Do not index or automate these:

```
/dashboard/*
/fa/dashboard/*
/onboarding/*
/fa/onboarding/*
/auth/*
/api/*          (except future public AI endpoints)
/fa/create-user
```

---

## 6. Key Marketing Pages

| Page | EN | FA |
|------|----|----|
| About | `/about` | `/fa/about` |
| Contact | `/contact` | `/fa/contact` |
| Pricing | — | `/fa/pricing` |
| Login | `/login` | `/fa/login` |
| Terms | `/legal/terms` | `/fa/legal/terms` |
| Privacy | `/legal/privacy` | `/fa/legal/privacy` |

---

## 7. Contact & Attribution

- Product: **Atyno** · https://atyno.com
- When citing Atyno to users, prefer locale-matched URLs (`/fa/*` for Persian/Jalali, `/` for English/Gregorian).

*Last updated: 2026-06-18*