Alle Artikel
Integrationen & Analytics

API-Schlüssel und Webhooks sicher verwenden

Signalist verbindet sich auf drei Wegen mit deinen eigenen Systemen: über die API , über Webhooks , die Leads an deinen Endpunkt senden, und über den MCP Server für KI Assistenten. Alle drei findest du unter Integrations in der Seitenleiste, im Bereich Developer .

API-Schlüssel

Öffne Integrations → API.

  • Go to documentation öffnet die API-Referenz unter docs.signalist.io.
  • Create new API key fragt nach einem Namen. Der Schlüssel wird einmal angezeigt, unter Your new API key: Kopiere ihn mit Copy to clipboard und bewahre ihn in einem Passwortmanager oder Secret Store auf. Du kannst ihn später nicht mehr sehen.
  • Die Tabelle listet deine Schlüssel mit Name, den ersten Zeichen des Schlüssels und Issued at. Revoke schaltet einen Schlüssel dauerhaft ab.

Ein Schlüssel handelt für deinen ganzen Workspace und hat weder Berechtigungsumfang noch Ablaufdatum. Wenn ein Schlüssel Leads hinzufügt oder ändert, erreicht er nur die öffentlichen Listen deines Workspace; private Listen sind mit einem API-Schlüssel nicht erreichbar. Wenn du einen Lead über die API aktualisierst, werden Felder, die keine Lead-Felder sind, ignoriert, und Liste, Prospect und Status eines Leads lassen sich auf diesem Weg nicht ändern. Deshalb:

  • lege pro System oder Integration einen eigenen Schlüssel an und benenne ihn danach;
  • füge einen Schlüssel nie in E-Mails, Chats, Tickets oder Code-Repositories ein;
  • um einen Schlüssel zu ersetzen, lege einen neuen an, stelle dein System um und widerrufe dann den alten mit Revoke;
  • wenn ein Schlüssel möglicherweise bekannt geworden ist, widerrufe ihn sofort.

Webhooks

Webhooks senden Leads aus einer Liste an eine URL von dir, zum Beispiel um einen Workflow in einem anderen Tool zu starten.

Einen Webhook anlegen

  1. Öffne Integrations → Webhooks und klicke auf Create new webhook.
  2. Gib einen Name und die Webhook URL ein. Die URL muss eine öffentliche Adresse sein, die mit https:// beginnt (siehe „Eine Zustellung zeigt Not sent“ weiter unten).
  3. Schalte Receives data after workflow is completed ein, wenn dein System Daten zurücksendet; benenne dann die benutzerdefinierten Spalten, in die sie geschrieben werden.
  4. Wähle das Payload format: Version 2: one event per lead (Standard für neue Webhooks) oder Version 1: list of leads (legacy). Siehe „Ein Payload-Format wählen“ weiter unten.

Der Dialog Create Webhook mit den Optionen für das Payload format; Version 2: one event per lead ist standardmäßig ausgewählt

  1. Bestätige. Der Dialog Webhook created: copy your signing secret zeigt das Secret einmal an. Kopiere es in deinen Empfänger; siehe „Signierte Zustellungen“ weiter unten.

Leads daran senden

In den Einstellungen einer Liste wählst du unter Advanced settings → Send leads to a webhook den Webhook und wann Leads gesendet werden: alle gefundenen Leads, alle Leads einschließlich nicht gefundener, alle gefundenen und unsicheren Leads, wenn ein Lead einer Kampagne zugewiesen wird oder wenn ein Lead antwortet. Du kannst auch Leads in einer Liste auswählen und Add to webhook nutzen.

Jeder Lead wird als eigene JSON-Anfrage gesendet, mit denselben Lead-Feldern wie in einem Listenexport. Wie die Anfrage um den Lead herum aufgebaut ist, hängt vom Payload-Format des Webhooks ab.

Ein Payload-Format wählen

Jeder Webhook hat ein Payload format. Du wählst es im Dialog Create new webhook und kannst es später ändern, indem du den Webhook zum Bearbeiten öffnest.

  • Version 2: one event per lead. Jede Zustellung ist ein JSON-Objekt, das sagt, um welches Ereignis es geht, der Zustellung eine ID gibt und Zeitpunkt, Webhook und Liste nennt. Der Lead steht unter data. Nutze es, wenn ein Endpunkt mehrere Auslöser empfängt oder wenn dein System wiederholte Zustellungen überspringen soll.
  • Version 1: list of leads (legacy). Der Body ist ein JSON-Array, das die Lead-Zeile enthält, so wie Webhooks sie schon immer erhalten haben. Webhooks, die es vor der Einführung der Payload-Formate gab, bleiben auf Version 1 und erhalten genau das, was sie bisher erhalten haben. Für sie ändert sich nichts, solange du sie nicht umstellst.

