Zapier Integration
Connect Konvoq to Google Sheets, Slack, HubSpot, Notion, Salesforce, Mailchimp, and 8,000+ other apps — all without writing a line of code.
Set up at: Dashboard → Settings → API Keys, then zapier.com/apps
Before you start
You need:
- An active Konvoq workspace
- A Zapier account (free tier works for most use cases)
Step 1 — Create an API key
- Go to Dashboard → Settings → API Keys
- Click New API Key
- Give it a name (e.g.
Zapier) - Select scopes:
| Scope | When you need it |
|---|---|
webhooks | Required — lets Zapier subscribe to events |
read:leads | Needed for "Find Lead" search steps |
write:leads | Needed for "Create Lead" action steps |
read:conversations | Needed for conversation-based triggers |
- Click Create — the raw key is shown once. Copy it immediately.
warning
The key is only shown at creation. If you lose it, revoke it and create a new one.
Step 2 — Connect Konvoq on Zapier
- Go to zapier.com/apps and search for Konvoq
- Click Connect
- Paste your API key when prompted
- Zapier validates it against your account — you'll see your email confirmed
Step 3 — Choose a trigger or action
Triggers (Konvoq → Zapier)
| Trigger | When it fires |
|---|---|
| New Lead | Visitor submits the lead capture form |
| Lead Stage Changed | Lead moves to a new CRM pipeline stage |
| New Handoff Request | Visitor requests a human agent |
| Handoff Resolved | Agent closes a handoff |
| Conversation Started | Visitor opens the chatbot |
| Conversation Ended | Conversation is closed |
Actions (Zapier → Konvoq)
| Action | What it does |
|---|---|
| Create Lead | Creates a new lead in your Konvoq CRM |
| Update Lead Stage | Moves a lead to a different pipeline stage |
Searches
| Search | What it does |
|---|---|
| Find Lead | Looks up a lead by email or name |
| Find Conversation | Looks up a conversation by ID |
Step 4 — Use a pre-built template
Popular starting Zaps available in the Konvoq integration page on Zapier:
- New Lead → Add row to Google Sheets
- New Lead → Send Slack message
- New Lead → Create HubSpot contact
- New Lead → Add Mailchimp subscriber
- New Handoff Request → Send Slack alert
- New Lead → Create Notion page
- New Lead → Create Airtable record
- Lead Stage Changed → Update HubSpot deal
How it works under the hood
When you turn a Zap ON, Zapier calls:
POST /api/public/zapier/subscribe
Konvoq registers a webhook subscription and fires a signed POST to Zapier's callback URL every time the chosen event occurs.
When you turn a Zap OFF, Zapier calls:
DELETE /api/public/zapier/unsubscribe/:id
Konvoq removes the subscription — no more deliveries.
All webhook requests are signed with HMAC-SHA256. See Webhooks → Verifying signatures for details.
Troubleshooting
| Problem | Fix |
|---|---|
| Zap not triggering | Turn the Zap OFF then ON — re-registers the subscription |
| "Invalid API key" on connect | Check scopes — webhooks scope is required |
| Missing lead fields | Adjust the lead capture form fields in Dashboard → Widget → Lead Capture |
| Zap triggers but action fails | Check Zapier's task history for the specific error message |