AdWhispr documentation
AdWhispr is an advertising assistant you talk to. It researches the ads your competitors are running, turns the winners into image and video creatives for your brand, and launches and manages real campaigns on Meta, Google and TikTok. You do all of it in a chat, and nothing spends until you say so.
Platform references
Everything you can do on each platform, with the exact prompts.
Image, carousel and video ads on Facebook and Instagram, creative tests, radius and interest targeting, retargeting audiences, budgets and in-place copy edits.
Open the reference →Search campaigns with keywords and responsive search ads, Performance Max, keyword and negative-keyword management, location edits, and what Google policy will and will not allow.
Open the reference →Video campaigns from your own footage, creative tests, the identity and payment requirements, pixel-based sales campaigns and budget minimums.
Open the reference →What AdWhispr does
1. Research competitor ads
Save your brand from a website or a sentence. Ask who is advertising in your space and you get advertisers verified to be running ads right now, ranked by active ads, with local rivals for local businesses. Pull any brand’s active ads sorted by how long they have run, search them by idea, compare brands, or get a full brief. Google keyword data and TikTok and Instagram research are in the same chat.
2. Generate creatives
Clone a competitor’s image ad into a new image with your product, logo and colors. Turn a winning video ad, your own script, or nothing but your niche into a finished vertical video with a native AI voice. You approve a script first, and only the render uses video credits. Finished creatives land in your Creative Library, ready to launch.
3. Launch and manage real campaigns
Connect your own Meta, Google or TikTok ad account and launch complete campaigns from the chat: paused, previewed, confirmed by you. Then read the results, pause losers, move budgets, fix keywords and edit copy, with a confirmation on every change that costs money.
How the chat works
You type what you want in plain words. The assistant picks the right AdWhispr action, runs it, and shows you the result inline: competitor ads with their images and videos, a generated creative, a campaign preview, or a performance table. A few rules hold everywhere:
- Everything is created paused. A launch builds the campaign, ad set and ad in your account with delivery off. It starts spending only when you resume it, and resuming asks you to confirm.
- Spend changes are two steps. Launching, resuming, budget changes, keyword changes and location edits first return a preview. You say yes, and the same request runs for real. Pausing is one step because it only stops spend.
- Targeting is opt-in. If you do not mention a country, age, gender, interest or device, the launch uses sensible defaults and the preview marks each one as default, so you can adjust before confirming.
- Ids come from lookups, never guesses. Interests, cities, audiences and pixels are looked up on the platform first and shown to you to confirm.
- Numbers are never invented. Competitor research reports days running, formats and hooks. It does not report click-through rates, cost per click or return on ad spend for other people’s ads, because the ad libraries do not expose them. Your own account’s numbers are read directly from the platform.
You can chat in the AdWhispr dashboard (Ask Whispr) or inside the assistant you already use: Claude, ChatGPT, Cursor, Grok and others. It is one account, so a brand you save in Claude is there in the dashboard. If you installed AdWhispr from the Claude connector directory, image and video generation happen in the dashboard, and the finished creatives launch from either place. A few newer actions (Google keyword management, Meta audience creation and the account-state read) reach the dashboard chat and the full connector first, before the directory listing.
Connect your ad accounts
Connecting is free on every plan and takes a minute per platform. You sign in on the platform’s own screen and grant access; AdWhispr never sees your password. Two ways to start:
- In the dashboard, open Settings, then Connected accounts, and pick Meta Ads, Google Ads or TikTok Ads.
- In any chat, say Connect my Meta ad account (or Google, or TikTok). You get a sign-in link, and once you finish, your ad accounts appear in the chat.
What each platform needs before an ad can run:
- Meta: a Facebook Page the connected profile has a role on (ads run from a Page), a payment method on the ad account, and a Meta pixel if you want a sales campaign.
- Google Ads: a regular Google Ads account with billing set up. Manager accounts can only oversee other accounts and cannot hold campaigns. Performance Max also needs conversion tracking.
- TikTok Ads: a payment method under Billing, and your TikTok account linked to the ad account as an identity (Ads Manager, Assets, Identity), because TikTok no longer allows ads under a made-up name.
If a connection stops working, reconnect it under Settings, Connected accounts. Meta connections also expire after a while and whenever you change your Facebook password.
Guides by business goal
All guides →Launching your first campaign through chat
A step-by-step walkthrough of your first ad launch with AdWhispr on Meta, Google or TikTok: connect the account, get a creative ready, launch it paused, check the preview, and resume it when you are ready to spend.
Read →Choosing a campaign objective by business type
Which objective to pick when you launch through AdWhispr, explained for an online store, a local service business and a lead-driven business, with what each objective needs on Meta, Google and TikTok.
Read →Running a creative test: several ads competing for one budget
How to test a video against images on Meta, several videos on TikTok, and headlines on Google through AdWhispr, with each creative competing inside one ad set or ad group so the budget flows to the winner.
Read →Retargeting website visitors with a Meta pixel audience
Build a Meta Custom Audience of your website visitors from the pixel with a lookback window and excluded purchasers, add a lookalike, and launch a retargeting ad to it, all from the AdWhispr chat.
Read →Radius targeting for local businesses
Target everyone within a set distance of your shop or clinic on Meta by giving a street address and a radius in kilometers, and reach a local area on Google with location targeting, all from the AdWhispr chat.
Read →Cloning competitor ads into your own creatives
How to find a competitor's longest-running ad and turn it into an image or a finished video for your own brand with AdWhispr: save your brand and product, clone an image ad, approve a video script, and launch the result paused.
Read →Prompt cookbook
56 copy-paste prompts grouped by goal: research, creative, launch, manage and optimize. Each one says exactly what happens when you send it.
Who are my competitors running ads right now?
Here are five advertisers in your space verified to be running ads today, ranked by active ads. Want me to pull the top one’s longest-running ads?
Troubleshooting
All errors →Please authenticate your account (Meta, subcode 3858385)What Meta's 'Please authenticate your account' error (subcode 3858385) means when you launch an ad through AdWhispr, why it blocks every new ad, and the two fixes: clear the verification prompt in Ads Manager, or turn on two-factor authentication for the Facebook profile that connected.
Facebook Page is Missing (Meta, subcode 1443121)Why Meta rejects an ad with 'Facebook Page is Missing' (subcode 1443121) when launching through AdWhispr: the chosen Page is unpublished or the connected profile has no role on it. How to pick another Page or add a Page role and relaunch.
Budget is too low (Meta ad set minimum, subcode 1885272)What Meta's 'budget is too low' error (subcode 1885272) means when launching through AdWhispr, how Meta's minimum daily ad set budget works in your account's currency, and how to relaunch above it.
Could not geocode address (Meta radius targeting, subcode 1487855)Why Meta answers 'Could not geocode address' (subcode 1487855) when you target a radius around an address through AdWhispr, and how to fix it with a fuller street address or by targeting the city instead.
No advertiser information for Singapore (Meta verification, subcodes 3858548 and 3858550)What Meta requires before an ad can reach Singapore: the Singapore ad declaration, which AdWhispr adds automatically, and a verified advertiser on the ad account (subcode 3858548), which only you can complete. How to verify or remove Singapore and relaunch.
Error validating access token: Session has expired (Meta, code 190)Why Meta returns 'Session has expired' or 'Error validating access token' (code 190) when AdWhispr acts on your ad account: the connection died after a password change, an expiry, or a revoked grant. Reconnect under Settings and relaunch.
What’s new
Full changelog →- One end card, and the raw take always in your library
- Clearer next steps on platform errors, in every language
- Radius targeting around a street address on Meta
Frequently asked questions
- Does AdWhispr spend money without asking me?
- No. Every campaign is created paused. Anything that affects spend, such as resuming a campaign or changing a budget, shows a preview and waits for your confirmation.
- Which ad platforms can AdWhispr launch on?
- Meta (Facebook and Instagram), Google Ads (Search and Performance Max) and TikTok Ads. Competitor research covers the Meta ad library, TikTok, Instagram content and Google keyword data.
- Where do I chat with AdWhispr?
- In the Whispr chat in the AdWhispr dashboard, or inside Claude, ChatGPT, Cursor, Grok and other assistants once you connect AdWhispr to them. The same account and connected ad accounts work everywhere.
- Does connecting an ad account cost anything?
- Connecting is free on every plan. Launching, optimizing and the performance analysis are part of the paid plans; a free account gets an upgrade link when it asks for those.
- Do I need a website or product page first?
- Research works from a website or a one-line description of your business. Video ads about a specific product look far better when you add its product page, because they use your real product photos.
