Back to Details

sales-buttondown

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Buttondown Platform Help

Buttondown平台帮助

Step 1 — Gather context

步骤1 — 收集背景信息

If 
references/learnings.md
exists, read it first for accumulated platform knowledge.
Ask the user:
  1. What area of Buttondown do you need help with?
    • A) Writing & sending emails — Markdown editor, scheduling, drafts
    • B) Subscribers — importing, tagging, segments, managing subscribers
    • C) Paid subscriptions — Stripe setup, paywalls, pricing tiers (for strategy, hand off: 
      /sales-newsletter {your question}
      )
    • D) Automations — welcome sequences, tag-triggered flows, surveys
    • E) Custom domains — sending domain, archive hosting
    • F) RSS-to-email — auto-sending from blog posts
    • G) API & CLI — programmatic subscriber/email management
    • H) Integrations — Zapier, Discord, webhooks, Memberful
    • I) Migration — moving from Substack, Mailchimp, Kit, or another platform
    • J) Analytics — open rates, click tracking, subscriber growth
    • K) Account & billing — plans, add-ons, teams, multiple newsletters
    • L) Something else — describe it
  2. What plan are you on?
    • A) Free (100 subscribers)
    • B) Basic ($9/mo, 1K subscribers)
    • C) Standard ($29/mo, 5K subscribers)
    • D) Professional ($79/mo, 10K subscribers)
    • E) Advanced or Enterprise
    • F) Not sure
Skip-ahead rule: if the user's prompt already contains enough context, skip to Step 2.
如果存在
references/learnings.md
文件，请先阅读它以获取已积累的平台相关知识。
向用户询问：
  1. 你需要Buttondown哪方面的帮助？
    • A) 邮件撰写与发送 — Markdown编辑器、日程安排、草稿管理
    • B) 订阅者 — 导入、标签设置、细分群体、订阅者管理
    • C) 付费订阅 — Stripe设置、付费墙、定价层级（若涉及策略，请转交：
      /sales-newsletter {你的问题}
      ）
    • D) 自动化功能 — 欢迎序列、标签触发流程、调查问卷
    • E) 自定义域名 — 发送域名、存档托管
    • F) RSS转邮件 — 从博客文章自动发送邮件
    • G) API与CLI — 程序化订阅者/邮件管理
    • H) 集成功能 — Zapier、Discord、Webhooks、Memberful
    • I) 迁移 — 从Substack、Mailchimp、Kit或其他平台迁移
    • J) 数据分析 — 打开率、点击追踪、订阅者增长
    • K) 账户与账单 — 套餐、附加功能、团队管理、多新闻通讯
    • L) 其他问题 — 请描述具体内容
  2. 你使用的是哪个套餐？
    • A) 免费版（最多100名订阅者）
    • B) 基础版（每月9美元，最多1000名订阅者）
    • C) 标准版（每月29美元，最多5000名订阅者）
    • D) 专业版（每月79美元，最多10000名订阅者）
    • E) 高级版或企业版
    • F) 不确定
跳过规则：如果用户的提问已包含足够背景信息，直接进入步骤2。

Step 2 — Route or answer directly

步骤2 — 转办或直接解答

If the question is about...Hand off
Email marketing strategy across tools"This is an email marketing strategy question — run: 
/sales-email-marketing {your question}
"
Newsletter monetization strategy"This is a newsletter monetization question — run: 
/sales-newsletter {your question}
"
Growing your subscriber list"This is an audience growth question — run: 
/sales-audience-growth {your question}
"
Deliverability, SPF/DKIM/DMARC"This is a deliverability question — run: 
/sales-deliverability {your question}
"
Connecting Buttondown to other tools"This is a tool integration question — run: 
/sales-integration {your question}
"
Answer directly when the question is Buttondown-specific — platform config, UI navigation, API usage, Stripe setup, add-on features.
如果问题涉及...转办方式
跨工具电子邮件营销策略"这属于电子邮件营销策略问题，请执行：
/sales-email-marketing {你的问题}
"
新闻通讯变现策略"这属于新闻通讯变现问题，请执行：
/sales-newsletter {你的问题}
"
订阅者列表增长"这属于受众增长问题，请执行：
/sales-audience-growth {你的问题}
"
送达率、SPF/DKIM/DMARC"这属于送达率问题，请执行：
/sales-deliverability {你的问题}
"
Buttondown与其他工具的连接"这属于工具集成问题，请执行：
/sales-integration {你的问题}
"
当问题是Buttondown平台专属问题时，直接解答——包括平台配置、UI导航、API使用、Stripe设置、附加功能等。

Step 3 — Buttondown platform reference

步骤3 — Buttondown平台参考资料

Read 
references/platform-guide.md
 for the full platform reference — modules, pricing, integrations, data model, workflows.