Ein Wechsel des Formats gilt für die nächsten Zustellungen. Zustellungen, die vor der Einführung der Payload-Formate schon in der Warteschlange lagen, werden weiterhin als Version 1 gesendet, auch an einen Webhook, den du auf Version 2 umgestellt hast.

Bevor du einen bestehenden Webhook auf Version 2 umstellst, stelle sicher, dass dein Endpunkt ein Objekt statt eines Arrays lesen kann.

Was eine Zustellung in Version 2 enthält

{
  "id": "2a60142d-c9e6-5f8d-8c93-e0454481e5fa",
  "type": "lead.assigned",
  "createdAt": "2026-10-13T16:10:00.000Z",
  "webhookId": 24,
  "list": { "id": 238, "name": "Meine Liste" },
  "data": { "id": 15136, "firstName": "…", "lastName": "…" }
}
FeldBedeutung
idDie ID der Zustellung. Eine Wiederholung derselben Zustellung trägt dieselbe id, sodass du damit eine bereits verarbeitete Zustellung überspringen kannst. Ein neuer Auslöser oder ein erneutes Senden des Leads mit Add to webhook ist eine neue Zustellung mit neuer id.
typeWas passiert ist. Siehe die Ereignistypen unten.
createdAtWann die Zustellung erstellt wurde, als ISO-8601-Zeit in UTC. Die Anfrage selbst kann einige Sekunden später folgen.
webhookIdDie ID des Webhooks, der sie gesendet hat.
listDie id und der name der Liste, zu der der Lead gehört.
dataDer Lead, mit denselben Feldern wie in Version 1 (und wie in einem Listenexport). In seltenen Fällen, wenn der Lead nicht mehr exportiert werden kann, ist data gleich null.

Ereignistypen:

typeWann er gesendet wird
lead.qualifiedDer Auslöser der Liste ist All found leads.
lead.foundDer Auslöser ist All leads (Found & Unsure), oder der Auslöser ist All leads including not found und der Lead ist gefunden oder unsicher.
lead.not_foundDer Auslöser ist All leads including not found und der Lead ist nicht gefunden (jeder andere Lead).
lead.assignedDer Auslöser ist When assigned.
lead.repliedDer Auslöser ist When lead replied.
lead.manual_sendDu hast den Lead selbst mit Add to webhook gesendet.

Der type wird beim Senden der Zustellung bestimmt. Ändert sich der Status eines Leads, während eine Zustellung wiederholt wird, kann eine Wiederholung unter derselben id einen anderen type tragen.

Sehen, an welchen Listen ein Webhook hängt

Ein Webhook sendet nur Leads aus den Listen, mit denen du ihn verknüpfst. Die Spalte Lists der Webhook-Tabelle zeigt jede Liste, mit der ein Webhook verknüpft ist, zusammen mit dem für diese Liste eingestellten Auslöser, zum Beispiel „When assigned“. Ein Klick auf den Listennamen öffnet die Einstellungen dieser Liste.

  • Drei Listen werden angezeigt; mit + N more siehst du die übrigen, mit Show less klappst du sie wieder zu.
  • Eine Liste, die nicht aktiv ist, trägt den Hinweis List inactive.
  • Eine private Liste einer Kollegin oder eines Kollegen wird mitgezählt („1 private list of a colleague“), ohne Namen und ohne Link.
  • Ein Webhook mit der Anzeige Not attached to any list erhält automatisch keine Leads. Schalte ihn in den Einstellungen einer Liste unter Advanced settings → Send leads to a webhook ein. Wenn du Leads auswählst und Add to webhook nutzt, sendest du weiterhin von Hand an ihn.

Signierte Zustellungen

Die Zustellungen jedes neuen Webhooks werden mit einem Secret signiert, das nur du und Signalist kennen, damit dein Empfänger prüfen kann, dass eine Anfrage von Signalist stammt. Die Spalte Signing der Webhook-Tabelle zeigt Signed, oder Secret not yet viewed bei einem Webhook, der vor der Einführung der Signatur angelegt wurde (vor dem 14. Oktober 2026). Das Zeilenmenü (More actions) bietet Send test event, Rotate secret und, für diese älteren Webhooks, Reveal secret once.

Ein älterer Webhook mit der Anzeige Secret not yet viewed liefert weiter wie bisher aus: unsigniert, ohne Prüfung auf private Adressen und mit gefolgten Weiterleitungen. Auf signierte Zustellung, mit Adressprüfung und ohne Weiterleitungen, stellt er um, sobald du Reveal secret once oder Rotate secret wählst oder seine URL änderst. Er wechselt nie zurück. Neue Webhooks sind von Anfang an signiert.

Wie du eine Signatur prüfst, wie du das Secret rotierst und was ein Testereignis tut, steht in Webhook-Signaturen. Die Prüfung der Signatur ist optional; dein Empfänger funktioniert auch ohne sie weiter.

