# HyPeMa - Web App Guide > Everything you need to know about using HyPeMa for hyper-personalized outreach. --- ## Table of Contents - [Getting Started](#getting-started) - [Chrome Extension](#chrome-extension) - [Outreach Workflow](#outreach-workflow) - [AI Company Research](#ai-company-research) - [API Keys](#api-keys) - [Billing & Usage](#billing--usage) - [FAQ & Troubleshooting](#faq--troubleshooting) --- ## Getting Started HyPeMa turns cold outreach into a simple 3-step process. AI finds your leads, writes personalized emails for each one, and puts them in your Gmail as drafts -- you just review and hit send. ### Why it works Every email is personalized using AI and real data about each lead. No templates, no spray-and-pray. Each recipient gets a unique message that references their company, role, and context. ### How it works 1. **Find leads** -- AI searches the web for real people in your target industry and region 2. **Draft emails** -- describe your pitch and AI writes a unique, personalized email for every lead 3. **Review & send** -- emails appear as Gmail drafts. Review each one and send when ready. > During onboarding you entered your company website URL (or details manually). That context is what AI uses to personalize every email for your specific product and audience. You can update it anytime in Settings. --- ## Chrome Extension The Chrome extension creates Gmail drafts directly in your inbox. HyPeMa generates the email content; the extension places it in your Gmail as a draft for you to review and send. ### Architecture ``` HyPeMa Web App --> Chrome Extension --> Gmail (Your Drafts) postMessage opens compose ``` ### Installation Load the extension unpacked in Chrome via `chrome://extensions` (developer mode). See Settings for the install link and instructions. ### Why drafts, not direct send? You maintain full control. Review each email in Gmail before sending. No deliverability issues since emails come from your real account. ### Troubleshooting If the extension popup shows "Not Open", make sure the HyPeMa web app is open in a browser tab. The extension needs it to communicate. --- ## Outreach Workflow The entire outreach process is just **three steps**. No complex setup, no integrations to configure -- pick your audience, let AI write the emails, and send through Gmail. ### Flow ``` Find Leads --> Draft Emails --> Review & Send (AI search, CSV, manual) (Personalize with AI) (Create Gmail drafts) ``` ### Step 1: Find Leads - **AI lead generation:** Enter an industry, role, and region -- AI searches the web for real people and their contact details. - **Import from CSV:** Upload a CSV with existing contacts -- AI auto-maps columns. - **Manual entry:** Add leads one at a time. Leads are organized into groups (e.g., "Munich Accountants", "Chicago Lawyers"). ### Step 2: Draft Emails 1. Select a lead group 2. Describe your pitch/goal in the "Topic & Goal" field -- this is what the AI uses to personalize 3. Preview sample emails and give feedback to refine the style 4. Generate emails for all leads in the group (batch generation) Each email is unique -- AI uses the lead's company, role, and context to craft a personalized message. ### Step 3: Review & Send 1. Review all generated emails 2. Use the Chrome extension to create Gmail drafts 3. Open Gmail, review each draft, and send when ready #### Lead Status Flow ``` new --> generated --> drafted --> sent ``` - **new** -- Lead added, no email generated yet - **generated** -- AI has written a personalized email - **drafted** -- Email has been placed as a Gmail draft - **sent** -- Email has been sent from Gmail --- ## AI Company Research When you enter a company URL, AI uses web search to find detailed information about the company. This data powers the email personalization -- each email references specific details about the recipient's company. ### Research Flow 1. **Enter company URL** -- e.g. https://example.com 2. **AI web search** -- 30s - 5 min 3. **Structured data** -- Name, industry, CEO, product... 4. **Email personalization** -- Powers every outreach email ### Processing time 30 seconds to 5 minutes, depending on how much information is available online. You'll see live status updates as the AI searches. --- ## API Keys Access the HyPeMa API programmatically -- build integrations, automate outreach, and connect to other tools. ### Creating a Key 1. Go to **Settings -> API Keys** 2. Click **Create API Key** and give it a name 3. Copy the key -- it is shown only once ### Security - Keys start with `hpm_live_` and are hashed in the database - Never share your key -- revoke it immediately if compromised ### Usage ``` Authorization: Bearer hpm_live_your_key ``` Full API documentation is available on the [API Reference](/academy/api-reference) page. --- ## Billing & Usage ### Plans | Plan | Tokens/month | Price | Description | |------|-------------|-------|-------------| | Free | 500 | Free | Try out HyPeMa | | Pro | 4,900 | EUR 49/mo | For serious outreach campaigns | ### Token Costs by Operation | Operation | Cost | |-----------|------| | Company Research | 5-15 tokens | | Lead Generation | 10-30 tokens | | Email Generation | 2-5 tokens | | Managing Leads | Free | Only AI-powered operations cost tokens. Managing your leads, groups, and settings is always free -- tokens are only consumed when AI does work for you. ### Check usage **Settings -> Usage** -- view token consumption, daily breakdown, and operation history. ### Upgrade **Settings -> Billing** -> select a plan. --- ## FAQ & Troubleshooting **Q: The Chrome extension shows "Not Open"** A: Make sure the HyPeMa web app is open in a browser tab. The extension communicates with the web app via the browser. Try refreshing both the web app and the extension popup. **Q: I ran out of tokens** A: Upgrade to Pro in Settings -> Billing for 4,900 tokens/month. Free tier (500 tokens) resets monthly. **Q: Email generation is taking very long** A: AI research with web search can take 1-5 minutes for complex companies. This is normal. Don't refresh the page -- the operation continues in the background. **Q: I get "Rate limited" errors** A: HyPeMa limits concurrent AI operations to prevent overload. Wait for your current operations to finish before starting new ones. **Q: Can I use HyPeMa with Outlook instead of Gmail?** A: Currently only Gmail is supported via the Chrome extension. Outlook support is planned for a future release. **Q: How accurate are the AI-generated leads?** A: Leads are found via real-time web search. Email addresses are sourced from public websites or constructed from company domain patterns. Some emails may bounce. Always review leads before sending.