Answer the user's question using only the relevant section. Don't dump the full reference.
**阅读
references/platform-guide.md
**获取完整平台参考信息——模块、定价、集成、数据模型、工作流程。
仅使用相关部分解答用户问题，不要直接粘贴完整参考资料。

Step 4 — Actionable guidance

步骤4 — 可操作指导

You no longer need the platform guide — focus on the user's specific situation.
Provide step-by-step instructions with:
  1. Exact navigation — where to click in the Buttondown dashboard
  2. Settings to configure — specific fields, values, toggles
  3. Plan requirements — flag if a feature requires an add-on or higher plan
  4. Verification steps — how to confirm it's working
If you discover a gotcha, workaround, or tip not covered in 
references/learnings.md
, append it there.
此时无需再查阅平台指南，专注于用户的具体情况。
提供分步说明，包含：
  1. 精确导航路径 — 在Buttondown控制台中点击的具体位置
  2. 需配置的设置 — 具体字段、数值、开关选项
  3. 套餐要求 — 标注功能是否需要附加服务或更高等级套餐
  4. 验证步骤 — 如何确认功能正常运行
如果发现
references/learnings.md
中未涵盖的注意事项、替代方案或技巧，请将其添加到该文件中。

Gotchas

注意事项

Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.
  1. Most features are paid add-ons — tagging, analytics, paid subscriptions, automations, and RSS-to-email each cost $9-$29/mo extra on top of the base plan. Don't assume a feature is available — check which add-ons the user has enabled.
  2. Sending limit assumes daily max — pricing is based on sending at most one email per day to your entire subscriber base. If you need higher frequency, contact Buttondown for custom pricing.
  3. Automations add-on is $29/mo — unlike Kit or Mailchimp where automations are included, Buttondown charges separately. Welcome sequences require this add-on.
  4. API is available on all plans including free — unlike many competitors, even free-tier users can use the full REST API. Auth is 
    Authorization: Token {key}
    with base URL 
    https://api.buttondown.com/v1/
    .
  5. Concierge migration is free — Buttondown migrates your subscriber list from any platform at no cost, usually within one business day. Don't try to do complex migrations manually.
基于研究的最佳实践——请重点关注这些内容，尤其是关于套餐限制功能和集成注意事项的部分，这些信息可能会过时。
  1. 多数功能为付费附加服务 — 标签、数据分析、付费订阅、自动化功能和RSS转邮件，每项在基础套餐之外需额外支付每月9-29美元。不要默认功能可用，请确认用户已启用哪些附加服务。
  2. 发送限制基于每日最大值 — 定价基于每天最多向所有订阅者发送一封邮件的标准。如果需要更高发送频率，请联系Buttondown获取定制定价。
  3. 自动化附加服务每月29美元 — 与Kit或Mailchimp不同，Buttondown的自动化功能需单独收费。欢迎序列需要此附加服务。
  4. 所有套餐（包括免费版）均可使用API — 与许多竞品不同，即使是免费版用户也能使用完整的REST API。认证方式为
    Authorization: Token {key}
    ，基础URL为
    https://api.buttondown.com/v1/
    。
  5. 专人迁移服务免费 — Buttondown可免费将你的订阅者列表从任意平台迁移过来，通常在一个工作日内完成。请勿尝试手动完成复杂迁移。

Related skills

相关技能

  • /sales-newsletter
    — Newsletter monetization strategy (paid subscriptions, sponsorships, premium tiers)
  • /sales-email-marketing
    — Cross-platform email marketing strategy (broadcasts, automation, segmentation)
  • /sales-audience-growth
    — Audience growth strategy (lead magnets, cross-promotion, referral programs)
  • /sales-deliverability
    — Cross-platform deliverability (SPF/DKIM/DMARC, warmup, inbox placement)
  • /sales-kit
    — Kit (formerly ConvertKit) platform help — direct competitor
  • /sales-ghost
    — Ghost platform help — newsletter + publishing alternative
  • /sales-mailerlite
    — MailerLite platform help — affordable newsletter alternative
  • /sales-digital-products
    — Selling digital products alongside your newsletter
  • /sales-integration
    — Connect Buttondown to CRM and other tools via API, Zapier, webhooks
  • /sales-do
    — Not sure which skill to use? The router matches any sales objective to the right skill. Install: 
    npx skills add sales-skills/sales --skill sales-do
  • /sales-newsletter
    — 新闻通讯变现策略（付费订阅、赞助、高级层级）
  • /sales-email-marketing
    — 跨平台电子邮件营销策略（批量发送、自动化、细分）
  • /sales-audience-growth
    — 受众增长策略（引流赠品、跨平台推广、推荐计划）
  • /sales-deliverability
    — 跨平台送达率（SPF/DKIM/DMARC、邮箱预热、收件箱投递）
  • /sales-kit
    — Kit（原ConvertKit）平台帮助——直接竞品
  • /sales-ghost
    — Ghost平台帮助——新闻通讯+发布替代方案
  • /sales-mailerlite
    — MailerLite平台帮助——高性价比新闻通讯替代方案
  • /sales-digital-products
    — 搭配新闻通讯销售数字产品
  • /sales-integration
    — 通过API、Zapier、Webhooks将Buttondown与CRM及其他工具连接
  • /sales-do
    — 不确定使用哪个技能？该路由可将任何销售目标匹配到合适的技能。安装方式：
    npx skills add sales-skills/sales --skill sales-do

