Documentation
Comprehensive guides for using LinkAngler effectively
LinkAngler is a LinkedIn outreach CRM that helps you find leads, run automated campaigns, and track engagement — turning LinkedIn into a measurable sales pipeline.
- Create your account — Sign up with your email and set a password. After signing in, you will land on the Dashboard where a Welcome Guide checklist tracks your setup progress through each step below.
- Connect LinkedIn — Go to Settings and click Connect LinkedIn. After authenticating, you will see your name and connection status displayed in Settings. This unlocks lead search, messaging, and campaign features.
- Configure AI Provider — Go to Settings → AI Provider. Enter an API key and base URL from a third-party AI provider. We recommend OpenRouter (openrouter.ai) for the widest model compatibility. This powers ICP analysis, AI-generated search queries, post comments, and the AI Help Assistant.
- Start prospecting — Search for leads on the Leads page, save them to lists, build campaigns, and let LinkAngler automate your outreach. You can also set up ICP profiles to have AI discover leads automatically.
Tip: The Welcome Guide on your Dashboard shows a progress checklist. Complete each step to unlock all features. You can reset the guide from Settings at any time.
How it works: LinkAngler uses a secure, hosted authentication flow. When you click Connect LinkedIn in Settings, you are redirected to a secure page where you sign into LinkedIn directly. LinkAngler never sees or stores your LinkedIn password.
What LinkAngler can do with your connection:
- Search for people on LinkedIn
- View LinkedIn profiles
- Send connection requests (with optional message)
- Send direct messages to connections
- View posts from leads
- React to and comment on posts
Sales Navigator
If your LinkedIn account has Sales Navigator, LinkAngler automatically detects it during connection. Sales Navigator unlocks advanced search filters (seniority level, company size ranges) and provides richer discovery results. No extra setup is needed — it activates automatically.
Important: Only one LinkedIn account can be connected at a time. Connecting a new account will replace the existing connection.
Troubleshooting:
- "Connection expired" — Go to Settings and click Reconnect. LinkedIn sessions may expire after extended periods of inactivity.
- Can't find Sales Navigator features — Verify that Sales Navigator is active on your LinkedIn account at linkedin.com, then reconnect in Settings so LinkAngler can detect it.
Searching for Leads
Use the Leads page to search LinkedIn. Enter keywords and apply filters for job title, location, and industry. Results show each person's name, headline, company, location, and current connection status (connected, pending, or not connected).
Saving to Lists
Select one or more leads using the checkboxes, then click Save to List. You can create new lists or add to existing ones. Leads can belong to multiple lists simultaneously, so you can organize by campaign, industry, priority, or any other criteria.
Importing Leads
Go to the Import page to add leads by LinkedIn profile URL. Paste one URL per line. LinkAngler fetches the profile data from LinkedIn and adds each person to your leads.
Lead Profiles
Click on any lead to view their full profile. The profile page shows their headline, company, location, and connection status. You will also see their engagement history (messages sent, connection requests), which campaigns they are enrolled in, and which lists they belong to.
Campaigns are multi-step outreach sequences that run automatically. Create a campaign, define your steps, enroll leads, and LinkAngler executes each action on schedule.
Step Types
- Send Connection — Sends a LinkedIn connection request. Optionally include a personalized message.
- Send Message — Sends a direct message. The lead must already be a connection.
- Like Post — Likes the lead's most recent LinkedIn post to increase visibility before outreach.
- AI Comment — AI generates and posts a relevant comment on the lead's most recent post using an AI Persona you select.
- Voice Note — Sends an AI-generated voice message with a personalized greeting (the lead's name via text-to-speech) spliced onto a pre-recorded voice template. Requires ElevenLabs setup.
- Video Message — Sends a personalised video via LinkedIn. Choose between AI-generated videos (lip-synced from a template with the lead's name) or pre-recorded personal videos. The lead receives a link to a branded landing page with your video.
Personalization Variables
Use these variables in connection requests and messages. They are automatically replaced with each lead's data:
{firstName}— Lead's first name{company}— Lead's company name{headline}— Lead's LinkedIn headline
If a variable cannot be resolved (e.g., no company listed), LinkAngler uses an automatic fallback so the message still reads naturally.
Campaign Lifecycle
Campaigns move through these statuses: Draft (building steps) → Active (executing actions) → Paused (temporarily stopped) → Completed (all enrollees finished). You can pause and resume at any time.
Daily Limits by LinkedIn Account Tier
LinkAngler automatically detects your LinkedIn account tier and applies the correct daily limits. Premium LinkedIn accounts get higher daily limits.
| Action | Free LinkedIn | Premium LinkedIn |
|---|---|---|
| Connection requests | 20 / day | 40 / day |
| Messages | 100 / day | 200 / day |
| Post engagements | 100 / day | 100 / day |
Safety Features
- Quiet hours — No actions are sent during off-hours to mimic natural usage patterns
- Warm-up period — New campaigns start with lower daily limits that gradually increase over time
- Rate limiting — Daily limits are enforced across all campaigns combined, not per campaign
Best Practices
- Personalize every connection request — generic messages have much lower acceptance rates
- Wait 3-5 days between campaign steps to appear natural
- Keep initial messages under 300 characters for higher response rates
- Use AI Personas for post comments to ensure authentic, relevant engagement
What is an ICP?
An Ideal Customer Profile (ICP) defines the characteristics of your best-fit prospects. Instead of searching manually, LinkAngler uses your ICP to generate targeted LinkedIn searches and score results automatically.
Creating ICP Profiles
Go to Discovery → ICP Profiles and create a new profile. Define your target criteria:
- Target titles — Job titles your prospects typically hold (e.g., VP of Sales, Head of Marketing)
- Industries — Target industries (e.g., SaaS, Financial Services)
- Seniority levels — Manager, Director, VP, C-Suite, etc.
- Locations — Geographic targets (e.g., San Francisco, United Kingdom)
- Company sizes — Employee count ranges (e.g., 51-200, 1001-5000)
- Keywords — Terms that should appear in profiles (e.g., B2B, enterprise sales)
AI Lead Analysis
If you have 20 or more saved leads, the Analyze My Leads button appears on the ICP page. AI examines your existing lead data and suggests values for each ICP field based on patterns it finds. This helps you create a data-driven ICP rather than guessing.
Search Generation & Execution
Once your ICP is configured, AI generates LinkedIn search queries tailored to your criteria. You review and approve each search before it runs. Approved searches execute automatically via background automation (every 30 minutes) and results are scored against your ICP.
Lead Scoring
Each discovered lead receives a score from 0 to 100 based on how well they match your ICP. The score breaks down as follows:
- Title match — 30% weight
- Industry — 20% weight
- Seniority — 20% weight
- Location — 15% weight
- Keywords — 15% weight
Score colors:
- Green (80+) — Strong match
- Blue (60-79) — Good match
- Yellow (40-59) — Moderate match
- Gray (below 40) — Weak match
Auto-Save & Auto-Enroll
Configure a score threshold to automatically save high-scoring leads to a designated list. You can also enable auto-enroll to automatically add qualifying leads into an active campaign, creating a fully automated prospecting pipeline.
Discovery Limits
LinkAngler processes up to 50 search pages per day per user. Discovery searches run automatically every 30 minutes via background automation.
Sales Navigator Advantage
Accounts with Sales Navigator unlock advanced search filters (seniority level, precise company size ranges) for more targeted discovery. LinkAngler detects Sales Navigator automatically during LinkedIn connection — no extra configuration needed.
AI Provider Setup
Go to Settings → AI Provider. Enter your API key and base URL from your chosen provider. We recommend OpenRouter (openrouter.ai) for the widest model compatibility. Select a model name — larger models generally produce better ICP analysis, search queries, and post comments.
AI Personas
AI Personas are reusable personality profiles for generating LinkedIn post comments. Each persona has a name, description, and tone (e.g., "Thoughtful Industry Expert" or "Friendly Connector"). Create personas in Settings → AI Personas and assign them to AI Comment steps in your campaigns. The persona guides the AI to generate comments that sound authentic and match your desired voice.
Voice Notes
Voice notes require an ElevenLabs account (elevenlabs.io). Set up your ElevenLabs API key in Settings → Voice, then upload a voice template (a short audio clip of your voice). When a Voice Note step executes, LinkAngler generates a personalized greeting (the lead's name via text-to-speech) and splices it onto your pre-recorded template. You can preview the result before activating the campaign.
AI Help Assistant
Click the "Ask" button in the header to open the AI Help Assistant. It knows your current app setup (LinkedIn connection status, campaigns, ICP profiles) and provides contextual help, troubleshooting, and guidance. Conversations are saved and persist for 30 days. You can also escalate to human support or provide feedback directly from the chat.
Prerequisite: An account with an AI provider — we recommend OpenRouter (openrouter.ai)
- Go to Settings → AI Provider
- Enter the Base URL (e.g. https://openrouter.ai/api/v1)
- Enter your API Key from the provider dashboard
- Enter the Model name (e.g. anthropic/claude-sonnet-4 or google/gemini-2.5-flash)
- Click "Test Connection" to verify your configuration
- Click Save
What it powers: ICP analysis, search queries, AI post comments, Help Assistant
Tip: OpenRouter gives access to 100+ models from one API key
Prerequisite: An ElevenLabs account (elevenlabs.io)
- Create an account at elevenlabs.io and get your API key from Profile → API Keys
- Go to Settings → Voice in LinkAngler
- Enter your ElevenLabs API key and click Save
- In the ElevenLabs dashboard: Voices → Add Voice → Instant Voice Clone → upload a 30-60 second clear recording
- Back in LinkAngler, select your cloned voice from the dropdown
- Upload a voice template (short recording of your intro, up to 2MB)
- Click Preview to hear a personalised voice note
Tip: Record in a quiet room for best voice clone quality
Prerequisite: AI Provider configured (see guide above)
- Go to Settings → AI Personas
- Click "Add Persona"
- Enter a Name (e.g. "Friendly Industry Expert")
- Write a Description — the system prompt guiding how AI writes comments
- Click Save
- Assign the persona to "AI Comment" steps in your campaigns
Tip: Create 2-3 personas and rotate across campaigns for natural variety
Prerequisites: Voice Cloning configured (guide above) + a fal.ai account (fal.ai)
- Complete Voice Cloning setup first (needed for AI greetings)
- Create an account at fal.ai and get your API key
- Go to Settings → Video
- Enter your fal.ai API key
- Select a voice configuration from the dropdown
- Click "Add Template"
- Upload a base video (10-30 seconds, looking at camera)
- Set the placeholder timestamp for greeting insertion
- Configure greeting text with {firstName}, {company} variables
- Optionally set a CTA button text and URL
- Save — the template is now available as a "Video Message" campaign step
Tip: Keep videos under 30 seconds for higher engagement
Personalised AI Videos
LinkAngler can generate lip-synced video messages personalised for each lead. Upload a base video template, configure a greeting text with personalisation tokens ({firstName}, {company}), and the system generates a unique video per lead. It uses your cloned ElevenLabs voice for the greeting and AI lip-sync to match mouth movements. Generated videos are stored and accessible via unique links.
Recording Studio
Go to the Record page to capture personal video messages in your browser. Three recording modes are available: camera only (webcam), screen only (screen capture), and screen + camera (picture-in-picture with your webcam overlay). Recordings can be up to 2 minutes long. After recording, preview and retake if needed, then upload. Each recording gets a unique shareable link.
AI Re-dub
Take any existing video template and replace the speech with your AI voice clone. The system transcribes the original audio, lets you edit the transcript, then generates new speech via ElevenLabs TTS. The AI lip-syncs mouth movements to match the new audio while preserving the original background sounds. The result saves as a new video template for campaigns.
Video Landing Pages
Every video (AI-generated or personally recorded) gets a branded landing page at a unique URL. Recipients see an auto-playing video, sender information, and a call-to-action button. Views are tracked silently so you can measure engagement. Personal recordings also include a download button for recipients.
LinkedIn Connection
Connect or reconnect your LinkedIn account. View your connection status and account details. If your session expires, use the Reconnect button. Sales Navigator is automatically detected when you connect.
AI Provider
Enter your API key, base URL, and preferred model name. Click Test Connection to verify your configuration works before using AI features. All AI features (ICP analysis, search generation, post comments, help assistant) use this provider.
AI Personas
Create, edit, and delete AI personas. Each persona defines a name, description, and tone used for generating LinkedIn post comments. Assign personas to AI Comment campaign steps for consistent, authentic engagement.
Voice Cloning
Configure your ElevenLabs API key, upload voice templates (up to 2MB), and preview generated voice notes. Voice templates are short audio clips of your voice that serve as the base for personalized voice messages in campaigns.
Video Configuration
Set up video messaging by providing your fal.ai API key and selecting a voice configuration for AI-generated greetings. Manage video templates (upload base videos, set placeholder timestamps, configure greeting text and CTA buttons). Video uses your ElevenLabs voice clone for personalised greetings, so configure Voice Cloning first.
Account Management
View your profile, export your data as a backup, or delete your account. Account deletion has a 30-day recovery window — you can restore your data within that period by contacting support.
Welcome Guide
The Welcome Guide is a step-by-step setup checklist shown on your Dashboard. If you need to revisit it, you can reset the guide from Settings to start the onboarding flow again.
Language
LinkAngler supports 12 languages. Choose your preferred language from the language switcher — the entire interface updates instantly. Your preference is saved to your account and persists across sessions and devices.