sales-qwilr-automation（销售 qwilr 自动化）

Automate Qwilr with CRM & Tools

Help the user build automations that connect Qwilr to their CRM and other tools — via the Qwilr REST API, Zapier, or native integrations.

Qwilr API overview

The Qwilr REST API lets you create pages from saved blocks with token substitutions, manage quote sections with interactive pricing, and subscribe to webhooks for real-time engagement signals.

Quick reference: Base URL https://api.qwilr.com/v1, JWT Bearer auth. Key endpoints: POST /pages (create), GET /blocks/saved (discover templates), POST /webhooks (subscribe to events).

For the complete API reference — endpoints, curl examples, token mapping, quote block structure, and testing checklist — consult references/qwilr-api-reference.md.

Step 1 — Gather context

If references/learnings.md exists, read it first for accumulated knowledge.

Ask the user:

1. What do you want to automate?

- A) Auto-create proposals when a deal reaches a certain stage - B) Sync proposal status/acceptance back to CRM - C) Get notified when prospects view or accept proposals - D) Full round-trip: create from CRM data + sync engagement back - E) Something else — describe it

1. What CRM/tools are you using?

- A) HubSpot - B) Salesforce - C) Pipedrive - D) Zoho CRM - E) Other CRM (specify) - F) No CRM — just API/webhooks

1. What automation platform do you prefer?

- A) Zapier - B) Make (Integromat) - C) Direct API (code/scripts) - D) Native Qwilr integration (HubSpot/Salesforce/Pipedrive) - E) Not sure — recommend what fits

1. What Qwilr plan are you on? (affects API access and native integrations)

If the user's request already provides most of this context, skip directly to the relevant step. Lead with your best-effort answer using reasonable assumptions (stated explicitly), then ask only the most critical 1-2 clarifying questions at the end — don't gate your response behind gathering complete context.

Step 2 — Architecture recommendation

Based on the user's answers, recommend the right approach with trade-offs:

Native integrations (simplest)

• HubSpot: Qwilr's native integration auto-populates templates with HubSpot deal/contact data, syncs acceptance status back to deal properties
• Salesforce: Native integration maps Salesforce opportunity fields to Qwilr tokens, creates proposals from opportunity records
• Pipedrive: Native integration connects deal data to Qwilr templates
• Best for: Teams that want zero-code setup and use a supported CRM
• Limitation: Less customizable than API, limited to supported field mappings

Zapier / Make (medium complexity)

• Best for: Multi-tool workflows (e.g., create proposal when Stripe payment received, or notify Slack when proposal viewed)
• Approach: Use Qwilr's Zapier triggers (page viewed, accepted) and actions (create page)
• Limitation: Slower execution, may hit rate limits at scale, costs per task

Direct API (most powerful)

• Best for: Custom workflows, high volume, complex logic (conditional sections, dynamic pricing calculations)
• Approach: Call Qwilr REST API directly from your backend, serverless functions, or scripts
• Limitation: Requires development effort

Step 3 — Build the automation

The build process follows four stages. For curl examples, JSON payloads, and token mapping details, consult references/qwilr-api-reference.md.

3a. Discover available blocks

List saved blocks via GET /blocks/saved to find the savedBlockId values for page creation.

3b. Create pages from CRM data

Use POST /pages with saved block IDs, token substitutions (CRM fields → {{token}} values), and quote sections for interactive pricing.

3c. Subscribe to webhook events

Subscribe to pageFirstViewed, pageViewed, pageAccepted, and pagePartiallyAccepted events to get real-time engagement signals.

3d. Check page status

Use GET /pages/{id}?expand=acceptance,metadata to poll page details and acceptance status.

Step 4 — Token/substitution mapping

Design the mapping between CRM fields and Qwilr template tokens. Common tokens include {{company_name}}, {{contact_first_name}}, {{deal_amount}}, {{rep_name}}, etc. For the full token reference and guidelines, see references/qwilr-api-reference.md.

Key principles:

• Always auto-populate: company_name, contact names, rep info, deal amount
• Semi-auto (verify after population): industry, company_size, product
• Always manual: executive summary, pain points, custom scope
• Set fallback values for optional tokens so pages don't show raw {{token}} text

Step 5 — Testing checklist

Walk through end-to-end before going live: auth verification, block discovery, token rendering, quote block accuracy, webhook delivery, CRM sync, error handling, and publish flow. Full checklist in references/qwilr-api-reference.md.

Common automation recipes

Three common patterns (detailed implementation in references/qwilr-api-reference.md):

1. Auto-create proposal when deal hits Stage 3: CRM trigger → POST /pages → update CRM with Qwilr URL
2. Notify Slack when proposal is viewed: pageFirstViewed webhook → Slack message → rep follows up
3. Update CRM when proposal is accepted: pageAccepted webhook → update deal stage to Closed Won → trigger onboarding

Gotchas

• Don't overcomplicate with custom API when Zapier works. If the user's automation is a simple trigger-action (deal hits stage → create proposal), Zapier or the native integration is faster to set up and maintain. Reserve direct API work for custom logic, high volume, or complex conditional workflows.
• Don't forget webhook retry and deduplication. Qwilr webhooks may retry on failure, sending the same event multiple times. Any webhook handler must be idempotent — check for duplicate event IDs before processing. Claude often generates webhook handlers without this.
• Don't assume CRM field names without checking. Salesforce custom fields end in __c, HubSpot uses internal property names that differ from display names, and Pipedrive uses custom field keys. Always tell the user to verify their actual field names/IDs before building the mapping.
• Don't skip testing with sandbox/test data. Claude tends to generate API code that goes straight to production. Always recommend creating test pages with isPublished: false first, using test deals in the CRM, and verifying token substitutions render correctly before going live.
• Don't hardcode API tokens in scripts. Use environment variables ($QWILR_TOKEN) for authentication. Claude sometimes generates examples with placeholder tokens inline — make sure the user knows to use env vars or a secrets manager.
• Self-improving: If you discover something not covered here, append it to references/learnings.md with today's date.

Related skills

• /sales-proposal-page — Write the actual proposal content and quote block design
• /sales-proposal-analytics — Interpret engagement signals and decide follow-up actions
• /sales-proposal-template — Design reusable templates for API auto-population
• /sales-deal-room — For complex multi-page deal rooms
• /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