Examples

示例

Example 1: Setting up paid subscriptions

示例1：设置付费订阅

User says: "How do I charge for my newsletter on Buttondown?" Skill does: Walks through enabling the Paid Subscriptions add-on, connecting Stripe, configuring pricing tiers, and setting up paywalled content with the paywall toggle Result: User has a working paid newsletter with Stripe payments
用户提问："我如何在Buttondown上为我的新闻通讯设置收费？" 技能操作：引导用户启用付费订阅附加服务、连接Stripe、配置定价层级，并通过付费墙开关设置付费内容 结果：用户拥有可正常运行的Stripe付费新闻通讯

Example 2: Migrating from Substack

示例2：从Substack迁移

User says: "I want to move my 2,000 subscribers from Substack to Buttondown" Skill does: Recommends using Buttondown's free concierge migration service, explains what transfers (subscribers, archives), flags what doesn't (Substack-specific features like Notes), and covers domain authentication setup Result: User has a migration plan with zero subscriber loss
用户提问："我想把我的2000名订阅者从Substack迁移到Buttondown" 技能操作：推荐使用Buttondown的免费专人迁移服务，说明可迁移内容（订阅者、存档），标注不可迁移内容（Substack专属功能如Notes），并涵盖域名认证设置 结果：用户获得无订阅者流失的迁移方案

Example 3: API integration

示例3：API集成

User says: "I want to automatically add subscribers from my app to Buttondown" Skill does: Provides the POST /v1/subscribers endpoint with auth header, request body format, and example cURL/Python code. Covers tag assignment and metadata fields Result: User has working API integration code
用户提问："我想把我的应用中的订阅者自动添加到Buttondown" 技能操作：提供POST /v1/subscribers端点、认证头、请求体格式，以及示例cURL/Python代码。涵盖标签分配和元数据字段 结果：用户拥有可正常运行的API集成代码

Troubleshooting

故障排查

Paid subscriptions not collecting payment

付费订阅无法收取费用

Symptom: Paywall is enabled but readers can't pay or see no payment option Cause: Stripe not connected, or Paid Subscriptions add-on not enabled Solution: Go to Settings → Paid Subscriptions, verify the add-on is active ($9/mo), and check Stripe connection status. Test with a Stripe test-mode payment. Ensure the email has the paywall toggle enabled.
症状：已启用付费墙，但读者无法付费或看不到付款选项 原因：未连接Stripe，或未启用付费订阅附加服务 解决方案：进入设置→付费订阅，确认附加服务已激活（每月9美元），并检查Stripe连接状态。使用Stripe测试模式进行支付测试。确保邮件已启用付费墙开关。

Emails stuck in draft or not sending

邮件卡在草稿状态或无法发送

Symptom: Email shows as draft but won't send, or scheduled send didn't fire Cause: Email may be flagged by Buttondown's built-in checks (broken links, malformed images), or sending domain not verified Solution: Check the email's status page for warnings. Verify your sending domain in Settings → Domains. If using a custom domain, confirm DNS records (SPF/DKIM) are propagated.
症状：邮件显示为草稿但无法发送，或定时发送未触发 原因：邮件可能被Buttondown的内置检查标记（链接失效、图片格式错误），或发送域名未验证 解决方案：查看邮件状态页面的警告信息。在设置→域名中验证发送域名。如果使用自定义域名，确认DNS记录（SPF/DKIM）已生效。

Subscribers not appearing after import

导入后订阅者未显示

Symptom: Imported a CSV but subscriber count didn't change Cause: CSV format issues, duplicate emails, or import still processing Solution: Check import status in Subscribers → Imports. Verify CSV has a column header named "email" (case-sensitive). Duplicates are silently skipped. Large imports may take several minutes.
症状：导入CSV文件后订阅者数量未变化 原因：CSV格式错误、重复邮箱，或导入仍在处理中 解决方案：在订阅者→导入中查看导入状态。确认CSV文件包含名为"email"的列标题（区分大小写）。重复邮箱会被自动跳过。大型导入可能需要几分钟时间。