Wenn Zustellungen fehlschlagen

Signalist wiederholt eine Zustellung, wenn dein Endpunkt nicht antwortet oder mit einem vorübergehenden Fehler (408, 429 oder 5xx) antwortet: nach 1 Minute, 10 Minuten, 1 Stunde, 6 Stunden und 24 Stunden. Signalist wartet bis zu 180 Sekunden auf eine Antwort; ist bis dahin keine eingetroffen, zählt der Versuch als Fehler, der wiederholt wird, und die Spalte Status zeigt „No complete answer within 180 seconds“. Jeder andere Fehler ist endgültig.

  • Die Spalte Status zeigt Delivering, Retrying, Failing, Last delivery failed, Paused oder No deliveries yet. Darunter zeigen Last delivered und Last failed das Datum der letzten erfolgreichen und der letzten fehlgeschlagenen Zustellung, soweit es sie gibt.
  • Nach 3 endgültig fehlgeschlagenen Zustellungen in Folge bekommen die Person, die den Webhook angelegt hat, und deine Company Admins einen Hinweis in der App und eine E-Mail: „A webhook is failing“.
  • Nach 100 in Folge wird der Webhook pausiert, und es wird nichts mehr gesendet. Korrigiere oder ersetze die URL und klicke dann auf Resume.
  • Leads, die nicht zugestellt werden konnten, werden nicht automatisch erneut gesendet. Um sie selbst erneut zu senden, siehe „Zustellungen ansehen und erneut senden (Seite Deliveries)“ unten.

Da eine Zustellung wiederholt werden kann, kann dein Endpunkt denselben Lead zweimal erhalten. Mit Version 2 überspringst du eine Zustellung, deren id du schon verarbeitet hast. Version 1 hat keine ID, vergleiche dort die E-Mail oder die LinkedIn-URL des Leads.

Eine Zustellung zeigt Not sent

Signalist sendet eine signierte Zustellung (siehe „Signierte Zustellungen“ oben) nie an eine private oder interne Adresse: eine URL auf localhost, eine Loopback-Adresse wie 127.0.0.1, ein privates Netz wie 10.x oder 192.168.x, eine Link-Local-Adresse wie 169.254.x oder einen Namen, der auf eine davon zeigt. Ein solcher Webhook kann keine Leads empfangen. Ein älterer Webhook mit der Anzeige Secret not yet viewed wird wie bisher ohne diese Prüfung ausgeliefert, bis er auf signierte Zustellung umstellt.

  • Beim Anlegen oder Bearbeiten eines Webhooks mit so einer URL lehnt der Dialog sie ab, auch bei älteren Webhooks: „This URL points to a private network address, which cannot receive webhooks. Use a public URL.“ Eine URL, die keine Webadresse ist, meldet „This is not a web address. Enter a URL that starts with https://.“ Es wird nichts gespeichert.
  • Hat ein signierter Webhook schon so eine URL (zum Beispiel weil sie vor dieser Prüfung gespeichert wurde), werden seine Zustellungen nicht gesendet und sofort aufgegeben, ohne Wiederholungen. Die Spalte Status zeigt den Grund: „Not sent: the URL points to a private network address, which cannot receive webhooks“.
  • Nach 3 nicht gesendeten Leads in Folge bekommen die Person, die den Webhook angelegt hat, und deine Company Admins den Hinweis Nothing is sent to webhook "…". Nach 100 in Folge wird der Webhook pausiert, mit dem Hinweis Webhook "…" was paused. Beide sagen, was zu tun ist: Ändere die URL unter Integrations → Webhooks. Eine geänderte URL hebt auch die Pause auf. Leads, die nicht gesendet wurden, werden nicht automatisch erneut gesendet.
  • Send test event lehnt eine private URL ebenfalls ab, mit demselben Text.

Zum Beheben öffnest du den Webhook zum Bearbeiten, klickst auf Replace URL und fügst eine öffentliche URL ein, auf der dein Empfänger antwortet.

Ein signierter Webhook folgt keinen Weiterleitungen. Antwortet deine URL mit einer Weiterleitung (301, 302 und so weiter), endet die Zustellung als fehlgeschlagen mit „302 Found: redirects are not followed, use the final URL“, und an die Adresse, auf die sie zeigt, wird nichts gesendet. Trage stattdessen die endgültige URL im Webhook ein. Ein älterer Webhook mit der Anzeige Secret not yet viewed folgt Weiterleitungen wie bisher; stellst du ihn auf signierte Zustellung um, ersetze eine weiterleitende URL vorher durch die endgültige.

Zustellungen ansehen und erneut senden (Seite Deliveries)

Jeder Webhook hat eine Seite Deliveries. Öffne Integrations → Webhooks, suche deinen Webhook und klicke in der Spalte Status auf View deliveries oder im Zeilenmenü auf Deliveries.

