Setup Guide

Deploy your first Wingman

From signup to your first autonomous post in under 10 minutes. This guide walks through every step, every field, and every setting.

01

Create your account

Go to engagewingman.io/login and click Sign up. You can sign up with your Google account or an email and password.

If you use email, check your inbox — a verification link will be sent before you can log in.

NOTE

Google sign-in is verified automatically — no email confirmation step needed.

Trial access

Every new account gets 15 free dry-run previews — you can see exactly what your Wingman would post before going live. No card required to start. Upgrade to a paid plan to enable live posting.

02

Connect a platform

From the Control Center, click Connect X or Connect Bluesky. Each connection becomes a separate Wingman.

Connecting X (Twitter)

  1. Click Connect X on the dashboard
  2. You are redirected to X to authorize access
  3. Approve — EngageWingman gets permission to post and read your timeline
  4. You are returned to the dashboard with your Wingman ready to configure
NOTE

X tokens expire after approximately 2 hours. EngageWingman refreshes them automatically — you never need to reconnect unless you revoke access from X's Connected Apps settings.

Connecting Bluesky

  1. Click Connect Bluesky on the dashboard
  2. Enter your Bluesky handle (e.g. yourname.bsky.social)
  3. Enter an App Password — create one at bsky.app → Settings → App Passwords
  4. Click Connect — credentials are encrypted immediately and never stored in plain text
TIP

Use a dedicated App Password for EngageWingman so you can revoke access independently without changing your main password.

03

Configure your Wingman

After connecting a platform, the 4-step configuration wizard opens. All answers feed into your Wingman's AI prompt — be specific for best results.

Step 1 — Brand

Brand namerequired

Your business or personal brand name. Used in every generated post.

Website URL

Where to send traffic. Appended to promotional posts and mention replies.

One-line descriptionrequired

What you do and who you serve. Example: 'We help Poshmark resellers grow their closets with automation tools.' Be specific — vague descriptions produce generic posts.

Platformrequired

Choose X or Bluesky. This is set automatically from your connected account.

Step 2 — Audience

Target audiencerequired

Who reads your posts? Pick a preset persona (founders, creators, marketers, developers, resellers, local customers) or write a custom description. Example: 'Solo female resellers, ages 25–45, selling on Poshmark and Mercari, looking to make an extra $500–$2,000/mo.'

Step 3 — Style

Tonerequired

Choose from Professional, Casual, Witty, or Friendly — or describe a custom tone. This shapes every word the Wingman writes.

Aggressivenessrequired

How many posts per day: Conservative (~3), Balanced (~5), Active (~7). All within platform rate limits.

Content mixrequired

Authority-first (more tips and value content), Growth-first (more replies and engagement), or Balanced. Controls the weighted ratio of post types.

Step 4 — Topics

Platform quick-pick

Eight preset configurations: Poshmark, Instagram, Dance, Etsy, YouTube, SaaS, Podcast, Local Business. Selecting one auto-fills Topics, Hashtags, and Traffic Destination. You can customize after.

Topicsrequired

Comma-separated keywords your Wingman will search for in real-time conversations. Examples: 'content marketing, SaaS growth, indie hacker' — or 'thrifting, Poshmark haul, reselling tips'. The more specific, the more relevant the replies.

Hashtags to monitor

Hashtags your Wingman watches for engagement opportunities. Do not include the # — it is added automatically.

Traffic destination

The URL you want to drive people to. Could be your Etsy shop, Poshmark closet, app landing page, etc. Used in promotional posts.

04

Field reference — Edit Wingman

After your Wingman is deployed, click Edit on the Control Center to access all settings. Changes apply to the next scheduled run.

Brand Info

brand_name

Your business or brand name. Shown in notifications and used in post generation.

brand_url

Primary URL. Appended to promotional content for traffic attribution.

brand_description

Full description of what you offer and who you serve. More detail = better posts. This feeds directly into the AI generation prompt.

traffic_destination

Where to send clicks — can differ from brand_url. Use a specific landing page, product page, or closet link.

Voice & Tone

tone

Free-text description of your writing style. Examples: "Confident and direct, like a mentor. Never uses exclamation points. Occasionally dry humor."

Search Topics

topics

One query per line. Each line is a separate real-time search your Wingman runs to find conversations. Be specific: "poshmark selling tips" outperforms "selling".

Content Mix

original_promo

Weight for promotional posts — posts that pitch your brand, product, or offer.

original_value

Weight for value/educational posts — tips, insights, how-tos that build authority.

reply_engagement

Weight for reply posts — joining relevant conversations found via topic search.

product_tweet

Weight for product posts — pulls a real product from your feed and tweets it with price, image, and link.

daily_mix

A balanced daily schedule — 4 product posts + 3 original posts, shuffled uniquely each day.

NOTE

Weights are relative. Setting two types to 50 each means a 50/50 split. Only enabled types are used.

Required Hashtags

required_hashtags

Hashtags appended to every post. Enter without the # — it is added automatically. Keep to 1–3 for X; Bluesky handles hashtags differently (they are clickable by convention but not algorithmically weighted).

Guardrails

max_posts_per_day

Hard ceiling on posts per day across all types. Default is 7. Prevent your account from over-posting during catch-up runs.

max_replies_to_same_user_per_week

Prevents the Wingman from reply-bombing the same account. Default is 2. Keeps engagement natural.

