Integrationen
Integration per API und über weitere Protokolle
Gibt es für Ihr System keine fertige Integration, binden wir es über das Protokoll an CONTACT.WORK an, das es unterstützt: REST und Webhooks, SOAP, direkter Datenbankzugriff, SIP und AMI für die Telefonie, SMPP für SMS, IMAP und SMTP für E-Mail sowie MCP für KI-Agenten. Daten aus Ihrem System erscheinen auf dem Bildschirm des Agents; Anrufe, Dialoge und Gesprächsergebnisse fließen zurück.
GET /api/clients?phone=79000000015 200 · 84 ms
{ "name": "Jan Wagner", "orders": 2, "debt": 0, "manager": "Anna" } Funktionen
Was Sie mit API und Protokolle erhalten
Beispiele
Was Unternehmen per API anbinden
Meist geht es um drei Dinge: den Kunden beim Anruf sehen, das Gesprächsergebnis speichern und Anrufe oder Nachrichten durch Ereignisse in Ihrem System auslösen.
Der Kunde auf dem Bildschirm, erkannt an der Rufnummer
Geht ein Anruf ein, fragt die Plattform bei Ihrem System nach, wer anruft: Name, Bestellungen, offener Betrag, Ticketstatus. Hat Ihr System REST oder SOAP, holen wir die Daten darüber, sonst lesen wir sie aus der Datenbank oder einem aktuellen Export.
- Kundensuche nach Rufnummer
- Bestellungen und Status im Formular des Agents
- REST, SOAP, SQL oder Export
GET /api/clients?phone=79000000015 200 · 84 ms
{ "name": "Jan Wagner", "orders": 2, "debt": 0, "manager": "Anna" } Das Gesprächsergebnis geht an Ihr System
Nach dem Gespräch schickt die Plattform Ihrem System, was es braucht: den Anruf, einen Link zur Aufzeichnung, das Ergebnis aus dem Formular, ein neues Ticket oder eine Aufgabe. Sofort per Webhook oder gesammelt alle paar Minuten – je nachdem, was zu Ihrem System passt.
- Webhook direkt nach dem Anruf
- Link zur Aufzeichnung und Formularergebnis
- Ticket oder Aufgabe für die zuständige Person
POST /hooks/calls
{ "event": "call.finished", "duration": 192,
"result": "Bestellung bestätigt", "record": "…/rec/8841" } - Systemantwort: 200 OK
- CRM-Aufgabe angelegt: „Bestellung #1024 versenden“
Anrufe und Nachrichten, ausgelöst durch Ereignisse
Ihr System löst Aktionen der Plattform automatisch aus: Eine neue Bestellung führt zu einem Bestätigungsanruf, ein Zahlungsverzug zu einer Erinnerung, eine Statusänderung zu einer SMS oder Messenger-Nachricht. Dafür hat die Plattform eine API, mit der auch Ihre Entwickler arbeiten können.
- Anruf durch Ereignis
- SMS und Messenger per API
- API-Aufrufe aus Ihrem System
order.createdBestätigungsanrufgestartetpayment.overdueErinnerung des KI-Agents3 Versuchestatus.changedSMS an Kundenzugestelltticket.closedUmfrage in MAXgesendetFertige Integrationen mit CRM-Systemen und Messengern haben eigene Seiten. Hier geht es um die Anbindung eines Systems, das dort nicht aufgeführt ist.
So funktioniert es
Welche Protokolle wir nutzen
Webdienste
REST, SOAP und Webhooks
Die meisten aktuellen Systeme stellen Daten über REST oder SOAP bereit und melden Ereignisse per Webhook. Das ist der einfachste Weg: Die Daten fließen sofort, und ein Zugriffsschlüssel begrenzt die Berechtigungen.
- REST und JSON
- SOAP und XML
- Webhooks in beide Richtungen
RESTläuftSOAPläuftWebhooksläuftRESTTestTelefonie und Nachrichten
SIP, AMI, ARI, SMPP, IMAP
Ihre Telefonanlage binden wir per SIP an, Asterisk-Ereignisse lesen wir über AMI und ARI, FreeSWITCH-Ereignisse über ESL. SMS-Anbieter werden über ihre API oder SMPP angebunden, E-Mail über IMAP und SMTP.
- Ihre Anlage und Anbieter per SIP
- AMI und ARI für Asterisk
- SMPP, IMAP und SMTP
SIPTrunk des Netzbetreibers – registriertAMINeuer Anruf 493012345615 → Warteschlange 501ARIAgentin Anna ist dem Gespräch beigetretenSMPPSMS „Ihre Bestellung ist abholbereit“ – zugestelltIMAPNeue E-Mail an E-Mail anzeigenDirekter Datenzugriff
Datenbanken, Dateien und KI-Agenten
Hat das System keine API, lesen und schreiben wir direkt in seiner Datenbank – PostgreSQL, MySQL oder MS SQL – oder tauschen nach Zeitplan Dateien aus. MCP-Konnektoren geben KI-Agenten Zugriff auf Daten und Aktionen.
- SQL-Datenbanken und ODBC
- CSV und Excel nach Zeitplan
- MCP für KI-Agenten
PostgreSQLBestellungen und StatusonlineMS SQL · ODBCLagerbestandonlineCSV per SFTPPreislistealle 15 Min.MCPKundensuche für den KI-AgentonlineGeschäftssysteme
Abrechnung, Dokumentenmanagement und Intranet
Ihr Contact Center lässt sich auch mit Systemen verbinden, die kein CRM sind. Agents sehen Guthaben und Tarif eines Teilnehmers aus dem Abrechnungssystem, ein Anruf legt einen Vorgang im Dokumentenmanagement an, und im Firmen-Intranet rufen Mitarbeitende Kollegen mit einem Klick an und sehen, wer gerade erreichbar ist.
- Guthaben aus dem Abrechnungssystem
- Vorgänge im Dokumentenmanagement
- Kollegen aus dem Intranet anrufen
AbrechnungKontostandauf dem BildschirmDokumentenmanagementAnfrage aus AnruferstelltPortalClick-to-CallläuftVerzeichnisMitarbeiterstatusverfügbarContact-Center-Systeme
Parallel zu Ihrer bestehenden Contact-Center-Software
Nutzen Sie bereits Contact-Center-Software anderer Hersteller, wird die Plattform daran angebunden, statt sie vom ersten Tag an zu ersetzen. Sie können die Telefonie gemeinsam nutzen, Anrufereignisse in beide Richtungen abgleichen und Aufzeichnungen an Ihr Qualitätsmonitoring schicken. Die Leitungen ziehen nacheinander auf die Plattform um.
- Gemeinsame Telefonie
- Anrufereignisse in beide Richtungen
- Umzug Leitung für Leitung
TelefoniegemeinsamTrunkAnrufereignissebidirektionalper APIAufzeichnungenan das QA-SystemsynchronisiertMigrationZeile für Zeilewie geplantEinrichtung
So binden wir Ihr System an
- 01AnalyseWir klären, welche Daten Agents brauchen und wohin Gesprächsergebnisse gehen sollen.
- 02AustauschwegWir wählen den Weg: API des Systems, Webhooks, Datenbank oder Dateien nach Zeitplan.
- 03ZugangIhr Administrator stellt einen Schlüssel oder ein Konto mit genau den nötigen Berechtigungen aus.
- 04EntwicklungWir bauen den Konnektor und stimmen ab, welche Felder und Ereignisse übertragen werden.
- 05TestWir führen Testanrufe durch und prüfen die Daten in beiden Systemen.
- 06StartWir schalten den Austausch für alle Leitungen frei und beobachten in der ersten Woche das Fehlerprotokoll.
Voraussetzungen
Was eine API-Integration voraussetzt
- System
- Mindestens ein Weg, Daten herauszuholen: API, Datenbank oder Export
- Zugang
- Ein Schlüssel oder Konto mit Zugriff nur auf die nötigen Daten
- Netzwerk
- Plattform und Ihr System erreichen sich gegenseitig – über das Internet oder im selben Netz
- Dokumentation
- API-Dokumentation oder Datenbankschema, falls vorhanden
- Ansprechpartner
- Der Systemadministrator während Einrichtung und Test
- Kosten
- Entwicklungszeit – stundenweise im Paket Pro oder aus den Stunden des Pakets Maxi
Vorbereitung
Was Sie für eine API-Integration vorbereiten
Fragen und Antworten
Häufige Fragen
Welche Systeme lassen sich per API anbinden?
Jedes System, das Daten austauschen kann: per REST oder SOAP, Webhooks, Datenbank oder Dateiexport. Meist sind das CRM, ERP, Buchhaltungssoftware, Websites und Eigenentwicklungen.
Was, wenn unser System keine API hat?
Dann arbeiten wir direkt mit seiner Datenbank oder tauschen nach Zeitplan Dateien aus. Das ist langsamer als eine API, reicht aber für viele Aufgaben.
Können unsere Entwickler selbst mit der API der Plattform arbeiten?
Über die API startet Ihr System Anrufe und Nachrichten und empfängt Ereignisse aus Gesprächen. Wir helfen beim Einstieg und zeigen, welche Methoden zu Ihrer Aufgabe passen.
Welchen Zugriff auf unser System erhält die Plattform?
Nur den, den Sie dem Schlüssel oder Konto einräumen – etwa Kunden und Bestellungen lesen und Aufgaben anlegen. Läuft die Plattform auf Ihren Servern, verlässt der Datenaustausch Ihr Netz nicht.
Was unterscheidet eine API von einem MCP-Konnektor?
Eine API ist ein Austausch zwischen Systemen: Daten kommen ins Formular des Agents und gehen zurück. Ein MCP-Konnektor gibt einem KI-Agenten Zugriff auf Daten und Aktionen – er findet selbst, was er braucht, und führt erlaubte Vorgänge ohne menschliches Zutun aus.
Was passiert, wenn unser System ausfällt?
Anrufe und Chats laufen weiter, der Agent sieht nur keine Daten aus Ihrem System, bis es wieder erreichbar ist. Die Gesprächsergebnisse schickt die Plattform nach, sobald Ihr System wieder antwortet.
Was, wenn sich die API unseres Systems ändert?
Wir passen den Konnektor an die neue Version an. Wenn Sie uns das Update vorher ankündigen, erledigen wir das vor der Umstellung, und der Austausch läuft ohne Unterbrechung weiter.
Können wir direkt aus unserer eigenen Anwendung anrufen?
Anrufe und Outbound-Kampagnen lassen sich direkt aus Ihren Unternehmensanwendungen starten und steuern, ohne dass Mitarbeitende in ein anderes System wechseln. So arbeiten oft große Unternehmen mit eigenen Lösungen.
Was kostet eine API-Integration?
Sie zahlen nur die Entwicklungszeit – 55 € pro Stunde im Paket Pro oder aus den Stunden des Pakets Maxi. Den Umfang schätzen wir nach einer kurzen Prüfung.
Glossar
Begriffe auf dieser Seite
- API (Programmierschnittstelle)
- Der Weg, auf dem Programme ohne menschliches Zutun Daten austauschen. Mehr erfahren →
- Webhook
- Eine Nachricht, die ein System automatisch an ein anderes sendet, sobald etwas passiert. Mehr erfahren →
- REST: Datenaustausch zwischen Systemen per HTTP
- Das Standardverfahren, mit dem Programme Daten über das Internet austauschen. Mehr erfahren →
- SMTP und IMAP – E-Mail-Protokolle
- E-Mail-Protokolle: SMTP versendet Nachrichten, IMAP liest sie auf dem Server. Mehr erfahren →
- MCP (Model Context Protocol)
- Ein offenes Protokoll, mit dem KI auf Daten und Aktionen anderer Systeme zugreift. Mehr erfahren →
- CRM – Kundenbeziehungsmanagement
- Wo ein Unternehmen seine Kunden, Deals und den gesamten Kontaktverlauf führt. Mehr erfahren →
- SQL (Structured Query Language)
- Die Sprache, mit der Software Daten in Datenbanken bearbeitet. Mehr erfahren →
- SIP (Session Initiation Protocol)
- Das Protokoll, das in der IP-Telefonie Gespräche aufbaut. Mehr erfahren →
- AMI – Asterisk Manager Interface
- Der Kanal, über den Asterisk Anrufe meldet und Befehle annimmt. Mehr erfahren →
- SMPP (Short Message Peer-to-Peer)
- Das Protokoll, über das ein System SMS über einen Telefonanbieter versendet. Mehr erfahren →
- ERP – Enterprise Resource Planning
- Aufträge, Lager und Finanzen in einem System. Mehr erfahren →
- ARI – eigene Anrufanwendungen in Asterisk
- Die Schnittstelle, über die Ihre eigene Anwendung einen Anruf in Asterisk steuert. Mehr erfahren →
- On-Premises-Betrieb
- Das System läuft auf den eigenen Servern des Unternehmens, nicht in der Cloud des Anbieters. Mehr erfahren →
- Konnektor
- Ein fertiges Modul, das die Plattform mit Telefonie, CRM oder einem anderen System verbindet. Mehr erfahren →
- IP-Telefonanlage (IP PBX)
- Eine Firmen-Telefonanlage, die über Internet und lokales Netz arbeitet. Mehr erfahren →
- Cloud-Betrieb
- Die Plattform läuft auf den Servern des Anbieters, Agenten verbinden sich übers Internet. Mehr erfahren →
Aktualisiert: