API, Webhooks & MCP
Authentifizierung
API-Keys erstellst du unter Einstellungen → API (pro Workspace, jederzeit widerrufbar). Jeder Request trägt den Key als Bearer-Token:
Authorization: Bearer <API-KEY>REST-API (v1)
Basis-URL: https://app.showrate.app/api/v1
| Endpoint | Beschreibung |
|---|---|
GET/POST /leads, GET /leads/:id | Leads listen, anlegen (Upsert per E-Mail) und lesen. POST unterstützt customFields, utm(Kampagnen-Referenz als Touchpoint) und notify: true für den Echtzeit-Push an den Vertrieb — damit lassen sich z. B. LinkedIn-/Meta-Lead-Ads über make.com einspielen. |
GET /bookings | Termine mit Status, Lead und Kalender. |
GET /calendars | Kalender des Workspace inkl. Buchungs-URLs. |
GET /events | Domain-Event-Log (alles, was im Workspace passiert). |
GET /recordings | Anruf-Aufzeichnungen mit Transkripten. |
GET/POST /webhooks | Webhook-Endpunkte verwalten (siehe unten). |
Webhooks (make.com & Co.)
- Pro Webhook: Ziel-URL, HMAC-Secret und abonnierte Event-Typen (
*= alle). Zustellung mit Signatur-Header und automatischem Retry mit Backoff. - Payloads sind angereichert: statt bloßer IDs enthalten sie vollständige Lead-/Termin-/Stage-Objekte plus ein deutsches
label— direkt in make.com verwendbar. - Wichtige Events:
booking.created/cancelled/rescheduled(inkl. Absagegrund),reminder.due(fertiger SMS-Text),sms.first_contact_due(Erst-SMS mit Vertriebler-Absendernummer),funnel.abandoned(Recovery-Link),lead.created/scored,pipeline.stage_changed,call.showed/no_show,slots.shortage_detected.
MCP-Server (Claude & andere LLMs)
ShowRate stellt einen Model-Context-Protocol-Server bereit: https://app.showrate.app/api/mcp — Authentifizierung über den API-Key des Workspace als Bearer-Token.
- Tools:
list_leads,get_lead(inkl. Antworten, UTM, Terminen),list_transcripts(Call-Transkripte),pipeline_stats. - Beispiel-Anwendung: „Lies die letzten 50 Call-Transkripte und ziehe daraus 10 Ad-Hooks.“ — der Zugriff ist strikt auf den eigenen Workspace begrenzt und lesend.