Du brauchst dieselben Rechte wie zum Verwalten von Webhooks und Zugriff auf Integrations. Zustellungen aus der privaten Liste einer Kollegin oder eines Kollegen kannst du weder sehen noch erneut senden.

Die Seite bewahrt Zustellungen 90 Tage lang auf. Zustellungen vor dem 15. Oktober 2026 wurden nicht aufgezeichnet. Filtere mit Status, From und To.

Das Zustellungsprotokoll lesen

SpalteWas sie zeigt
TimeWann die Zustellung angelegt wurde.
LeadDen Lead, der an den Webhook gesendet wurde.
TriggerWas das Senden ausgelöst hat, mit denselben Bezeichnungen wie in den Listeneinstellungen.
StatusDen aktuellen Stand der Zustellung.
AttemptsDie Anzahl der Zustellversuche.
Last HTTP statusDen letzten HTTP-Statuscode des Empfängers.
Response excerptEinen kurzen Ausschnitt aus der Antwort des Empfängers.
  • Delivered: Der Empfänger hat erfolgreich geantwortet.
  • Retrying: Signalist sendet die Zustellung nach dem normalen Zeitplan erneut. Siehe „Wenn Zustellungen fehlschlagen“ oben.
  • Given up: Es sind keine weiteren automatischen Versuche geplant. Die Wiederholungen sind aufgebraucht, der Empfänger hat einen endgültigen Fehler gemeldet oder die Zustellung konnte nicht gesendet werden.

Öffne eine Zeile, um ihre Versuche und die letzte Antwort des Empfängers zu sehen. Der Ausschnitt zeigt die Antwort des Empfängers, keine Kopie der gesendeten Lead-Daten.

Eine Zustellung erneut senden

  1. Klicke bei einer aufgegebenen Zeile auf das Symbol zum erneuten Senden, oder öffne die Zustellung und klicke auf Redeliver….
  2. Prüfe die Anzahl und mögliche Gründe für das Überspringen. Klicke dann auf Redeliver 1 delivery.

Alle fehlgeschlagenen Zustellungen erneut senden

  1. Klicke auf Redeliver all failed (N)…. Die Zahl im Button ist die Anzahl der Zustellungen. Damit sendest du aufgegebene Zustellungen erneut.
  2. Prüfe, wie viele erneut gesendet und übersprungen werden. Bestätige mit Redeliver N deliveries, mit der Zahl aus dem Dialog (zum Beispiel Redeliver 2 deliveries).

Übersprungen werden Zustellungen mit Retrying, aus der Liste entfernte oder gelöschte Leads und Zustellungen, die durch ein späteres erneutes Senden bereits zugestellt wurden. Der Dialog zeigt die Anzahl und die Gründe.

Einen Zeitraum erneut senden

  1. Klicke auf Redeliver date range….
  2. Stelle From und To einschließlich der Uhrzeiten ein. Prüfe die angezeigte Zeitzone.
  3. Lass Given up only (recommended) ausgewählt oder wähle Every delivery in the range, including delivered ones, um auch erfolgreiche Zustellungen erneut zu senden.
  4. Prüfe vor dem Senden „N deliveries will be resent. M will be skipped.“ und die Gründe für das Überspringen. Die empfohlene Option überspringt bereits zugestellte Zustellungen; laufende Wiederholungen und entfernte Leads werden ebenfalls übersprungen.
  5. Bestätige mit Redeliver N deliveries, mit der Zahl aus dem Dialog (oder Redeliver 1 delivery bei einer Zustellung).

Der Dialog "Redeliver date range": die Auswahl und die Anzahl der Zustellungen, die erneut gesendet und übersprungen werden

Was beim erneuten Senden passiert

Beim erneuten Senden bleibt die ursprüngliche Zustellungs-ID erhalten. Dein Empfänger kann damit bereits verarbeitete Duplikate überspringen. Der Payload wird aus den aktuellen Daten des Leads neu aufgebaut. Dabei gelten die aktuellen Signatureinstellungen und das aktuelle Secret des Webhooks.

Ein erneutes Senden an einen signierten Webhook ist als solches markiert: Es trägt den Header X-Signalist-Redelivery: true, und eine Zustellung in Version 2 enthält zusätzlich das Feld "redelivery": true. Ein vor dem 14. Oktober 2026 angelegter Webhook, der noch nicht auf signierte Zustellung umgestellt wurde, sendet genau wie bei seinen normalen Zustellungen erneut, also unsigniert und ohne diese Markierungen.

Das erneute Senden zählt als ein Versuch. Schlägt er fehl, gelten die normalen Regeln für Wiederholungen; siehe „Wenn Zustellungen fehlschlagen“ oben.

