MagicBolt AI

White Label & Agency Plan

Complete Setup Knowledge Base

Step-by-Step Guide for Non-Technical Users

Table of Contents

1. Understanding White Label Setup

2. Before You Start - Important Checklist

3. Step 1: Domain & DNS Setup (5 Records)

4. Step 2: Agency Panel Login & White Label Settings

5. Step 3: OpenAI API Key Setup

6. Step 4: Cloudflare R2 Integration (Media Storage)

7. Step 5: Kie.ai Integration (Image Generation)

8. Step 6: Google Cloud Console API Setup

9. Step 7: SMTP Email Setup (Primary Method)

10. Step 8: Digital Vcard & Digital Menu Setup

11. Step 9: Email Template Customization

12. Step 10: Final Checklist & Go Live

1. Understanding White Label Setup

What is White Label?

White Label allows you to rebrand MagicBolt AI as your own product. Your clients will see YOUR company name, YOUR logo, and YOUR domain - not MagicBolt AI.

What You'll Achieve:

• Your own branded login page (e.g., login.yourcompany.com)

• Custom Magic Link/QR domain (e.g., link.yourcompany.com)

• Your own Digital Business Card page (e.g., vcard.yourcompany.com)

• Your own Digital Menu page (e.g., menu.yourcompany.com)

• Your company logo throughout the platform

• Branded emails sent to your clients via your own SMTP

• Complete control over your agency operations
  

2. Before You Start - Important Checklist

Before beginning the setup process, ensure you have access to the following:

✅ Required Items:

3. Step 1: Domain & DNS Setup

What is DNS?

DNS (Domain Name System) is like a phone book for the internet. It tells browsers where to find your website when someone types your domain name. You'll be creating 5 subdomains that point to MagicBolt's servers.

You Need to Create 5 CNAME Records:

Step-by-Step Instructions:

Record 1: Customer Login Domain

Record 2: Magic Link/QR Domain

Record 3: Website/Custom Domain

Record 4: Digital Vcard Domain 🆕

Used for your clients' Digital Business Cards - a shareable online profile with contact info, links, and photo.

Record 5: Digital Menu Domain 🆕

Used for your clients' Digital Menus - ideal for restaurants, cafes, salons, or any business with a price list/service menu.

How to Add DNS Records (General Steps):

16. Log in to your domain registrar (GoDaddy, Namecheap, Cloudflare, etc.)

17. Find the DNS Management or DNS Settings section

18. Click 'Add Record' or 'Add New Record'

19. Select 'CNAME' as the record type

20. Enter the Host Name (login, link, web, vcard, or menu)

21. Enter the Value: 6b627031d5ffe764.vercel-dns-016.com

22. Set TTL to 'Automatic' or '3600' (1 hour)

23. Save the record

24. Repeat for all 5 records

4. Step 2: Agency Panel Login & White Label Settings

Now that your DNS records are set up, it's time to configure your white label settings in the Agency Admin Panel.

Accessing the Agency Panel

25. Open your web browser and go to: https://agency.magicbolt.ai/

26. Enter the Login ID and Password provided by the MagicBolt team

27. Click 'Sign In'

Configuring White Label Settings

28. After logging in, click on 'Settings' in the main menu

29. Navigate to the 'White Label' tab

A. Branding Details

• Company Logo: Upload your company logo (PNG or JPG, recommended 700X130 pixels)

• Contact Details: Add your company's contact information (optional but recommended)

• Social Media Links: Add links to your social media profiles (optional)

B. Customer Business Information

30. After filling all fields, click 'Save Settings'

C. Support Tab Settings

Navigate to the 'Support' tab and add your support contact information:

• Support Email Address

• Support Phone Number (optional)

• Support Hours (optional)

D. Socials Tab Settings

Navigate to the 'Socials' tab and add your social media profile links:

• Facebook Page URL

• Twitter/X Profile URL

• LinkedIn Company Page URL

• Instagram Profile URL

5. Step 3: OpenAI API Key Setup

OpenAI powers the AI features in MagicBolt. You'll need to create an account and generate an API key.

Step-by-Step Instructions:

31. Go to OpenAI's website: https://platform.openai.com

32. Click 'Sign Up' if you don't have an account, or 'Log In' if you do

33. After logging in, you'll see the Dashboard

