Skip to content
sales-qwilr-automation logo

Automate Qwilr with CRM & Tools

sales-qwilr-automation

Builds automations connecting Qwilr to CRM and other tools via API, Zapier, or native integrations. Use when reps manually copy deal data into proposals, Qwilr and your CRM are out of sync, proposal status isn't updating in Salesforce or HubSpot, you want proposals auto-created when deals hit a s...

SKILL.md

Full skill instructions

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
  2. 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
  3. 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
  4. 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

More Sales & marketing skills

revops logo
Sales & marketing

revops

Design and optimize systems connecting marketing, sales, and customer success into a unified revenue engine.

53.3K 104.9K
View
lead-magnets logo
Sales & marketing

lead-magnets

Strategic planning and optimization for email capture offers and gated content.

53.3K 103.4K
View
directory-submissions logo
Sales & marketing

directory-submissions

Directory submissions: the foundation layer of distribution that passes backlinks and discovery surface area into your marketing pages.

53.3K 76.3K
View
gsap-timeline logo
Sales & marketing

gsap-timeline

Sequence and choreograph multi-step animations with precise timing control and nested timelines.

15.9K 58.4K
View
launch-strategy logo
Sales & marketing

launch-strategy

Structured framework for planning product launches, feature announcements, and go-to-market strategies.

53.3K 56.8K
View
gws-drive-upload logo
Sales & marketing

gws-drive-upload

Upload files to Google Drive with automatic MIME type detection and metadata.

31.2K 47.2K
View
ci-cd-and-automation logo
Sales & marketing

ci-cd-and-automation

Automates CI/CD pipeline setup. Use when setting up or modifying build and deployment pipelines. Use when you need to automate quality gates, configure test runners in CI, or establish deployment strategies.

101.4K 43.2K
View
persona-team-lead logo
Sales & marketing

persona-team-lead

Team leadership persona with standup coordination, meeting prep, task delegation, and team communication.

31.2K 29.3K
View
recipe-find-large-files logo
Sales & marketing

recipe-find-large-files

Identify large Google Drive files consuming storage quota.

31.2K 29.2K
View

Sales & marketing AI tools

KreadoAI logo
Sales & marketing

KreadoAI

Revolutionize Video Creation with AI-Generated Avatars and Voices

Paid
View
Followr logo
Sales & marketing

Followr

Social media on autopilot

Paid
View
Logodiffusion logo
Sales & marketing

Logodiffusion

Design custom logos instantly with AI.

Paid
View
I
Sales & marketing

Ideogram

Text-heavy marketing and design images

Freemium
View
Prompt Silo logo
Sales & marketing

Prompt Silo

Boost Your SEO with Content and SEO Silos

Free
View
Marketing Blocks logo
Sales & marketing

Marketing Blocks

Revolutionize Your Marketing with AI-Powered MarketingBlocks!

Paid
View
Scrip AI logo
Sales & marketing

Scrip AI

10X faster & free AI content creation for 100+ use cases

Free
View
Tribescaler logo
Sales & marketing

Tribescaler

Tribescaler | Make Your Tweets Go Viral

Paid
View