Talkward × API
Eigene Systeme mit dem Posteingang verbinden
Verbinde deine eigenen Systeme mit dem Posteingang: Gespräche lesen, Nachrichten senden, Status und Felder setzen, per Webhook erfahren, wenn etwas passiert. Eine dokumentierte REST-API mit JSON und eigenen Schlüsseln, ohne Aufpreis ab Professional.
Kennst du das? Drei Situationen, in denen fertige Bausteine nicht reichen.
Zapier, Make und n8n decken viel ab. Aber manche Systeme sind selbst gebaut, laufen im eigenen Haus oder sollen ohne Umweg sprechen.
Die Wawi ist selbst geschrieben.
Kein Connector passt, kein Marktplatz-Baustein kennt sie. Trotzdem soll die KI den Bestellstatus daraus kennen, und dein Team die Kundennummer neben dem Gespräch sehen.
Das Ticketsystem bleibt.
Reklamationen laufen seit Jahren in deinem eigenen System mit Fristen und Auswertungen. Was im Chat übergeben wird, muss dort als Vorgang landen, automatisch.
Das Monitoring soll das Team erreichen.
Der Shop hat ein Problem, hundert Kunden schreiben gleich. Dein Team erfährt es aus dem Posteingang, nicht aus dem Monitoring, das es längst weiß.
Mit der API spricht dein System direkt mit Talkward, in beide Richtungen, mit einem Schlüssel, den du jederzeit zurückziehst. Make, Zapier und n8n nutzen dieselbe API.
Drei Anbindungen, die Händler zuerst bauen
Was ein Entwickler an einem Nachmittag schafft.
Alle Aufrufe sind JSON über HTTPS mit einem Bearer-Schlüssel. Beispiele aus deinen echten Gesprächen liefert die API selbst.
Eigenes System → Felder im Gespräch
Bei jeder neuen Kundennachricht (Webhook) sucht dein System die Kundennummer und den Bestellstatus und schreibt beides als Felder ins Gespräch. Dein Team und die KI sehen es neben dem Chat.
Übergabe → Vorgang im eigenen Ticketsystem
Übergibt die KI an das Team, legt dein System einen Vorgang mit der Zusammenfassung an und schreibt die Vorgangsnummer als Notiz zurück. Erledigt im Ticketsystem, erledigt in Talkward.
Störung → Meldung an das Team
Meldet dein Monitoring einen Ausfall, schickt dein Skript eine dringende Meldung in den Team-Kanal des Posteingangs. Das Team weiß Bescheid, bevor der erste Kunde schreibt.
So funktioniert die APILesen, Schreiben, Webhooks.
Die API liegt unter chat.talkward.app/api/v1. Du erzeugst unter Erweiterungen einen Schlüssel und schickst ihn als Bearer-Token mit. Lesen: Gespräche, Nachrichten, Kontakte, Marken, Team. Schreiben: Nachricht im Gespräch, neue Nachricht an einen Kontakt per E-Mail oder WhatsApp, Notiz, Status, Zuweisung, Tags, Felder, Kontakt. Webhooks melden sieben Ereignisse an deine Adresse, signiert. Dazu Meldungen in Team-Kanäle. Alle Antworten sind JSON mit ok und einem Fehlercode, wenn etwas fehlt.
Dokumentiert, mit echten Beispielen
Jede Route mit Feldern, Fehlercodes und Antworten. Für Webhooks liefert die API Beispiel-Nutzlasten aus deinen echten Gesprächen. Die öffentliche Doku-Seite ist in Vorbereitung; bis dahin steht sie auf der Einrichten-Seite.
Sieben Webhook-Ereignisse
Neue Kundennachricht, gesendete Nachricht, neues Gespräch, Übergabe an das Team, erledigt, Zuweisung, Tag. Wahlweise nur für eine Marke. Jede Zustellung ist mit HMAC signiert, fehlgeschlagene werden wiederholt.
Schlüssel je System
Ein Schlüssel gehört zu einem Arbeitsbereich und sieht nur dessen Daten. Du legst je System einen eigenen an und ziehst ihn dort zurück. 300 Anfragen je Minute je Schlüssel.
Server in Nürnberg
Die API läuft auf denselben Servern wie der Posteingang, in ISO/IEC 27001:2022-zertifizierten Rechenzentren in Nürnberg. Kein Drittanbieter dazwischen, wenn du selbst anbindest.
- Anbindung
- REST-API /api/v1 mit JSON und Bearer-Schlüssel, Webhooks mit Signatur
- Zugriff
- Gespräche, Nachrichten, Kontakte, Marken, Team (lesen); Nachrichten, Notizen, Status, Zuweisung, Tags, Felder, Kontakt (schreiben)
- Verarbeitung
- Nürnberg (ISO 27001), Köln, Paris. Option „Nur Europa“. Zugangsdaten verschlüsselt gespeichert, Aufträge nur kurz zwischengespeichert.
Was dein System schreibt, steht im Gespräch.
Felder, Notizen, Tags und Nachrichten aus der API sehen im Posteingang aus wie alles andere: mit Zeit und dem Namen des Schlüssels als Absender. Dein Team sieht, was automatisch passiert ist, und die KI nutzt die Felder für ihre Antworten.
- Felder aus deinem System
- Notizen
- Tags
- Status
- Webhook-Ereignisse
- Schlüssel je System
- Kundennummer
- K-88213 (aus eigener Wawi)
- Versandstatus
- Versendet, 24.09. (Feld per API)
- Vorgang
- T-4711 im Ticketsystem
- Letzter Webhook
- uebergabe, 25.09., 09:41
Einrichtung in drei Schritten.
Ab Professional, ohne Aufpreis. Du brauchst jemanden, der HTTP und JSON kann; sonst nichts.
Schlüssel erzeugen
In Talkward unter Einstellungen › Erweiterungen › API einen Schlüssel anlegen. Er beginnt mit tw_ und wird nur einmal angezeigt.
Screenshot folgtVerbindung prüfen
GET /api/v1/ich mit dem Schlüssel aufrufen. Die Antwort nennt deinen Arbeitsbereich und den Schlüssel. Dann GET /gespraeche für die ersten echten Daten.
Screenshot folgtWebhook anlegen
POST /webhooks mit Ereignis und deiner HTTPS-Adresse. Talkward liefert ein Geheimnis für die Signatur und Beispiel-Nutzlasten aus deinen Gesprächen zum Testen.
Screenshot folgt
In Professional enthalten
ohne Aufpreisab Professional, vorläufig, netto
Ohne Aufpreis ab Professional, nichts extra zu buchen. Dieselbe API, auf der Make, Zapier und n8n aufsetzen.
Alle Stufen und Preise- Gespräche, Nachrichten, Kontakte, Marken und Team lesen
- Nachrichten senden, Notizen, Status, Zuweisung, Tags, Felder und Kontakt setzen
- Sieben Webhook-Ereignisse, signiert, mit Beispielen aus deinen Daten
- Meldungen in Team-Kanäle, eigene Schlüssel je System
- Server in Nürnberg (ISO 27001)
- AV-Vertrag
- KI-Antworten gekennzeichnet (EU-KI-Verordnung)
- Erweiterungen monatlich kündbar
Fragen zur API
Deine Frage fehlt? Schreib uns an hey@talkward.app.
Was kann die API?
Lesen: Gespräche, Nachrichten, Kontakte, Marken, Team. Schreiben: Nachricht im Gespräch, neue Nachricht an einen Kontakt per E-Mail oder WhatsApp, Notiz, Status, Zuweisung, Tags, Felder, Kontakt. Dazu Webhooks für sieben Ereignisse und Meldungen in Team-Kanäle.
Wo finde ich die Dokumentation?
Auf der Einrichten-Seite der Erweiterung, mit allen Routen, Feldern und Fehlercodes. Die öffentliche Doku-Seite auf talkward.app ist in Vorbereitung. Beispiel-Nutzlasten für Webhooks liefert die API aus deinen echten Gesprächen.
Wie sicher sind die Schlüssel?
Ein Schlüssel gehört zu genau einem Arbeitsbereich und sieht nur dessen Daten. Du legst je System einen eigenen an und ziehst ihn jederzeit zurück. Webhook-Zustellungen sind mit HMAC signiert, je Schlüssel gelten 300 Anfragen pro Minute.
Brauche ich die API, wenn ich Zapier oder n8n nutze?
Nein. Zapier, Make und n8n bringen fertige Bausteine mit und nutzen dieselbe API. Die API selbst brauchst du für eigene Systeme oder Anbindungen ohne Umweg.
Was kostet die API?
Nichts extra, enthalten ab Professional. Alle Preise sind vorläufig und netto.
Passt dazu
Zapier-AnbindungÜbergaben in Slack, Reklamationen in Sheets, Bestellungen als WhatsApp: über 7.000 Apps, ohne Code.
n8n-AnbindungTalkward als Node in deinem eigenen n8n. Auslöser, Aktionen und Werkzeug für KI-Agenten.
WhatsApp BusinessWhatsApp im Team-Posteingang, mit deinem eigenen Business-Konto und deiner Nummer.
Kritische AlarmeLaute Alarme aufs Handy, auch nachts. Weiter an die nächste Person, bis jemand übernimmt. 5 € je Alarmgruppe.
MCP-ServerClaude, ChatGPT und eigene Agenten lesen und bearbeiten deinen Posteingang, mit eigenem Schlüssel je Agent.- Alle IntegrationenShop, Warenwirtschaft, Marktplätze, Versand und Service
Sichere dirdeinen Platz.
Drei Angaben, keine Verpflichtung. Wir melden uns innerhalb von zwei Werktagen persönlich.