Documentation

Everything you need to know to create AI-powered marketing campaigns with Vivra Marketing.

Getting Started

Create an Account

You can sign up for Vivra Marketing in two ways:

• Email & password — Enter your email, choose a password, and verify via the confirmation email we send you.
• Google OAuth — Click "Sign in with Google" for instant access with your Google account. No verification needed.

First Login

After logging in, you'll land on the main dashboard. On your first visit you will see an empty state prompting you to create your first campaign. Before creating a campaign, we recommend configuring your brand profile and connecting at least one social platform.

Dashboard Overview

The dashboard is your command center. It shows:

• Stats bar — Total campaigns, active, pending review, and paused counts.
• Campaign grid — Cards for each campaign showing idea, status, platforms, post progress, and date.
• Filters — Filter by status (active, review, generating, completed, paused) or by client account.
• New Campaign button — Top right, opens the campaign creation modal.

Creating Campaigns

Creating a campaign takes less than a minute. The AI handles everything else.

1. Click "+ New Campaign" in the top right corner of the dashboard.
2. Write your campaign idea in plain language. For example: "Launch our new organic coffee blend targeting health-conscious millennials with a week-long social media blitz."
3. Choose your target platforms: Twitter, Instagram, and/or YouTube.
4. Set the number of posts per platform using the slider controls.
5. Toggle whether to generate DALL-E images and/or Luma AI videos for your posts.
6. Review the credit estimator that shows the total cost before creating the campaign.
7. Click "Create Campaign" and the AI takes over.

What the AI Generates

Once you submit, four AI agents work in sequence:

• Strategist — Creates the overall campaign strategy: name, goal, tone, target audience, and a day-by-day content plan.
• Copywriter — Writes platform-specific copy for each post (respecting character limits, hashtag conventions, etc.).
• Visual Designer — Generates detailed DALL-E image prompts for each post based on the content and brand context.
• Video Scripter — Creates video scripts and Luma AI prompts for YouTube/video posts.

Credit System

Vivra uses a simple credit system to track usage. Credits are consumed when generating campaign content.

Credit Costs

Plans

Platform Setup

To auto-publish posts, you need to connect your social media accounts. Navigate to Dashboard > Accounts (the gear icon) to enter credentials for each platform.

Twitter / X

1. Go to developer.x.com and sign in with your Twitter account.
2. Create a new Project, then create an App inside that project.
3. Under Keys and Tokens, generate your API Key and API Secret.
4. Generate an Access Token and Access Token Secret.
5. Make sure your app permissions are set to Read + Write (not Read-only).
6. In Vivra, go to Accounts > Twitter and paste all four keys.

Instagram (Meta Graph API)

1. Switch your Instagram account to a Business or Creator account in the mobile app (Settings > Account > Switch to Professional).
2. Create a Facebook Page and link your Instagram account to it (Facebook Page Settings > Instagram).
3. Go to developers.facebook.com and create a new App (type: Business).
4. Add the Instagram Graph API product to your app. Add your Instagram as a tester and accept the invite.
5. Use the Graph API Explorer to generate an EAA token with the required permissions: instagram_basic, instagram_content_publish, pages_read_engagement.
6. Extend the token to a Long-Lived Token (valid for 60 days) using the token extension endpoint.
7. In Vivra, go to Accounts > Instagram and paste your Access Token and Instagram User ID.

YouTube

1. Make sure you have a YouTube channel created for the Google account you want to publish to.
2. Go to Google Cloud Console (console.cloud.google.com) and create a project.
3. Enable the YouTube Data API v3 for your project.
4. Create OAuth 2.0 credentials (Web Application type). Set authorized redirect URIs.
5. Use the OAuth 2.0 Playground (developers.google.com/oauthplayground) to authorize with your Client ID and Secret, then exchange for a Refresh Token.
6. In Vivra, go to Accounts > YouTube and paste your Client ID, Client Secret, and Refresh Token.

Campaign Workflow

Understanding the lifecycle of a campaign helps you manage your content effectively.

Campaign Statuses

Step by Step

1. Creation — You submit the idea. Status becomes Generating.
2. AI Generation — Four agents process the campaign (1-3 minutes). Status becomes In Review.
3. Review — You review the strategy and all generated posts. Edit text, swap images, modify with AI, or delete posts.
4. Approve — Click "Approve" and set a start date. Status becomes Active.
5. Publishing — The publisher cron runs every 5 minutes, publishing scheduled posts at their assigned times.
6. Published — Each post moves to Published status with a direct link to the live post.

Available Actions

• Pause campaign — Stops all future publishing. Can resume anytime.
• Resume campaign — Restarts publishing from where it left off.
• Delete campaign — Permanently removes the campaign and all its posts.
• Edit post — Modify the text of any individual post before it is published.
• AI Modify — Ask the AI to rewrite a specific post with new instructions.
• Generate image — Trigger DALL-E image generation for a specific post.
• Generate video — Trigger Luma AI video generation for a specific post.
• Publish now — Immediately publish a specific post without waiting for the schedule.

Brand Profile

A well-configured brand profile helps the AI generate more relevant and on-brand content for your campaigns.

Navigate to Dashboard > Accounts to configure your brand profile. You can set up the following:

• Brand name — Your company or brand name as it should appear in posts.
• Sector / Industry — Helps the AI understand your market context.
• Tone of voice — Professional, casual, humorous, inspirational, etc.
• Target audience — Who you are trying to reach (demographics, interests).
• Slogan — Your brand tagline, incorporated into content when relevant.
• Logo — Upload your brand logo. The system can extract a color palette from it.
• Color palette — Extracted from your logo or set manually. Used in image generation prompts.
• Language — Preferred language for generated content.
• Hashtags — Default hashtags to include in posts.
• Website — Your brand's website URL.
• Extra context — Additional information the AI should know about your brand, products, or marketing goals.

Frequently Asked Questions

How long does campaign generation take?

Typically 1-3 minutes depending on the number of posts and platforms. The AI runs four sequential agents (strategist, copywriter, visual designer, video scripter), and each takes a few seconds per post.

Can I edit posts after generation?

Yes, absolutely. You can edit any post at any time before it is published. You can modify the text manually or use the "AI Modify" feature to ask the AI to rewrite it with specific instructions.

What happens when credits run out?

When your credits reach zero, you won't be able to create new campaigns or generate new images/videos until your credits reset at the start of the next billing cycle — or you upgrade to a higher plan.

Are the DALL-E images unique?

Yes. Every image is generated from a unique prompt that the AI creates based on your specific post content, brand profile, and campaign context. No two images are the same.

Can I publish to TikTok?

TikTok auto-publishing is coming soon. Currently, the AI generates video scripts and Luma AI prompts for TikTok content, but you need to download and upload them manually. Auto-publish support is on our roadmap.

How does auto-publishing work?

Once a campaign is approved with a start date, the publisher runs every 5 minutes and checks for posts that are due. When a post's scheduled time has arrived, it publishes to the configured platform automatically using your API credentials.

Can I use Vivra for multiple brands?

Yes. Each plan supports at least one client account with independent credentials and brand profiles. The Pro plan supports one client, and higher tiers support multiple clients managed from a single dashboard.