Documentation Index
Fetch the complete documentation index at: https://docs.mavera.io/llms.txt
Use this file to discover all available pages before exploring further.
Overview
These jobs show how to pull data from Pipedrive (Deals, Notes, Activities, Organizations) → analyze with Mavera (Chat, Focus Group, Mave Agent) → get persona-validated insights for sales coaching, pipeline optimization, and account intelligence.Pipedrive API v2 is the primary API used below. Some endpoints (Notes) still use v1. Authenticate with an OAuth 2.0 token or an API token query parameter.
| Detail | Value |
|---|---|
| Base URL | https://{companydomain}.pipedrive.com/api/v2/ |
| Auth | OAuth 2.0 Bearer token or ?api_token= query param |
| Rate limits | 30,000 base tokens/day (each request costs 1–10 tokens) |
| Mavera surfaces | Chat, Focus Group, Mave Agent |
Prerequisites
Pipedrive credentials
Generate an API token from Settings → Personal preferences → API, or set up an OAuth 2.0 app.
Mavera API key
Grab your key from app.mavera.io/settings/api.
Jobs
Pipeline Stage Voice Analysis
Analyze deal notes by pipeline stage to find messaging patterns that correlate with wins
Activity-Based Persona Scoring
Map activity patterns (calls, emails, meetings) to buyer personas and discover touchpoint thresholds
Lost Deal Focus Group
Create persona archetypes from lost-deal patterns and run Focus Groups to surface qualitative reasoning
Org-Level Account Research
Use Mave Agent to research organizations and write intelligence briefs back to Pipedrive
Production Tips
Paginate large datasets
Paginate large datasets
Pipedrive v2 endpoints use cursor pagination. Read
additional_data.next_cursor from each response:Webhook-driven automation
Webhook-driven automation
Use Pipedrive webhooks (Settings → Webhooks) to trigger jobs when deals change stage, are lost, or organizations update. This reduces daily token consumption.
Normalize lost_reason before clustering
Normalize lost_reason before clustering
Freetext reasons create sparse clusters. Map synonyms before Focus Group:
Credits
| Mavera surface | Credits/call | Typical usage |
|---|---|---|
| Chat | ~1–5 | Per-stage voice analysis |
| Focus Group | ~10–30 | Activity scoring, lost deal analysis |
| Mave Agent | ~5–15 | Org research |
Close CRM
Email A/B testing, call analysis, lead-to-persona automation
Salesforce
8 jobs — lead scoring, deal-stage focus groups, account research
HubSpot
8 jobs — lifecycle personas, meeting analysis, engagement refinement
Integrations
All integrations