AI Studio

Generate campaign text, widget HTML, and strategy suggestions from AI endpoints.

Audience: Content, CRM, and growth teams accelerating campaign and widget ideation.

Critical: Generation endpoints require AI generate permissions and should be reviewed before direct production publishing.

AI Personalization AI Performance Campaigns Module

Who This Page Is For

Use this page when you need structured AI-assisted output for copywriting, HTML widget drafts, and campaign strategy direction.

Quick Start (2-5 Minutes)

Generate text copy

Use tone/language/context inputs for campaign text suggestions.

POST /api/v1/ai/generate-text

Generate widget HTML

Draft widget markup from prompt and optional context.

POST /api/v1/ai/generate-html

Generate strategy recommendation

Get high-level campaign strategy guidance from business context.

POST /api/v1/ai/generate-strategy

Inspect campaign insight

Read AI insight for one campaign performance context.

GET /api/v1/ai/insights/:campaignId

Publish through normal module workflow

Review and apply AI output via campaigns/widgets modules.

Do not auto-publish unreviewed AI outputs.

AI Studio endpoints

POST /api/v1/ai/generate-text
POST /api/v1/ai/generate-html
POST /api/v1/ai/generate-strategy
GET  /api/v1/ai/insights/:campaignId

Required Fields / Minimum Payload

Field	Required	Type	Used by events	Description
`tone`	Required	`urgent \| friendly \| premium \| playful \| professional \| engaging`	generate-text	Output tone style target.
`language`	Required	`string`	generate-text	Output language code.
`productName`	Recommended (Copywriter UI required)	`string`	generate-text	Main product/offer context for generation.
`targetAudience`	Recommended (Copywriter UI required)	`string`	generate-text	Audience profile the copy should address.
`ctaGoal`	Recommended (Copywriter UI required)	`string`	generate-text	What action the CTA must drive.
`prompt`	Required	`string`	generate-html	Primary instruction for HTML output generation.
`businessDescription`	Required	`string`	generate-strategy	Business context grounding for strategy output.
`campaignId`	Required	`uuid/string`	insights endpoint	Target campaign for insight retrieval.

generate-text example

{
"campaignType": "discount",
"widgetType": "announcement_bar",
"tone": "urgent",
"language": "en",
"maxLength": 90,
"brandName": "Acme",
"discountValue": "20%",
"avoidEmojis": true,
"productName": "Summer Collection 2026",
"targetAudience": "new visitors",
"ctaGoal": "Drive users to click Shop Now",
"primaryBenefit": "Limited-time discount on best sellers",
"painPoint": "Visitors postpone purchases without urgency",
"proofPoint": "Trusted by 15,000+ customers",
"keywordsToInclude": "limited-time, free shipping",
"keywordsToAvoid": "cheap",
"additionalContext": "Keep claims realistic and concise"
}

Recommended Smart Copywriter Brief

For stronger output quality in Smart Copywriter, provide at least:

productName
targetAudience
ctaGoal

Then enrich with optional context fields such as primaryBenefit, painPoint, proofPoint, and keyword guidance.

Event or Endpoint Decision Matrix

Scenario	Use This	Why
Need CTA and message variants quickly	POST /ai/generate-text	Fast copy iteration with tone controls.
Need prototype widget markup	POST /ai/generate-html	Converts intent into initial HTML draft.
Need strategic direction before launch	POST /ai/generate-strategy	High-level planning aid from business context.
Need campaign-specific AI interpretation	GET /ai/insights/:campaignId	Campaign-level insight retrieval.
Need production rollout	Campaign/widget module workflows	Governed publish path with review controls.

Common Errors and Fixes

Text output too generic

Cause: Insufficient context in payload fields.

Fix: Provide richer brand, audience, and product context.

HTML output not usable directly

Cause: Prompt lacks structural constraints or design requirements.

Fix: Specify layout, CTA, and style constraints in prompt/context.

Strategy output not aligned with business goals

Cause: goal/targetAudience omitted in request.

Fix: Include explicit goals and audience profile.

Permission denied for generation calls

Cause: Role missing AI generate permissions.

Fix: Grant ai:generate capability for relevant users.

Production Checklist

All AI-generated outputs are human-reviewed before publishing.Required
Prompt templates are standardized for quality consistency.Required
Campaign insights are checked against actual KPI data.Required
AI endpoint access is limited to authorized roles.Required
Output quality is tracked with post-launch performance metrics.Required