34. Click on 'Get Started' (if you're new) or navigate to 'API Keys' in the left menu

35. Click 'Create New Secret Key' or 'Create API Key'

36. Give your key a name (e.g., 'MagicBolt Integration')

37. Click 'Create'

38. IMPORTANT: Copy the API key immediately - you won't be able to see it again!

39. Save the API key in a safe place (like a password manager)

Adding Your OpenAI API Key to MagicBolt

40. Go back to your MagicBolt Agency Panel

41. Navigate to Settings → Integrations

42. Find the 'OpenAI API Key' field

43. Paste your OpenAI API key

44. Click 'Save'

Setting Up Billing in OpenAI

45. In your OpenAI Dashboard, click on 'Billing' in the left menu

46. Click 'Add Payment Method'

47. Enter your credit/debit card information

48. Set a monthly budget limit if desired (recommended: $5 to start)

49. Click 'Save'

6. Step 4: Cloudflare R2 Integration (Media Storage)

Cloudflare R2 is used to store and manage all images and media used in your MagicBolt system (review images, generated images, menu item photos, etc.). It offers a generous free tier with zero fees for downloading/viewing files.

Step-by-Step Instructions:

Step 1: Create/Access Your Cloudflare Account

50. Go to: https://dash.cloudflare.com/sign-up

51. Sign up with your email, or log in if you already have a Cloudflare account (e.g., from setting up your DNS)

52. Verify your email address

Step 2: Create Your R2 Bucket

53. In the Cloudflare Dashboard, find “Storage and database > R2 Object Storage >Overview“ in the left sidebar menu

54. Click 'add R2 Subscription to my account' and add the Payment Method 

55. Give it a name, for example: GMB-media

56. Leave 'Location' as 'Automatic' (recommended)

57. Click 'Create Bucket'

Step 3: Enable Public Access

58. Open your newly created bucket

59. Go to 'Settings' tab

60. Find 'Public Development URL' section

61. Click 'Enable'.

62. Copy the Public URL shown - you'll need this later

Step 4: Generate API Credentials

63. In Sidebar, go to Manage account → Account API Token

64. Click 'CreateToken' button

65. Give it a name (e.g., 'GMB Integration') 

66. In the ‘Permission Policies’ section, go to ‘Edit Policy’ Choose R2 Buckets from the Entire account dropdown. And select the R2 Bucket.

67. In Developer Platform option - Select Read and Edit for Workers R2 Storage Bucket Item.

68. In the Client IP filtering section - Keep it Allow, and do not enter any IP.

69. Click on Review Token button.

70. Click on Create Token button.

Step 5: Add Cloudflare R2 to MagicBolt

71. Go to your MagicBolt Agency Panel → Integrations

72. Find the 'Cloudflare R2 / Media Storage' section

73. Enter your Account ID

74. Enter your Access Key ID

75. Enter your Secret Access Key

76. Enter your Bucket Name (from Step 3)

77. Enter your Public URL (from Step 3)

78. Click 'Save'

7. Step 5: Kie.ai Integration (Image Generation)

Kie.ai enables AI-powered image generation in MagicBolt. This feature allows you to create custom images for your clients' social media posts and marketing materials.

Step 1: Create Your Kie.ai Account

79. Visit: https://kie.ai/

80. Click 'Get Started'

81. Complete the sign-up process with your email

82. Verify your email and log in

Step 2: Navigate to API Keys

83. After logging in, look for the left sidebar menu

84. Click on 'API Keys'

85. You'll be redirected to the API Keys management page

Step 3: Copy Your API Key

86. Locate your generated API Key on the page

87. Click the copy icon to securely copy the key

88. Save it in a safe place

Step 4: Add the API Key to MagicBolt

89. Open your MagicBolt Agency Panel

90. Navigate to Integrations → Kie.ai

91. Paste your copied API Key into the 'Kie.ai API Key' field

92. Click 'Save' to complete the integration

08. Step 6: Google Cloud Console API Setup

Google Cloud Console APIs are required for Google Maps ranking, tracking features, and location-based services. Even if you don't have a Google Cloud account, you can create one easily using your Gmail account.

Part A: Create Google Cloud Account

93. Go to Google Cloud Console: https://console.cloud.google.com/

94. Sign in using your Gmail account

95. If this is your first time, Google will ask you to accept Terms of Service - click 'Agree and Continue'

Part B: Create a New Project

Projects in Google Cloud help you organize your API usage. You'll create one project for MagicBolt.

96. Look at the top of the page - you'll see 'Select a Project' (near the Google Cloud logo)

97. Click on 'Select a Project'

98. In the popup window, click 'NEW PROJECT' (top right corner)

99. Enter a project name. Example: YourCompanyName-GMB

100. Leave 'Organization' as 'No organization' (unless you have one)

101. Click 'CREATE'

102. Wait a few seconds while Google creates your project

Part C: Setup Billing Account

103. In Google Cloud Console, click the menu icon (three horizontal lines) in the top left

104. Scroll down and click 'Billing'

105. Click 'Link a Billing Account' or 'Add Billing Account'

106. If you don't have a billing account yet, click 'CREATE BILLING ACCOUNT'

107. Select your Country and click 'Continue'

108. Fill in your billing information (name, address)

109. Enter your credit/debit card details

110. Accept the terms and click 'START MY FREE TRIAL'

111. Link this billing account to your project

Part D: Enable Required APIs

You need to enable 4 specific APIs for MagicBolt to work properly. Don't worry - the interface makes this easy!

How to Enable Each API:

116. In Google Cloud Console, click the menu icon (☰) in the top left

117. Navigate to 'APIs & Services' → 'Library'

118. You'll see a search bar at the top - use this to find each API

For Each API (repeat 4 times):

• Step 1: Type the API name in the search bar (e.g., 'Distance Matrix API')

• Step 2: Click on the API when it appears in search results

• Step 3: Click the blue 'ENABLE' button

• Step 4: Wait a few seconds for it to enable

• Step 5: Go back to the API Library (click 'Library' in the left menu)

• Step 6: Search for and enable the next API

Part E: Create API Key

Now that your APIs are enabled, you need to create an API Key - this is like a password that MagicBolt will use to access Google's services.

119. In the left menu, go to 'APIs & Services' → 'Credentials'

120. At the top of the page, click '+ CREATE CREDENTIALS'

121. From the dropdown menu, select 'API key'

122. Google will create your API key - a popup will show your key

123. IMPORTANT: Click 'COPY' to copy your API key immediately

124. Paste it into a safe place (like Notepad or password manager)

125. Click 'CLOSE' on the popup

Part F: Add API Key to MagicBolt

126. Go to your MagicBolt Agency Panel

127. Navigate to Settings → Integrations

128. Find the 'Google Maps API Key' or 'Google Cloud API Key' field

129. Paste your copied API key

130. Click 'Save'

09. SMTP Setup for Google Workspace (Gmail)

What You'll Need

• A Google Workspace account (business Gmail) — not a free personal Gmail account, since those have sending limits and restrictions
• Admin access to your Google Workspace (or ask your IT/admin to help with 2 steps below)
• Access to your domain's DNS settings

Google requires 2-Step Verification to be turned on before you can create an App Password.

1. Go to: myaccount.google.com/security
2. Sign in with the Google Workspace email you want to send emails from
3. Under "How you sign in to Google," click 2-Step Verification
4. Follow the steps to turn it ON (usually via phone number/OTP)

Step 2: Generate an App Password

Your regular Gmail password will not work for SMTP — you need a special App Password.

1. Go to: myaccount.google.com/apppasswords
2. If asked, sign in again
3. Under "App name," type something like GMB SMTP
4. Click Create
5. Google will show you a 16-character password (example: abcd efgh ijkl mnop)
6. Copy this immediately — you won't be able to see it again
7. Save it in a safe place (you'll need it in Step 5)

💡 Note: If you don't see "App Passwords" as an option, your Google Workspace Admin may need to enable it first. Go to Admin Console → Security → Access and data control → Less secure apps (or ask your admin to allow "App Passwords" for your account).

Step 3: Note Your SMTP Connection Details

For Google Workspace / Gmail, the standard SMTP settings are:

Step 4: Add SPF and DKIM Records for Google

This tells other email providers that Google is authorized to send email on your domain's behalf — without this, your emails may go to spam.

SPF Record:

1. Go to your domain's DNS settings (same place you added your CNAME records earlier)
2. Add a new TXT record:
   • Host: @ (or leave blank, depending on your DNS provider)
   • Value: v=spf1 include:_spf.google.com ~all
3. Save

⚠️ If you already have an SPF record (e.g., from ZeptoMail), don't create a second one — combine both into a single TXT record instead. Example: v=spf1 include:_spf.google.com include:zeptomail.zoho.in ~all

DKIM Record:

1. Log in to your Google Admin Console (admin.google.com)
2. Go to Apps → Google Workspace → Gmail → Authenticate email
3. Select your domain and click Generate New Record
4. Google will give you a DKIM host name and TXT value — copy both
5. Go back to your domain's DNS settings
6. Add a new TXT record using the exact host name and value Google gave you
7. Return to Google Admin Console and click Start Authentication

Step 5: Add SMTP Settings to MagicBolt

1. Go to your MagicBolt Agency Panel → Settings → Integrations → Email (SMTP)
2. Enter the following:
   • SMTP Host: smtp.gmail.com
   • SMTP Port: 587
   • Username: your full Google Workspace email
   • Password: the App Password from Step 2
   • Encryption: TLS
   • From Name: your brand name
   • From Email: same as your username (must match)
3. Click Save
4. Click Send Test Email to confirm it's working

09. Final Checklist & Next Steps

Before Going Live - Verify Everything:

Need Help?

• Support Email: Contact our support team

• Documentation: Refer to this guide anytime

• Share Screenshots: If facing issues, send screenshots to help us assist you faster

Thank you for choosing MagicBolt AI!

— Team MagicBolt.ai