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.

Quick Start Guide

Your First Campaign in 2 Minutes

Go from zero to published content in five simple steps. No setup required for your first generation.

1

Create your account

~30 seconds

Sign up with email or connect your X/LinkedIn account. You get 7 days of full access immediately.

2

Add your content source

~1 minute

Paste a URL, drop in raw notes, or upload a file (PDF, image, audio). The AI reads and understands it automatically.

blog.dev/my-postMeeting noteswhitepaper.pdf
3

Pick a persona (optional)

~10 seconds

Choose from our Persona Marketplace or create your own. This defines your writing voice.

4

Generate your campaign

~30 seconds

Click the big red button. Ozigi creates a 3-day content plan with posts for X, LinkedIn, Discord, Slack, and email.

5

Publish or schedule

~30 seconds

Edit if needed, then publish directly or schedule for later. For X, we send you an email reminder with a one-click post link.

Start Your First Campaign →No credit card required for trial

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.

Step 1

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.

Step 2

Connect Channels

Add your Discord or Slack webhook in Settings. For X and LinkedIn, OAuth authentication is built in—just sign in once.

Step 3

Advanced Settings

Set your default tweet format (single/thread), and add campaign directives (e.g., “target junior engineers”) to fine‑tune output.

Step 4

Choose Context

Paste a URL, raw notes, or upload a file. Ozigi ingests text, PDFs, images, audio, and video—no need to summarize first.

Step 5

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

https://dev.to/dumebii/ozigi-v2-changelog

The engine fetches and reads the page content, ignoring ads and navigation.

📝

Raw Notes

"Scaling automation requires treating test code like production code..."

Unformatted meeting transcripts, brain dumps – keep them messy.

📁

File Uploads

PDF, images, video, audio

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.

❌ Weak Persona

"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.

✅ High-Impact Persona

"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.

delvetapestrycruciallandscaperealmunlocksuperchargerobustseamlessly

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:

Day 1Day 2Day 3
XLIDCSL
Rate limits at edge
Why edge matters
Community update
Slack announcement

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.

The "Edit" Factor

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.

Abstract background

Leave the text field empty → generates a custom abstract graphic.

"3 Rules"

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:

𝕏Web Intents
inDirect OAuth
👾Webhook
💬Slack Webhook

• 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

  1. Go to Settings (gear icon)
  2. In Workspace Preferences, find the "Email" section
  3. 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)
  4. Click Save Workspace Settings

Step 2: Add Subscribers

  1. Go to Subscribers in the sidebar
  2. Choose how to add emails:
    • Manual: Paste emails (one per line) and click "Add Emails"
    • CSV: Click "📁 Upload CSV" with one email per row
  3. Verify the count updates in "Your Subscribers"

Step 3: Schedule an Email

  1. After generating a campaign, click the Email platform icon
  2. Choose a send time and click Schedule
  3. 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. 1. Go to Long-Form: Click "Long-Form Content" in your sidebar.
  2. 2. Add Context: Paste an article, research notes, a URL, or raw ideas (minimum 50 characters).
  3. 3. Configure: Choose target length (500–8,000 words), tone, structure, and optional instructions.
  4. 4. Select Persona: Pick a saved persona to inject your voice into the content.
  5. 5. Generate: Click "Generate Article". The engine processes in 30–90 seconds.
  6. 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.

How do I make my X thread more engaging?
Start with a specific fact or number. Use sentence fragments. End each tweet with a hook that makes people want to read the next one.
🔍 Web SearchToggle on for real‑time information.
Responses stream in real time. You can send any answer directly to the Context Engine to start a campaign.

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
Trial

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

  1. Open your Discord server and go to Server Settings (gear icon).
  2. Click Integrations in the left sidebar.
  3. Click Webhooks and then New Webhook.
  4. Name it "Ozigi" and select the channel where posts should appear.
  5. Click Copy Webhook URL and paste it into Settings → Integrations → Discord Webhook in Ozigi.
  6. Save. Now your campaigns publish directly to that Discord channel.

Slack — 60-Second Setup

  1. Open your Slack workspace and go to Apps in the left sidebar.
  2. Search for Incoming Webhooks and click Add to Slack.
  3. Choose the channel where Ozigi should post and click Authorize.
  4. Copy the Webhook URL shown on the confirmation page (starts with https://hooks.slack.com/services/).
  5. Paste it into Settings → Integrations → Slack Webhook URL in your Ozigi dashboard.

LinkedIn OAuth — Step by Step

  1. Go to Settings → Integrations in your Ozigi dashboard.
  2. Click Connect LinkedIn.
  3. You'll be redirected to LinkedIn's authorization page. Sign in if prompted.
  4. Click Allow to grant Ozigi permission to post on your behalf.
  5. 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 →