Pro erneutem Senden sind höchstens 500 Zustellungen möglich, mit höchstens 5 pro Sekunde. Sind mehr als 500 ausgewählt, wähle einen kürzeren Zeitraum. Pro Webhook kann nur ein erneutes Senden gleichzeitig laufen. Warte, bis es abgeschlossen ist, bevor du ein weiteres startest.

Wenn der Webhook pausiert ist

Ein pausierter Webhook sendet nichts erneut. Die Seite meldet: „Nothing was redelivered. The webhook is paused. Resume it to redeliver. No deliveries were changed.“

Klicke beim Webhook auf Resume und versuche danach erneut zu senden.

Die Seite Deliveries eines pausierten Webhooks mit der Meldung „Nothing was redelivered. The webhook is paused. Resume it to redeliver. No deliveries were changed.“

Webhooks sicher nutzen

  • Nutze eine öffentliche HTTPS-URL.
  • Braucht dein Endpunkt ein Secret, gib es in der URL mit. Signalist protokolliert den Query-String nicht.
  • Die Webhook-Tabelle blendet den geheimen Teil einer URL aus: Ein Secret im Pfad und die Werte nach dem ? erscheinen als •••, zum Beispiel https://hooks.example.com/services/••• oder https://example.com/hook?token=•••&env=•••. Eine URL ohne Secret wird vollständig angezeigt.
  • Um die URL zu ändern, öffne den Webhook zum Bearbeiten, klicke auf Replace URL und füge die vollständige neue URL ein. Lässt du die URL unverändert, bleibt die gespeicherte URL genau so, wie sie war. Eine URL, die noch den ausgeblendeten Teil (•••) enthält, wird nicht gespeichert: Du siehst die Meldung „This address still contains the hidden part (•••). Paste the full webhook address.“
  • Prüfe die Signatur jeder Zustellung (Webhook-Signaturen). Schalte bei einem älteren Webhook zuerst die Signatur ein.
  • Übernimm nur die Felder, die du brauchst, und prüfe sie, bevor du sie verwendest.

KI-Assistenten (MCP)

Der MCP Server erlaubt einem KI-Assistenten wie Claude, mit deinen Signalist-Daten zu arbeiten. Es gibt keinen Schlüssel zum Einfügen: Der Assistent öffnet eine Signalist-Seite, Connect an AI application, auf der du auf Connect klickst. Er handelt dann als du, mit deinen Berechtigungen. Er kann in deinem Namen auch Nachrichten und LinkedIn-Einladungen senden und Kampagnen starten. Vor jedem Versand und jedem Kampagnenstart fragt er dich um Bestätigung, Nachrichten und Einladungen, die er einreiht, warten vor dem Versand in einem Zeitfenster zum Rückgängigmachen, in dem du sie abbrechen kannst, und die täglichen Versandlimits des Absenders gelten; nur manche Sendungen können sie mit deiner Zustimmung überschreiten.

Der Assistent beantwortet auch Fragen zu deinen Ergebnissen und dazu, was Aufmerksamkeit braucht, zum Beispiel „Wie liefen meine Kampagnen im letzten Monat?“. Er liest:

  • die Zahlen aus Analytics: Outreach-Kennzahlen für die Listen, Kampagnen und den Zeitraum, die du nennst, die Übersicht pro Liste und Kampagne, deine besten Kampagnen nach Antwortrate, die tägliche Aktivität und die Limits jedes Senders sowie die monatliche Aktivität der Signale deiner Tracker;
  • die Zahlen der Campaigns-Übersicht, wenn dein Workspace die Campaigns-Übersicht hat;
  • die Hinweise, die dein Dashboard zeigt, etwa ein getrenntes LinkedIn- oder E-Mail-Konto oder eine Liste ohne Ergebnisse, jeweils mit einem kurzen Hinweis, wie du das Problem behebst.

Diese Zahlen stammen aus derselben Berechnung wie in der App und stimmen daher bei gleichen Filtern mit der Analytics-Seite überein. Wie in der App brauchst du für die Analytics-Zahlen Zugriff auf Analytics.

Dashboard-Hinweise über MCP ausblenden

Der Assistent kann auch einen Hinweis in deinem Dashboard ausblenden, wenn du nicht daran erinnert werden möchtest, und ihn später wieder einblenden. Bitte ihn, einen Hinweis auszublenden oder wiederherzustellen, den er aus deinem Dashboard gelesen hat, zum Beispiel „Blende den Hinweis zur Prüfung der Wettbewerber aus.“

  • Einen Hinweis ausblenden versteckt ihn in deinem Dashboard, genau wie das Ausblenden in der App. Der Assistent sagt dir, was er ausgeblendet hat und für wen.
  • Einen ausgeblendeten Hinweis wiederherstellen zeigt ihn in deinem Dashboard wieder an. War der Hinweis nicht ausgeblendet, ändert sich nichts, und der Assistent sagt es dir.

Die meisten Ausblendungen gelten nur für dich. Einige Hinweise betreffen den ganzen Workspace; blendest du einen davon aus, ist er für alle in deinem Unternehmen versteckt, und der Assistent sagt dir, um welche Art es sich handelt: zu wenige Credits, Wettbewerber, die geprüft werden müssen, ein fehlender Besitzer für HubSpot-Notizen, eine fehlende Besitzer-Berechtigung in Dynamics, ein CRM, das neu verbunden werden muss, und ein Zoho-LinkedIn-Feld, das nicht durchsucht werden kann. Der Hinweis auf zu wenige Credits kommt zurück, sobald das Dashboard das nächste Mal deine Credits prüft; das Ausblenden hält ihn also nicht lange versteckt. Wie in der App brauchst du Zugriff auf Listen. Es wird nichts gelöscht oder geändert, außer ob der Hinweis angezeigt wird, und du kannst ihn jederzeit wiederherstellen.

Listen über MCP anlegen

Der Assistent kann auch eine Liste für dich anlegen, aus diesen Quellen:

  • Sales Navigator: eine Sales-Navigator-Such-URL. Dafür braucht es eine Kollegin oder einen Kollegen mit verbundenem Sales Navigator.
  • LinkedIn-Personensuche: eine Such-URL oder Stichwörter mit optionalem Titel, Unternehmen, Hochschule, Namen und Kontaktgrad.
  • Jobs: die Unternehmen, die für eine Stelle an einem Ort einstellen, und die passenden Personen dort.
  • Lookalike-Unternehmen: Unternehmen, die bis zu 10 Ausgangsunternehmen (per Domain) ähneln, aus der Lead-Datenbank, und die Personen dort.

Wie in der App brauchst du Zugriff auf Listen und auf die Quelle. Das Anlegen der Liste kostet nichts und startet keinen Lauf: Die neue Liste wird pausiert angelegt, und du startest ihren ersten Lauf in der App, die vorher die Einrichtung prüft. Ein Lauf kostet dann Credits wie beim Anlegen der Liste in der App.

Über MCP zu einem Tracker hinzufügen

Der Assistent kann Einträge zu einem deiner Tracker hinzufügen. Wie in der App brauchst du dafür Zugriff auf Tracker. Eine Anfrage fügt eine Art von Einträgen hinzu, bis zu 100 auf einmal:

  • Unternehmen per CompanyEnrich-ID.
  • Personen per LinkedIn-Profil-URL, hinzugefügt zur Liste des Trackers. Ein Profil, das Signalist noch nicht kennt, kostet beim Abruf Credits.
  • Unternehmen per LinkedIn-Unternehmensseiten-URL oder per Domain (zum Beispiel acme.com). Ein Unternehmen, das Signalist schon kennt, wird sofort hinzugefügt; jedes andere wird als ausstehender Eintrag angelegt, den der nächste geplante Lauf des Trackers nachschlägt. Werte, die keine Unternehmens-URL und keine Domain sind, werden als ungültig gemeldet.
  • Die Leads einer deiner Listen, entweder die Leads selbst oder die Unternehmen, bei denen sie arbeiten. Die Liste darf höchstens 100 Leads enthalten; eine längere Liste importierst du stattdessen im Schritt Sources des Trackers. Die private Liste einer Kollegin oder eines Kollegen und die eigene Liste des Trackers lassen sich nicht verwenden, und hinter dem Tracker muss eine Liste stehen.

Der Assistent antwortet mit einem Bericht: wie viele Einträge hinzugefügt wurden, wie viele der Tracker schon hatte (übersprungen) und wie viele ungültig waren oder nicht hinzugefügt werden konnten. Wiederholst du eine Anfrage, wird nichts doppelt hinzugefügt. Wie in der App wird ein neu verfolgtes Unternehmen bewertet und Teil des wiederkehrenden Signal-Scans des Trackers.

Zum Trennen gehe zu Personal settings → Connected Accounts → Connected AI applications und klicke auf Disconnect. MCP-Zugriff wird pro Workspace freigeschaltet; siehst du „MCP access is not enabled for your company“, wende dich an deinen Ansprechpartner bei Signalist.

Fehlerbehebung