max_reply_length

Character limit on replies. X enforces 280 characters; Bluesky allows 300. Wingman will trim to this limit.

Dry-Run Mode

dry_run

When enabled, all posts are simulated — generation runs, logs are written, Slack notifications fire, but nothing is published to the platform. Use this to audit your agent's output before going live.

TIP

During your free trial, all 15 previews run in dry-run mode automatically. Upgrade to a paid plan to post live.

05

Deploy and go live

From the Wingman Control Center, flip the Active toggle. Your Wingman is immediately enrolled in the dispatch schedule — it will fire at the next scheduled slot.

Use Post Now to trigger an immediate post outside the schedule. This is useful for testing or for posting a product when you just added new inventory.

NOTE

Schedule times shown in the Control Center are approximate — each job fires with ±15-minute random jitter to avoid predictable bot patterns.

Default schedule

Out of the box, your Wingman runs these jobs (times approximate, all in CST):

7:00amProduct post
9:00amOriginal promo post
11:00amEngagement reply run
1:00pmProduct post
3:00pmValue / educational post
5:00pmProduct post
7:00pmProduct post
3:00amMention check
2:00amProduct feed sync
06

Load your product feed

Product posting is the most powerful feature for e-commerce brands. Your Wingman picks a product from your inventory, writes a post with price and link, attaches the product image, and publishes — automatically, every day.

Standard CSV feed (all customers)

Upload your inventory as a CSV to Google Drive, share it publicly ("Anyone with the link can view"), and paste the share URL into the Product Feed field in Edit Wingman.

TIP

Keep the file at the same Google Drive URL — just overwrite it with an updated CSV when inventory changes. The Wingman syncs nightly automatically.

CSV column reference:

namerequiredProduct or listing title
pricerequiredCurrent price. Accepts $25.00 or 25.00
linkrequiredURL to the product listing page
image_urloptionalDirect image URL — attached to the post as a photo
brandoptionalBrand name — auto-added as hashtag if set
categoryoptionalProduct category
descriptionoptionalShort description used for context in generation
in_stockoptional1/yes/true = available, 0/no/false = skip. Defaults to in-stock if omitted
inventoryoptionalStock count. Products with 0 inventory are skipped even if in_stock is true
skuoptionalUnique identifier. Falls back to link or title if omitted
sale_priceoptionalSale price — post shows 'was $X, now $Y' if set
was_priceoptionalOriginal price before sale

Poshmark sellers

Export your inventory from Poshmark (Account → My Seller Tools → Inventory Report) and upload the CSV to Google Drive. EngageWingman auto-detects the Poshmark format and enriches each row with your listing URL and cover image from Poshmark's API. No extra configuration needed — just upload and paste the Drive link.

Syncing manually

On the Wingman Control Center, scroll to the Product Feed panel and click ↻ Sync Now. The sync runs in the background — stat pills update automatically when complete. The feed also syncs automatically every night at 2:00am CST.

07

Review the Activity feed

The Activity page (dashboard nav) shows every post your Wingman has attempted — with status, content type badge, timestamp, and a direct link to view it on the platform.

PostedConfirmed live on the platform
PendingQueued or in-flight
FailedSomething went wrong — click ↺ Retry to requeue
Dry-runSimulated — not published; visible during trial or when dry-run mode is on
TIP

Failed posts can be retried individually with one click — no need to wait for the next scheduled run.

08

Analytics

The Analytics page shows post volume by day (bar chart), content type breakdown (horizontal bars), per-Wingman performance table, and top posts ranked by engagement score.

Engagement score formula:

score = likes + (replies × 2) + (retweets × 3)

The A/B Content Learning card on each Wingman's detail page shows which writing style is winning — Variant A (default) or Variant B (question-hook opener). Weights auto-adjust weekly toward the winning variant.

09

Settings and billing

Plan and billing

Go to Dashboard → Billing to upgrade, add Wingmen, or manage your subscription. Plans auto-renew monthly or annually. Cancel at any time — access continues through the end of the paid period.

Extra Wingmen can be added at $40/mo each on any plan — handy if you manage multiple brands or social accounts.

Referral program

Find your referral link in Settings. When someone signs up and subscribes using your link, you both get a $10 credit applied to your next billing cycle automatically.

Notifications

Add a Slack webhook URL in Settings to receive real-time notifications for every post your Wingman publishes. A daily digest is also available.

10

Tips for best results

Write a detailed brand description

The single biggest lever. Two sentences about who you serve and what pain you solve is worth more than any other setting.

Use specific search topics

"Poshmark seller tips" outperforms "selling". "SaaS churn rate" outperforms "SaaS". Specific topics find better conversations.

Start in dry-run mode

Run 15–20 previews before going live. Read every generated post. Adjust tone and description if anything feels off.

Load your product feed before activating

Sync your inventory first so product_tweet jobs have something to post on day one.

Keep required hashtags to 1–2

More hashtags hurt reach on X. One strong brand hashtag is better than five weak ones.

Check Activity every morning

Two minutes reviewing what your Wingman posted overnight keeps you informed and catches any edge cases early.

Use the Retry button

If a post fails due to a transient API error, retry it immediately from the Activity feed rather than waiting for the next scheduled run.

Ready?

Deploy your first Wingman now

15 free previews. No card required. Live posting from $49/mo.

Get Started Free