Platform Documentation
Ozigi is an intelligent context engine that transforms your raw research—notes, URLs, PDFs—into structured social media campaigns for X, LinkedIn, Discord, Slack, and email. This guide covers everything you need to set up your workspace and start publishing content that sounds like you.
Your First Campaign in 2 Minutes
Go from zero to published content in five simple steps. No setup required for your first generation.
Create your account
~30 secondsSign up with email or connect your X/LinkedIn account. You get 7 days of full access immediately.
Add your content source
~1 minutePaste a URL, drop in raw notes, or upload a file (PDF, image, audio). The AI reads and understands it automatically.
Pick a persona (optional)
~10 secondsChoose from our Persona Marketplace or create your own. This defines your writing voice.
Generate your campaign
~30 secondsClick the big red button. Ozigi creates a 3-day content plan with posts for X, LinkedIn, Discord, Slack, and email.
Publish or schedule
~30 secondsEdit if needed, then publish directly or schedule for later. For X, we send you an email reminder with a one-click post link.
1. Getting Started
Before your first campaign, take five minutes to set up your workspace. Ozigi works best when it knows your voice and where you want to publish.
Define Your Voice
Create a System Persona—a database‑backed editorial brief. The more specific, the better. Tell the AI who it is, not what to write.
Connect Channels
Add your Discord or Slack webhook in Settings. For X and LinkedIn, OAuth authentication is built in—just sign in once.
Advanced Settings
Set your default tweet format (single/thread), and add campaign directives (e.g., “target junior engineers”) to fine‑tune output.
Choose Context
Paste a URL, raw notes, or upload a file. Ozigi ingests text, PDFs, images, audio, and video—no need to summarize first.
Start a Campaign
Click “Generate Campaign”. In seconds, you’ll have a multi‑day content plan with posts for each selected platform.
2. Multimodal Ingestion
Ozigi’s engine is built on Google’s Gemini 2.5 Flash, which handles massive context windows. You don’t need to prompt‑engineer – just dump your raw material and let the engine extract the core narrative.
URL Extraction
The engine fetches and reads the page content, ignoring ads and navigation.
Raw Notes
Unformatted meeting transcripts, brain dumps – keep them messy.
File Uploads
Upload up to 100MB per file. The AI reads text from images and transcribes audio.
3. System Personas
Personas are database‑backed voice profiles. Instead of rewriting prompts for every campaign, you save your editorial brief once and reuse it. Ozigi applies the persona’s constraints to every post.
"You are a helpful marketing assistant. Write engaging and professional posts about my software updates. Make sure to use emojis to make it fun."
This tells the AI what to write, not who to be. It invites buzzwords.
"You are a pragmatic, battle-tested Staff Engineer. You speak directly, use dry humor, and absolutely despise corporate fluff. You never apologize."
This defines a character. The AI now has a voice to adopt.
4. The Banned Lexicon
Ozigi enforces a strict list of banned words at the API level. If the AI tries to use “delve”, “tapestry”, or “robust”, the request is penalized. This invisible guardrail forces the model to write like a real human.
The result? Copy that passes AI detectors and sounds like it came from a subject matter expert, not a language model.
5. Generating a Campaign
After selecting your persona and platforms, click “Generate Campaign”. The engine produces a 3‑day content plan, with separate posts for each platform. You’ll see an example like this:
Each post is a 90%‑ready draft. You’ll see an Edit button to add the final 10%—the specific details only you know.
6. Human-in-the-Loop (Editing)
Ozigi is your co‑pilot, not your replacement. The engine handles extraction and structural drafting; you control the final polish.
Before: "We're thrilled to announce..."
After: "Shipped rate limiting today. Hard cap at 1,000 req/min."
Click Edit on any card, tweak the content, and save. Your changes are preserved.
7. Native Image Generation
Every campaign card includes an image generator powered by Gemini 2.5 Flash. It creates platform‑aware graphics that you can download and attach to your posts.
Leave the text field empty → generates a custom abstract graphic.
Type a phrase → renders that text as a stylish title graphic.
Images are generated in 16:9 aspect ratio, perfect for social cards. They are stored in your R2 bucket and automatically linked when you publish to LinkedIn (via OAuth) or when you share the download link.
8. Publishing Integrations
Ozigi never posts without your final approval. Each platform uses a secure, one‑click method:
• X: opens a pre‑filled tweet in a new tab – you review and post.
• LinkedIn: OAuth popup – you authorise once; future posts go directly.
• Discord / Slack: webhook URLs stored in your profile – posts go straight to your chosen channel.
9. Scheduling & X Email Reminders
You don’t have to publish immediately. Click the Schedule icon on any campaign card, pick a date and time, and Ozigi will hold the post.
When the scheduled time arrives:
- X posts: you receive an email with a direct link to the tweet intent.
- LinkedIn, Discord, Slack: posts are published automatically (if you have the appropriate token/webhook).
10. Email Newsletters
Ozigi supports email newsletter delivery to your subscribers. Manage your email list, send newsletters to multiple recipients, and configure your email sender information—all from the dashboard.
Email Setup
Configure sender name, reply-to email, and email address for scheduling reminders in Settings → Workspace Preferences.
Subscriber List
Add subscribers manually, upload CSV files, or import lists. All emails are validated before sending.
Email Features
- • Subscriber Management: Add, remove, and manage your email list from the Subscribers page
- • CSV Upload: Import multiple subscribers at once (Team: max 500/upload, Org: unlimited)
- • Scheduled Delivery: Schedule newsletters to send at a specific date and time
- • Rich Editor: Edit emails with markdown support before scheduling
- • Per-Plan Limits: Team (500/month), Organization (unlimited)
How to Send an Email Newsletter
Step 1: Configure Email Settings
- Go to Settings (gear icon)
- In Workspace Preferences, find the "Email" section
- Enter:
- Email Address: For scheduling reminders (optional)
- Newsletter Sender Name: How your emails will appear in inboxes (e.g., "Ozigi Weekly")
- Reply-to Email: Where subscriber replies go (defaults to your account email)
- Click Save Workspace Settings
Step 2: Add Subscribers
- Go to Subscribers in the sidebar
- Choose how to add emails:
- Manual: Paste emails (one per line) and click "Add Emails"
- CSV: Click "📁 Upload CSV" with one email per row
- Verify the count updates in "Your Subscribers"
Step 3: Schedule an Email
- After generating a campaign, click the Email platform icon
- Choose a send time and click Schedule
- The email will be sent to all active subscribers at the scheduled time
📧 Subscriber Management Tips
- Subscribers have a unique unsubscribe token for one-click opt-out
- Team plan: max 500 subscribers per upload and 500 emails/month total send limit
- Organization plan: unlimited subscribers and unlimited email sends
- Remove individual subscribers anytime by clicking the ✕ button next to their email
11. Long-Form Content Generation
Ozigi's Long-Form engine generates thought-leadership articles, blog posts, and whitepapers from 500 to 8,000 words. Powered by Claude Opus, it produces SEO-friendly, deeply researched content with configurable structure and tone.
🚀 Available on Organization & Enterprise Plans
- • Rate Limit: 5 articles per 24 hours (Organization), unlimited (Enterprise)
- • Processing: Takes 30-90 seconds depending on length and complexity
- • Output: Structured sections with intro, body, conclusion
Target Length
Choose from 500 to 8,000 words. The AI adjusts depth and detail accordingly.
Tone & Style
Select from professional, casual, technical, or storytelling. Mix with your custom persona.
Structure
Choose narrative, listicle, how-to, opinion, or analysis. Each has its own flow.
How to Generate Long-Form Content
- 1. Go to Long-Form: Click "Long-Form Content" in your sidebar.
- 2. Add Context: Paste an article, research notes, a URL, or raw ideas (minimum 50 characters).
- 3. Configure: Choose target length (500–8,000 words), tone, structure, and optional instructions.
- 4. Select Persona: Pick a saved persona to inject your voice into the content.
- 5. Generate: Click "Generate Article". The engine processes in 30–90 seconds.
- 6. Edit & Export: Each section is editable. Copy to clipboard or download as Markdown.
⚠️ Rate Limiting & Quota
Long-form generation is intentionally throttled to prevent abuse and ensure quality output.
- Organization Plan: 5 articles per 24-hour rolling window
- Enterprise Plan: Unlimited long-form generation with priority processing
- Billing: Rate limits reset at the same time each day based on your timezone
- Upgrade: Running out of quota? Contact us for higher limits or enterprise access
12. Ozigi Copilot
Your personal AI assistant lives in the dashboard. Ask questions, brainstorm ideas, or refine drafts – the Copilot has access to your saved persona context and can optionally search the web.
Copilot is available on the Organization plan. It uses your stored copilot context (set in Copilot Settings) to give tailored advice.
13. Pricing & Gating
Ozigi offers tiered plans to match your volume. Every new user gets a 7‑day trial of the Team plan – no credit card required.
Free
5 campaigns/month
- 1 saved persona
- X, LinkedIn, Discord
Team
$15/month or $144/year
- 30 campaigns/month
- Unlimited personas
- 2 images/campaign
- 500 email sends/month
Organization
$39/month or $374.40/year
- Unlimited campaigns & images
- Unlimited email sends
- Full Copilot with web search
- Analytics
Enterprise plans available – contact us for custom quotas, SLA, and team management.
14. Troubleshooting
Generation fails or returns an error
Symptom: Clicking Generate shows an error message or the spinner runs indefinitely.
Check first:
- Is your context field empty? Generation requires at least some input.
- Is the URL you pasted publicly accessible? Ozigi cannot scrape pages behind login walls or paywalls.
- Does your input contain special characters or very long text? Try trimming to under 5,000 words.
If the error persists: Email hello@ozigi.app with the URL or context you were using and we'll investigate.
The generated content doesn't match my context
Symptom: The campaign seems generic or ignores key details from the source material.
Fix: Your System Persona is the most common cause. A vague persona produces generic output. Edit your persona to be more specific about the domain, the writing style, and what to prioritize. See Section 3 — System Personas.
Also check: If you pasted a URL, open the URL in a private browser window to confirm it's publicly accessible. If the page requires JavaScript to render content, Ozigi may receive limited data. Paste the key text directly instead.
X (Twitter) publishing isn't working
Symptom: Clicking the X publish button opens a blank tab or the pre-filled tweet is missing content.
How X publishing works: Ozigi uses X Web Intents — it opens a new tab with your post pre-loaded in the X compose window. This requires you to be logged into X in your browser.
Fix: Log into X in the same browser before clicking publish. If content is missing from the compose window, copy it manually from the campaign card using the Copy button.
Discord messages aren't appearing in my server
Symptom: Clicking the Discord publish button shows success but nothing appears in the channel.
Check:
- Is the webhook URL in your Ozigi Settings modal correct and complete? It should start with
https://discord.com/api/webhooks/ - Was the webhook deleted or disabled in your Discord server settings? Go to Server Settings → Integrations → Webhooks to verify.
- Does the bot have permission to post in that specific channel?
LinkedIn publishing fails with an auth error
Symptom: LinkedIn OAuth shows an error or your posts aren't publishing.
Fix: Go to Settings → Integrations → Disconnect LinkedIn, then reconnect. LinkedIn OAuth tokens expire — reconnecting refreshes them. If the error continues, email hello@ozigi.app.
Email reminders for scheduled posts aren't arriving
Symptom: You scheduled a post but didn't receive the email reminder at the scheduled time.
Check:
- Did you sign up with X OAuth? If so, add your email address in Settings → Account to enable email reminders.
- Check your spam folder — reminder emails come from
no-reply@ozigi.app. - Is your scheduled time in the future? Scheduling in the past is ignored silently.
15. Integration Setup Walkthroughs
Discord — 60-Second Setup
- Open your Discord server and go to Server Settings (gear icon).
- Click Integrations in the left sidebar.
- Click Webhooks and then New Webhook.
- Name it "Ozigi" and select the channel where posts should appear.
- Click Copy Webhook URL and paste it into Settings → Integrations → Discord Webhook in Ozigi.
- Save. Now your campaigns publish directly to that Discord channel.
Slack — 60-Second Setup
- Open your Slack workspace and go to Apps in the left sidebar.
- Search for Incoming Webhooks and click Add to Slack.
- Choose the channel where Ozigi should post and click Authorize.
- Copy the Webhook URL shown on the confirmation page (starts with
https://hooks.slack.com/services/). - Paste it into Settings → Integrations → Slack Webhook URL in your Ozigi dashboard.
LinkedIn OAuth — Step by Step
- Go to Settings → Integrations in your Ozigi dashboard.
- Click Connect LinkedIn.
- You'll be redirected to LinkedIn's authorization page. Sign in if prompted.
- Click Allow to grant Ozigi permission to post on your behalf.
- You'll be redirected back to Ozigi. The LinkedIn button should now show your name.
Note: LinkedIn OAuth tokens expire after 60 days. You'll receive an email when reconnection is needed.
Master the Engine
Ready to go under the hood? Read our architectural deep dives to understand exactly how Ozigi processes, constrains, and generates professional copy.
View All Deep Dives →