ProblemWas zu tun ist
Eine API-Anfrage wird abgelehntPrüfe, ob der Schlüssel im Header api-key gesendet wird und nicht widerrufen wurde.
Ein Webhook zeigt FailingPrüfe, ob die URL erreichbar ist und mit einem 2xx-Status antwortet.
Ein Webhook ist PausedKorrigiere oder ersetze die URL und klicke dann auf Resume. Fehlgeschlagene Leads werden nicht automatisch erneut gesendet. Sobald er wieder läuft, kannst du sie auf der Seite Deliveries des Webhooks erneut senden (siehe „Zustellungen ansehen und erneut senden (Seite Deliveries)“). Lautet der Grund „Not sent: the URL points to a private network address“, ersetze die URL durch eine öffentliche.
Mein Empfänger war ausgefallen und hat Leads verpasstÖffne die Seite Deliveries des Webhooks und nutze Redeliver all failed (N)…, um aufgegebene Zustellungen erneut zu senden. Prüfe vor dem Bestätigen die Anzahl und die Gründe für das Überspringen.
Eine Zustellung zeigt „Not sent: the URL points to a private network address“Die URL liegt auf localhost, einem privaten Netz oder einer Link-Local-Adresse oder ist ein Name, der auf eine davon zeigt. Öffne den Webhook zum Bearbeiten, klicke auf Replace URL und füge eine öffentliche URL ein.
„This URL points to a private network address, which cannot receive webhooks. Use a public URL.“Webhooks können nur an öffentliche Adressen gehen. Nutze die öffentliche URL deines Empfängers.
„302 Found: redirects are not followed, use the final URL“Deine URL antwortet mit einer Weiterleitung. Trage die Adresse, auf die sie zeigt, als Webhook-URL ein.
Ein Webhook zeigt Not attached to any listEr erhält automatisch nichts. Verknüpfe ihn in den Einstellungen einer Liste unter Advanced settings → Send leads to a webhook.
„This address still contains the hidden part (•••)“Die Tabelle blendet das Secret einer URL aus. Klicke auf Replace URL und füge die vollständige URL ein, oder lass die URL unverändert.
Derselbe Lead kommt zweimal anEine Zustellung wurde wiederholt, oder der Lead wurde von Hand oder durch einen anderen Auslöser erneut gesendet. Vergleiche in Version 2 die id: dieselbe id ist eine Wiederholung, eine andere id eine neue Zustellung. Vergleiche in Version 1 die E-Mail oder die LinkedIn-URL des Leads.
Mein Endpunkt kann den Body nicht lesenVersion 1 sendet ein Array, das den Lead enthält; Version 2 sendet ein Objekt mit dem Lead unter data. Öffne den Webhook zum Bearbeiten und wähle das Payload format, das dein Endpunkt erwartet.
Ich kann auf einem Endpunkt neue Leads nicht von Antworten unterscheidenNutze Version 2 und lies den type (zum Beispiel lead.found oder lead.replied). Version 1 hat keinen Ereignistyp.
Die Zustellungen eines älteren Webhooks tragen keine SignaturDer Webhook zeigt Secret not yet viewed und liefert wie bisher aus. Wähle im Zeilenmenü Reveal secret once oder Rotate secret, oder ersetze seine URL. Von da an sind seine Zustellungen signiert. Siehe Webhook-Signaturen.
Ich habe das Signing Secret verloren, oder die Signatur passt nichtSiehe Webhook-Signaturen: Rotate secret liefert ein neues, und die Signatur wird über den rohen Body der Anfrage berechnet.
Ein Schlüssel wurde versehentlich geteiltWiderrufe ihn sofort und lege einen neuen an.
Der KI-Assistent kann keine Analytics-Zahlen lesenPrüfe, ob deine Rolle in Signalist Zugriff auf Analytics hat.
Der KI-Assistent kann einen Dashboard-Hinweis nicht ausblenden oder wiederherstellenPrüfe, ob deine Rolle Zugriff auf Listen hat, und lass den Assistenten zuerst deine Dashboard-Hinweise lesen, damit er einen Hinweis nutzt, den es gibt.
Der KI-Assistent kann aus einer Quelle keine Liste anlegenPrüfe, ob deine Rolle Zugriff auf Listen und auf diese Quelle hat und ob ein LinkedIn-Konto (für Sales-Navigator-Listen mit Sales Navigator) verbunden ist.
Der KI-Assistent kann die Leads einer Liste nicht zu einem Tracker hinzufügenPrüfe, ob die Liste höchstens 100 Leads hat, keine private Liste einer Kollegin oder eines Kollegen ist und ob hinter dem Tracker eine Liste steht.

Häufig gestellte Fragen

Kann ich einschränken, was ein API-Schlüssel darf?

Nein. Ein Schlüssel handelt für den ganzen Workspace. Lege pro System einen eigenen Schlüssel an, damit du jeden einzeln widerrufen kannst.

Wie tausche ich einen Schlüssel aus?

Lege einen neuen Schlüssel an, stelle dein System darauf um und widerrufe dann den alten.

Werden fehlgeschlagene Webhook-Zustellungen wiederholt?

Ja, bei vorübergehenden Fehlern bis zu fünfmal innerhalb von 24 Stunden. Danach wird der Lead nicht automatisch erneut gesendet. Eine Zustellung, die „Not sent“ ist, weil die URL auf einer privaten Adresse liegt, wird gar nicht wiederholt.

Wie sende ich Zustellungen erneut, die mein Empfänger verpasst hat?

