API & Webhooks
Produktionsreife API. Keine Roadmap-Folie.
Mehr als 25 REST-Endpunkte, Echtzeit-Webhooks, JWT-Authentifizierung und interaktive Dokumentation. Alle Funktionen der Benutzeroberfläche sind auch über die API verfügbar.
Kurze Antwort
Was ist die DialerBee-API? DialerBee bietet eine produktionsreife REST-API mit über 25 Endpunkten für Kampagnen, Kontakte, Anrufe, Agenten, Compliance, Aufzeichnungen, Berichte und Webhooks. Die Authentifizierung erfolgt über JWT-Bearer-Token mit einer Gültigkeit von 24 Stunden. Die API unterstützt cursorbasierte Paginierung, gibt RFC-7807-Fehlerantworten zurück und beschränkt die Anzahl der Anfragen auf 2.000 pro Minute und Mandant. Echtzeit-Webhooks übermitteln Ereignisse (z. B. Anruf gestartet, Anruf beantwortet, Anruf-Ergebnis, Disposition festgelegt, Compliance blockiert) mit HMAC-SHA256-Signaturprüfung und exponentiellem Wiederholungs-Backoff. Die interaktive API-Dokumentation finden Sie unter dialer.broadnet.me/admin/api-docs.html.
Das Problem
Die meisten Dialer-APIs sind ein nachträglicher Gedanke
Sie haben einen Dialer gekauft, um Anrufe zu tätigen. Jetzt müssen Sie ihn in Ihr CRM integrieren, Daten in Ihr Data Warehouse übertragen, Workflows durch Anrufereignisse auslösen und benutzerdefinierte Dashboards erstellen. Sie prüfen die API-Dokumentation des Anbieters und finden … ein PDF aus dem Jahr 2019 mit sechs undokumentierten Endpunkten, keinen Webhooks und einer SOAP-Schnittstelle.
Das ist die Realität für die meisten Outbound-Teams. Der Dialer funktioniert einwandfrei zum Tätigen von Anrufen, aber sobald man … Darauf aufbauen — Wenn Sie Dispositionen mit Salesforce synchronisieren, Tickets in Zendesk automatisch erstellen, Analysen an Ihr BI-Tool übertragen oder eine benutzerdefinierte Agentenschnittstelle erstellen möchten — sind Sie auf CSV-Exporte und manuelle Prozesse angewiesen.
DialerBee wurde mit einem API-First-Ansatz entwickelt. Jede Funktion der Benutzeroberfläche basiert auf derselben REST-API, die Sie von Ihren eigenen Systemen aus aufrufen können. Die API ist kein nachträglich hinzugefügtes Element – sie bildet das Fundament der gesamten Plattform.
So funktioniert es
API-First von Grund auf
Die DialerBee-API folgt den REST-Konventionen mit JSON-Nutzdaten, Standard-HTTP-Methoden und RFC-7807-konformen Fehlerantworten. Die Authentifizierung erfolgt über JWT-Bearer-Token, die über einen Login-Endpunkt abgerufen werden und eine Gültigkeitsdauer von 24 Stunden sowie die Möglichkeit zur Token-Aktualisierung bieten. Jede API-Antwort enthält Header zur Ratenbegrenzung, sodass Ihre Integration die Übertragungsrate automatisch drosseln kann.
Authentifizieren
Senden Sie Ihre Anmeldeinformationen per POST an /v1/login. Sie erhalten ein JWT-Bearer-Token, das 24 Stunden gültig ist. Verwenden Sie die Token-Aktualisierung für länger laufende Integrationen.
Anrufendpunkte
Über 25 RESTful-Endpunkte für Kampagnen, Kontakte, Anrufe, Agenten, Compliance, Aufzeichnungen und Berichte. JSON-Ein- und Ausgabeformat.
Webhooks empfangen
Registrieren Sie Webhook-URLs, um Echtzeitereignisse zu empfangen. Jede Nutzlast ist mit HMAC-SHA256 signiert, sodass Sie die Authentizität überprüfen können.
Fehlerbehandlung
RFC 7807-Problemdetails für jeden Fehler. Ratenbegrenzungs-Header in jeder Antwort. Status 429 mit Hinweisen zum nächsten Wiederholungsversuch.
Direkter Vergleich
DialerBee API vs typische Dialer-APIs
| Fähigkeit | Typische Dialer-API | DialerBee-API |
|---|---|---|
| Endpunkte | 5-10, teilweise dokumentiert | Mehr als 25 vollständig dokumentierte Funktionen mit OpenAPI-Spezifikation |
| Protokoll | SOAP/XML oder proprietäre | REST mit JSON, RFC 7807-Fehler |
| Authentifizierung | API-Schlüssel (läuft nie ab) | JWT mit 24 Stunden Gültigkeit + Token-Aktualisierung |
| Echtzeitereignisse | Umfrage oder keine | HMAC-SHA256-signierte Webhooks mit Wiederholungsfunktion |
| Pagination | Offset-basiert oder keine | Cursorbasiert mit next_cursor + has_more |
| Ratenbegrenzung | Undokumentiert | 2.000 Anfragen/Minute mit Headern in jeder Antwort |
| Dokumentation | PDF oder veraltetes Wiki | Live-interaktive Swagger-Dokumente |
| Mehrmieter | Nur für Einzelmieter | Mandantenspezifische Bereichsbegrenzung für jeden Endpunkt |
Endpunktreferenz
10 API-Gruppen. 25+ Endpunkte.
| API-Gruppe | Endpunkte |
|---|---|
| Authentifizierung | POST /login, POST /refresh |
| Kampagnen | CRUD + Start/Pause |
| Kontakte | Hochladen, auflisten, suchen |
| Anrufe | Geschichte, Leben zählt, Ursprung |
| Agenten | Staat, SIP-Registrierung |
| Compliance & DNC | Vorwahlprüfungen, DNC-Listen |
| Aufnahmen | Liste, signierte Wiedergabe-URLs |
| Berichte | Export (CSV, JSON, PDF) |
| Webhooks | Abonnieren, verwalten, überprüfen |
| System | Gesundheit, Version |
Schnellstart
Authentifizieren und wählen in 3 API-Aufrufen
POST /v1/login
Content-Type: application/json
{
"E-Mail": "admin@yourcompany.com",
"Passwort": "••••••••"
}
→ Antwort: { "Token": "eyJhbG...", "expires_in": 86400 }POST /v1/campaigns
Autorisierung: Inhaber eyJhbG...
{
"Name": "Q3-Kollektionen",
"Modus": "progressiv",
"amd_enabled": true,
"Compliance-Profil": "uae-tdra"
}POST /v1/campaigns/{id}/contacts
Content-Type: multipart/form-data
→ CSV-Datei mit Telefonnummer, Name und benutzerdefinierten Feldern hochladen
POST /v1/campaigns/{id}/start
→ Die Kampagne wählt jetzt.Webhooks
Echtzeitereignisse an Ihre Systeme geliefert
Webhooks übermitteln Ereignisse in Echtzeit an Ihre Systeme – ein regelmäßiges Abfragen ist nicht erforderlich. Jede Webhook-Nutzlast ist signiert. HMAC-SHA256 So können Sie überprüfen, ob die Nachricht von DialerBee stammt und nicht manipuliert wurde. Falls Ihr Endpunkt nicht erreichbar ist, werden Webhooks mit exponentiellem Backoff bis zu 2 Stunden und 35 Minuten lang wiederholt, sodass Sie kein Ereignis verpassen.
Anruf gestartet Ein neuer ausgehender Anruf wurde initiiert.
Anruf angenommen Der Empfänger nahm den Artikel entgegen – inklusive AMD-Klassifizierung.
Anruf beendet Anruf abgeschlossen mit Dauer, Ergebnis und Aufzeichnungs-URL
call.amd_result AMD-Klassifizierungsergebnis: Mensch oder Maschine, mit Konfidenzwert
Agentenstatusänderung Der Agent war verfügbar, auf Abruf, im Abschlussmodus oder offline.
disposition.set Der Agent reichte einen Abschlussbericht mit Ergebnis und Vermerken ein.
Compliance blockiert Ein Anruf wurde von der Compliance-Engine anhand von Regeldetails blockiert.
Kampagne gestartet Die Kampagne hat begonnen, Anrufe zu tätigen
Kampagne pausiert Kampagne vom Vorgesetzten oder System pausiert
Aufnahme bereit Die Anrufaufzeichnung wurde verarbeitet und steht zur Wiedergabe bereit.
contact.dnc_added Ein Kontakt wurde zur DNC-Sperrliste hinzugefügt.
Rückruf geplant Der Agent hat einen Rückruf für einen Kontakt vereinbart.
Anwendungsfälle
Baue alles, was du willst. zusätzlich zu DialerBee
CRM-Synchronisierung
Über Webhooks oder API-Abfragen werden Dispositionen, Anrufergebnisse und Aufzeichnungslinks in Salesforce, HubSpot, Zoho oder ein beliebiges CRM-System übertragen.
BI & Data Warehouse
Exportieren Sie Anrufdaten in Ihr Data Warehouse. Erstellen Sie Dashboards in Looker, Tableau, Power BI oder Metabase mit geplanten Berichtsexporten.
Benutzerdefinierte Arbeitsabläufe
Lösen Sie bei Anrufereignissen Aktionen in Ihren Systemen aus – erstellen Sie automatisch Support-Tickets, aktualisieren Sie Lead-Scores und versenden Sie Slack-Benachrichtigungen.
Click-to-Call
Verwenden Sie den Anrufursprungsendpunkt, um Click-to-Call aus Ihrem CRM, Helpdesk oder Ihrer benutzerdefinierten Anwendung hinzuzufügen.
Kontaktsynchronisierung
Halten Sie Ihre Kontaktlisten mit Ihrer zentralen Datenquelle synchron. Laden Sie Kontakte per CSV hoch oder übertragen Sie einzelne Kontakte per API.
Automatisierung der Einhaltung von Vorschriften
DNC-Status vor Anrufen abfragen, Sperrlisten verwalten und Compliance-Audit-Protokolle programmatisch exportieren.
Unter der Motorhaube
Entwickelt für Entwickler, die ausliefern
| Protokoll | Nur HTTPS (TLS 1.2+) |
| Format | JSON-Anfrage- und Antwortkörper |
| Authentifizierung | JWT-Bearer-Token (24 Stunden Gültigkeit) mit Aktualisierung |
| Versionierung | /v1 URL-Pfad + Schemaversion in Webhooks |
| Pagination | Cursorbasiert mit next_cursor und has_more |
| Ratenbegrenzung | 2.000 Anfragen/Minute pro Mandant mit Headern |
| Fehlerformat | RFC 7807 Problemdetails für HTTP-APIs |
| Webhook-Signatur | HMAC-SHA256-Signaturprüfung |
| Webhook-Wiederholungsversuche | Exponentieller Backoff (maximal 2 Stunden 35 Minuten insgesamt) |
| Aufzeichnungs-URLs | Signierte URLs mit einer Gültigkeitsdauer von 1 Stunde über MinIO |
| DNC-Register | VAE (TDRA), KSA (CITC), Ägypten (NTRA), Jordanien (TRC) |
| SDKs | JavaScript und Python (demnächst verfügbar) |
Verwandte Funktionen
White-Label-Plattform
Partner-API für Mandantenbereitstellung, Branding und Abrechnung.
Analyse & Berichterstattung
Exportieren Sie Berichtsdaten per API in Ihre BI-Tools.
Bringen Sie Ihren eigenen Träger mit.
SIP-Trunk-Verwaltung über Admin-Panel und API.
Integrationen
Vorkonfigurierte Konnektoren für CRMs, Messaging und mehr.
Häufig gestellte Fragen zur API
Ist die API in allen Tarifen verfügbar?
Wo finde ich die API-Dokumentation?
Wie funktioniert die Webhook-Authentifizierung?
Was passiert, wenn mein Webhook-Endpunkt nicht erreichbar ist?
Kann ich die API verwenden, um eine benutzerdefinierte Agentenschnittstelle zu erstellen?
Ist die API mandantenfähig?
Wie hoch ist die Ratenbegrenzung?
Sind SDKs verfügbar?
Bereit zur Integration?
Entdecken Sie die Live-API-Dokumentation oder buchen Sie eine Demo und erhalten Sie API-Zugriff. Erstellen Sie Ihre erste Integration in Stunden, nicht in Wochen.