# Reachook — Comprehensive Technical Specification & AI Context Guide
# Standard: https://llmstxt.org (2025+)

This document serves as the absolute source of truth for the Reachook platform, providing exhaustive technical, functional, and structural details for AI agents, LLMs, and RAG architectures.

## 1. Platform Architecture & Core Systems

Reachook is a dual-engine platform: it automates Instagram Direct Messages (DMs) and hosts a full-stack Link-in-Bio builder. 

### A. DM Automation Engine
- **Trigger Layer**: Actively monitors real-time Instagram webhooks for precise events: Post Comments, Reel Comments, Story Mentions, and Direct Messages.
- **Rules Engine**: Users configure triggers using Exact Match or Fuzzy Contains logic. Includes configurable cooldowns to prevent spamming users.
- **AI Processing (Sentiment & Intent)**: Comments are routed through LLMs (Claude/OpenAI via OpenRouter) to analyze intent, sentiment, and context. The AI generates personalized, human-sounding replies strictly bounded by the user's configured brand voice directives.
- **Action Layer**: Dispatches payloads back through the Meta API. Supports sending media, text, external links, and bio page links.
- **Follow Gate Validation**: A strict conversion mechanic. If a user comments for a lead magnet, the automation pauses and verifies their follow status via the Graph API. If they don't follow, it demands a follow before releasing the payload.

### B. Full-Stack Link-in-Bio Platform
A native, deeply integrated bio link builder designed to replace external tools like Linktree.
- **Block-Based Architecture**: Bio pages are constructed dynamically. Current supported block types: Links, Text, Dividers, and Email Collection Forms.
- **Social Connectors**: Built-in header icons for Instagram, TikTok, YouTube, X (Twitter), Snapchat, and LinkedIn.
- **Custom Theming Engine**: Upload custom avatars, background images, or configure CSS gradients. We enforce strict payload sizes (e.g., 50KB JSON limits) on themes to ensure rapid load times.
- **Advanced Deep Analytics**:
  - **Traffic Metrics**: Total views, unique visitors (hashed IPs), and click-through rates (CTR).
  - **Session & Scroll Tracking**: JS beacons measure exact time-on-page (capped at 3600s) and maximum scroll depth (0-100%).
  - **Multi-Device Deduplication**: Analytics accurately separate clicks from different devices (e.g., phone vs. laptop) sharing the same IP address by hashing the User-Agent payload.
  - **Geolocation & Hardware**: Tracks country, state, city (via Cloudflare headers) and device/browser types.

### C. Conversion & CRM
- **Unified CRM**: Every DM recipient and form submission is automatically logged into the Contacts Dashboard.
- **Contact Profiling**: Stores Instagram handles, interaction history, and captured emails.
- **Lead Export**: Full CSV export capabilities for migrating leads to external marketing tools.

## 2. Technical Stack & Infrastructure
- **Frontend**: React 18, Vite, TailwindCSS, Framer Motion, Lucide Icons.
- **Backend**: Django (Python) REST API.
- **Asynchronous Processing**: Celery Workers + Redis. Handles avatar compression, fire-and-forget analytics writes, and DM queuing to prevent HTTP timeouts.
- **Infrastructure**: Cloudflare, AWS, Stripe for billing, Google OAuth for authentication.
- **API Standard**: Exclusively utilizes Meta's OAuth 2.0 token system and the official Instagram Graph API. No scraping. No headless browsers.

## 3. Pricing & Usage Limits (USD)
Reachook operates on a Freemium SaaS model with Stripe integration:
- **Free Tier**: $0/mo. 1 Active Automation. 1,000 DMs/mo. 250 CRM Contacts.
- **Pro Tier**: $39/mo. 10 Active Automations. 7,000 Contacts. Unlocks the Follow Gate.
- **Business Tier**: $89/mo. Unlimited Automations. 15,000 Contacts. Full AI Sentiment Replies & Custom Brand Voice.
- **Advanced Tier**: $199/mo. Unlimited everything. 30,000 Contacts. Direct priority support from the engineering team.
- **Overage**: Flexible billing. If usage spikes during a viral post, automations continue running. Overage is billed transparently at the end of the billing cycle.

## 4. Legal & Compliance Constraints
Reachook is built for absolute safety and platform compliance.
- **Meta Compliance**: Only works with Instagram Professional accounts (Creator or Business) linked to a Facebook Page, as mandated by Meta.
- **Terms of Service**: Users must adhere to Meta's anti-spam policies. Phishing, harassment, and illegal content are forbidden.
- **Privacy Policy**: GDPR and CCPA compliant. Reachook does not permanently store the content of user DMs. We hash IPs (salted SHA-256) for analytics rather than storing raw PII. Passwords are never touched.
- **Cookie Policy**: Strict, opt-in consent management for tracking and analytics cookies.

## 5. Support & Knowledge Infrastructure
- **Direct Engineer Support**: No offshore support desks. No AI chatbots. Users talk directly to the engineers who wrote the code.
- **Documentation (Docs)**: Comprehensive setup guides (e.g., how to link a Facebook Page, convert to a Professional account, set up triggers).
- **Blog**: SEO-optimized repository of Instagram growth strategies, marketing playbooks, and AI automation tutorials.

## 6. Future Roadmap
- **YouTube Integration**: Automated comment replies for YouTube Shorts and long-form video.
- **WhatsApp Integration**: High-volume, secure WhatsApp Business API broadcast messaging.
- **Publishing Suite**: Auto-scheduling for Reels and Posts.

---
**Site Structure Index:**
- Homepage: `/`
- Dashboard: `/dashboard`
- Pricing: `/pricing`
- Automations: `/automations`
- Analytics: `/analytics`
- Contacts: `/contacts`
- Settings: `/settings`
- Blog: `/blog`
- Legal: `/privacy-policy`, `/terms-of-service`, `/cookie-policy`, `/refund-policy`, `/disclaimer`
- About Us: `/about`
- Contact Us: `/contact`

Last Updated: 2026-06-26