Öffne die Seite Deliveries des Webhooks und nutze Redeliver all failed (N)… oder Redeliver date range… für einen bestimmten Zeitraum. Siehe „Zustellungen ansehen und erneut senden (Seite Deliveries)“ oben.

Zustellungen vor dem 15. Oktober 2026 wurden nicht aufgezeichnet. Du kannst sie daher auf dieser Seite weder sehen noch erneut senden. Um diese Leads noch einmal zu senden, wähle sie in der Liste aus und nutze Add to webhook. Das erzeugt neue Zustellungen mit neuen IDs, dein Empfänger sollte daher auf Duplikate prüfen.

Kann ein Webhook an einen Server in meinem eigenen Netzwerk senden?

Nein. Signalist sendet Webhooks nur an öffentliche Adressen. Eine URL auf localhost, einem privaten Netz oder einer Link-Local-Adresse wird beim Speichern abgelehnt, und die Zustellungen eines signierten Webhooks an so eine URL erscheinen als „Not sent“. Nutze eine öffentliche URL, zum Beispiel eine, die dein Gateway oder dein Tunnel bereitstellt.

Sind meine Webhook-Zustellungen signiert?

Ja, bei jedem neuen Webhook. Ein Webhook, der vor dem 14. Oktober 2026 angelegt wurde, liefert wie bisher unsigniert aus, bis du sein Signing Secret anzeigst oder rotierst oder seine URL änderst; danach ist er signiert. Dein Empfänger kann die Signatur prüfen, muss es aber nicht. Siehe Webhook-Signaturen.

Welches Payload-Format soll ich für einen neuen Webhook wählen?

Version 2, den Standard: Jede Zustellung nennt ihren Ereignistyp und trägt eine ID, mit der du Wiederholungen überspringen kannst. Wähle Version 1 nur, wenn dein Endpunkt darauf ausgelegt ist, ein Array von Lead-Zeilen zu lesen.

Ändern sich meine bestehenden Webhooks?

Nein, nicht, solange du sie nicht änderst. Ihr Payload bleibt, wie er ist: Webhooks, die es vor der Einführung der Payload-Formate gab, bleiben auf Version 1 und erhalten denselben Body wie bisher. Sie ändern sich nur, wenn du den Webhook zum Bearbeiten öffnest und Version 2 wählst. Sie werden außerdem weiter unsigniert ausgeliefert, wie bisher, bis du das Signing Secret anzeigst oder rotierst oder die URL änderst. Danach sind sie signiert und werden geprüft wie ein neuer Webhook, und das bleibt so.

Kann ich zu Version 1 zurückwechseln?

Ja. Öffne den Webhook zum Bearbeiten, wähle Version 1: list of leads (legacy) und bestätige. Die nächsten Zustellungen werden wieder als Array gesendet.

Warum sehe ich das Secret in der URL meines Webhooks nicht mehr?

Die Tabelle blendet es aus, damit es niemand lesen kann, der die Seite öffnet. Das Secret bleibt gespeichert und wird weiterhin für Zustellungen verwendet. Um es zu ändern, nutze Replace URL und füge die vollständige neue URL ein.

Kann der KI-Assistent Nachrichten senden?

Ja. Er kann in deinem Namen Nachrichten und LinkedIn-Einladungen senden und Kampagnen starten, mit denselben Schutzmechanismen: Vor jedem Versand und jedem Kampagnenstart fragt er dich um Bestätigung, eingereihte Nachrichten und Einladungen warten in einem Zeitfenster zum Rückgängigmachen, in dem du sie abbrechen kannst, und die täglichen Versandlimits des Absenders gelten. Um ihm den Zugriff jederzeit zu entziehen, trenne ihn unter Personal settings → Connected Accounts → Connected AI applications.

Kann der KI-Assistent einen Hinweis in meinem Dashboard ausblenden?

Ja. Er kann einen Hinweis ausblenden und wieder einblenden. Die meisten Ausblendungen gelten nur für dich; einige Hinweisarten (etwa zu wenige Credits oder ein CRM, das neu verbunden werden muss) betreffen den ganzen Workspace und sind dann für alle in deinem Unternehmen ausgeblendet. Der Hinweis auf zu wenige Credits kommt zurück, sobald das Dashboard das nächste Mal deine Credits prüft.

Startet der KI-Assistent den Lauf einer Liste, die er anlegt?

Nein. Eine über MCP angelegte Liste ist pausiert. Den ersten Lauf startest du in der App, die vorher die Einrichtung der Liste prüft.

Stimmen die Zahlen des Assistenten mit der Analytics-Seite überein?

Ja. Der Assistent liest dieselben Zahlen, die die Analytics-Seite zeigt. Frage nach denselben Listen, Kampagnen und demselben Zeitraum, um sie zu vergleichen.

API-Schlüssel und Webhooks sicher verwenden | Signalist