Pipedrive Deal Handoff Brief
AI-powered deal handoff briefs that reconstruct relationship history, commitments, and competitive context when deals change owners — so the new rep starts informed, not blind.
32-node n8n workflow that generates comprehensive deal handoff briefs when Pipedrive deals change owners. 4 agents: Fetcher (code-only, 6 Pipedrive API calls), Researcher (Sonnet 4.6 + web_search, company/person context), Analyst (Sonnet 4.6, 6-section handoff brief synthesis), Formatter (Sonnet 4.6, Notion brief + Slack notification + Pipedrive note). SINGLE-MODEL PER_RECORD. $0.13/handoff avg. BQS 12/12. ITP 20/20, 14/14 milestones.
Four Agents. Six-Section Handoff. Three-Output Delivery.
Step 1 — Fetcher
Code Only
Pipedrive webhook fires on deal owner change. Config Loader reads NOTION_DATABASE_ID, SLACK_CHANNEL, INCLUDE_WEB_RESEARCH, and PIPEDRIVE_NOTE settings. ITP Bypass Gate routes test data. Fetcher calls 6 Pipedrive API endpoints: deal details, activities, notes, stage history (flow), primary contact (person), and organization. Assembles complete deal context package. Zero LLM cost.
Step 2 — Researcher
Tier 2 + web_search
Research Gate checks INCLUDE_WEB_RESEARCH=true AND org_name populated. When active, Sonnet 4.6 uses web_search to research company context — recent news, market position, industry developments — and person context — professional background, role context. When disabled or org_name missing, skipped entirely. Analyst proceeds with CRM data only.
Step 3 — Analyst
Tier 2 Classification
Sonnet 4.6 synthesizes a 6-section handoff brief with chain-of-thought reasoning: (1) relationship_history — interaction timeline, communication patterns, rapport indicators, (2) deal_context — stage progression, velocity, key milestones, (3) commitments_made — explicit/implicit promises with status and source, (4) objections_encountered — resolved vs open, resolution approaches, (5) competitive_landscape — competitor mentions, positioning, evaluation criteria, (6) recommended_actions — prioritized next steps for first 48 hours.
Step 4 — Formatter
Tier 3 Creative
Sonnet 4.6 generates three outputs: (1) Notion handoff brief — executive summary callout, section-by-section detail, metadata footer, (2) Slack notification — Block Kit message with key context, priority actions, and Notion brief link, (3) Pipedrive deal note — compact summary with priority actions, open commitment/objection counts, and brief link. Pipedrive Note Gate controls whether the deal note is created.
What It Does NOT Do
Does not replace your CRM — it generates handoff briefs, not deal management
Does not diagnose deal stalls — that is what Deal Stall Diagnoser does
Does not reactivate lost deals — that is what Lost Deal Re-Activation Agent does
Does not work with HubSpot, Salesforce, or other CRMs — Pipedrive only in v1.0
Does not modify deal data — read-only API access for deal context (only creates a deal note if PIPEDRIVE_NOTE=true)
Does not guarantee deal success — it transfers knowledge to the new owner so they start informed
The Complete Customer Success Bundle
9+ files — workflow JSON, system prompts, and complete documentation.
Tested. Measured. Documented.
Every metric is ITP-measured. The Pipedrive Deal Handoff Brief reconstructs deal context across six dimensions — Sonnet 4.6 for research, analysis, and formatting at $0.08–$0.18/handoff (avg $0.13).
Pipedrive Deal Handoff Brief v1.0.0 — Technical Reference━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━Architecture: 32 n8n nodes, 4 agents (Fetcher → Researcher → Analyst → Formatter)Trigger: Pipedrive webhook (deal owner change) + Manual WebhookInput: Pipedrive — deal data, activities, notes, stage history, contacts, orgIntelligence: Sonnet 4.6 × 3 (Researcher + Analyst + Formatter)Output: Notion — detailed handoff brief + Slack — notification + Pipedrive — deal noteCost: $0.08–$0.18/handoff (avg $0.13, ITP-measured)ITP: 20/20 records, 14/14 milestones PASSBQS: 12/12 PASSTool A: Pipedrive (input — deal data via pipedriveApi)Tool B: Notion (output — detailed handoff brief)Tool C: Slack (output — notification to new owner)Intelligence: 6-section handoff brief + SINGLE-MODEL PER_RECORD patternCost Value: 0.13
What You'll Need
⚠ Data Source Dependency
Uses Anthropic web_search via Researcher agent when INCLUDE_WEB_RESEARCH=true (default). Set to false to disable. Non-research data from Pipedrive, Notion, and Slack APIs only.
Platform
n8n 2.7.5+
Est. Monthly API Cost
$1.30-$13/month (10-100 handoffs/month)
Credentials Required
- ▪Anthropic API
- ▪Pipedrive (pipedriveApi)
- ▪Slack (Bot Token, httpHeaderAuth Bearer)
- ▪Notion (Integration Token, httpHeaderAuth Bearer)
Services
- ▪Pipedrive account (pipedriveApi credential in n8n)
- ▪Slack workspace (Bot Token with chat:write scope)
- ▪Notion workspace (Integration with page create permissions)
- ▪Anthropic API key (~$0.13/handoff avg)
Setup Track
Quick Start
~15 min
All credentials live, n8n running
Full Setup
1–2 hrs
Needs API config + tables
From Scratch
2–4 hrs
No n8n, no credentials
Pipedrive Deal Handoff Brief v1.0.0
$199
one-time purchase
What you get:
- ✓Production-ready 32-node n8n workflow — import and deploy
- ✓Event-driven: Pipedrive webhook fires on deal owner change
- ✓6-section handoff brief: relationship history, deal context, commitments, objections, competitive landscape, recommended actions
- ✓3-output delivery: Notion detailed brief + Slack notification + Pipedrive deal note
- ✓Configurable web research: INCLUDE_WEB_RESEARCH flag enables/disables company + person context via web_search
- ✓6 Pipedrive API calls: deal details, activities, notes, stage history, contact, organization
- ✓Priority actions for first 48 hours with urgency classification
- ✓Commitment tracking: explicit/implicit promises with fulfilled/pending/overdue status
- ✓Objection catalog: resolved vs open with resolution approaches documented
- ✓Competitive intelligence extracted from deal notes and activities
- ✓SINGLE-MODEL: Sonnet 4.6 for research, analysis, and formatting — no Opus needed
- ✓PER_RECORD pattern: runs per deal owner change, not batch
- ✓Configurable: INCLUDE_WEB_RESEARCH, PIPEDRIVE_NOTE, Notion database, Slack channel
- ✓ITP 20/20 records, 14/14 milestones, $0.08–$0.18/handoff measured
- ✓All sales final after download
Frequently Asked Questions
What are the six handoff brief sections?+
The Analyst synthesizes: (1) Relationship History — interaction timeline, communication patterns, rapport indicators from activities and notes. (2) Deal Context — stage progression with durations, pipeline velocity, key milestones. (3) Commitments Made — explicit and implicit promises extracted from notes, classified as fulfilled, pending, or overdue. (4) Objections Encountered — objections from deal history, classified as resolved or open, with resolution approaches. (5) Competitive Landscape — competitor mentions from notes/activities, positioning used, evaluation criteria. (6) Recommended Actions — prioritized next steps for the first 48 hours with urgency classification.
How does the web research feature work?+
The Research Gate checks two conditions: INCLUDE_WEB_RESEARCH must be true (default) AND the deal organization name must be populated. When both are met, the Researcher uses Sonnet 4.6 with web_search to gather company context (news, market position, developments) and person context (professional background). Set INCLUDE_WEB_RESEARCH=false in the Config Loader to disable web research and rely on CRM data only.
How much does each handoff cost?+
ITP-measured: $0.08–$0.18/handoff depending on deal complexity and whether web research is enabled. Average across 20 ITP records: $0.13/handoff. Deals with web research enabled cost more due to web_search API calls. Deals with INCLUDE_WEB_RESEARCH=false cost less. The Fetcher (code-only) adds zero LLM cost.
How does it differ from Deal Intelligence Agent?+
Different trigger and purpose. DIA explains stage moves — it fires when a deal changes stage and analyzes why. PDHB fires when a deal changes owner and generates a comprehensive handoff brief. DIA provides stage transition intelligence; PDHB provides ownership transition knowledge transfer. They complement each other in Pipedrive-centric sales operations.
What Pipedrive data does it use?+
The Fetcher calls 6 Pipedrive API endpoints: (1) GET /deals/{id} for deal properties (title, value, stage, dates, owner). (2) GET /deals/{id}/activities for all activities (calls, meetings, emails, tasks). (3) GET /deals/{id}/notes for all deal notes. (4) GET /deals/{id}/flow for stage history with timestamps. (5) GET /persons/{id} for primary contact details. (6) GET /organizations/{id} for company information.
What are the three output channels?+
The Formatter generates: (1) Notion handoff brief — a detailed page with executive summary, section-by-section content, and metadata footer. (2) Slack notification — Block Kit message with key context, priority actions, open commitment/objection counts, and a link to the Notion brief. (3) Pipedrive deal note — compact summary attached to the deal record. The Pipedrive note is optional via PIPEDRIVE_NOTE setting.
Why only Sonnet instead of Opus?+
The Fetcher pre-assembles all deal data from 6 Pipedrive API calls. The Analyst organizes and synthesizes pre-assembled CRM data into a structured handoff brief — classification-tier reasoning. Sonnet 4.6 handles the 6-section synthesis with high accuracy in ITP testing. Opus would add significant cost per handoff without measurable quality improvement. SINGLE-MODEL keeps cost at $0.13/handoff average.
Can I test without real Pipedrive deals?+
Yes. Send a POST to the webhook URL with _is_itp: true and deal fixture data in the payload. ITP mode bypasses Pipedrive API calls and web research, using fixture data directly. The 20 ITP test records cover rich deals, sparse deals, web research on/off, no-org deals, competitor mentions, and edge cases.
Does it use web scraping?+
Conditionally. When INCLUDE_WEB_RESEARCH=true (default) and the deal has an organization name, the Researcher uses Anthropic web_search to gather company and person context. This is configurable — set INCLUDE_WEB_RESEARCH=false to disable all web research. Non-research data comes from Pipedrive API, Notion API, and Slack API.
Is there a refund policy?+
All sales are final after download. Review the Blueprint Dependency Matrix and prerequisites before purchase. Questions? Contact support@forgeworkflows.com before buying. Full terms at forgeworkflows.com/legal.