Webhooks

Erhalten Sie bei jedem Ereignis in einem Projekt eine signierte HTTP-POST-Anfrage, ganz ohne regelmäßige Abfragen. Webhooks sind die Grundlage der Connectors von LLM Pulse für Zapier, Make und n8n und funktionieren mit jedem eigenen Backend. Verfügbar ab Tarif Scale.

Ereignistypen: mention.created, competitor_mention.created, citation.created, prompt_execution.completed, sentiment.negative_detected (negatives oder sehr negatives Sentiment zur Marke), recommendation.completed, intelligence_task.completed, intelligence_task.updated (eine abgeschlossene Aufgabe im GEO Writer wurde manuell bearbeitet oder auf die KI-Version zurückgesetzt).
Sicherheit: Jede Zustellung enthält X-LLMPulse-Event, X-LLMPulse-Delivery (eindeutige ID) und X-LLMPulse-Signature (sha256=<hex>, HMAC-SHA256 des unveränderten Anfragetexts, berechnet mit dem Signaturschlüssel des Abonnements). Prüfen Sie die Signatur, um die Echtheit der Zustellungen sicherzustellen.
Zustellung: Eine Antwort mit einem 2xx-Statuscode bestätigt das Ereignis. Andernfalls wird die Zustellung mit exponentiell wachsenden Wartezeiten insgesamt bis zu 5-mal versucht (einschließlich des ersten Versuchs). Abonnements werden nach 20 fehlgeschlagenen Zustellungen in Folge automatisch deaktiviert.

POST`/webhooks`

Erstellt ein Abonnement. Idempotent: Wenn Sie dasselbe Projekt, dasselbe Ereignis und dieselbe URL erneut senden, wird das bestehende Abonnement zurückgegeben, es sei denn, der API-Schlüssel oder die OAuth-Verbindung, über die es erstellt wurde, ist inzwischen widerrufen. In diesem Fall wird es durch ein neues Abonnement mit einem neuen Signaturschlüssel ersetzt. Der Signaturschlüssel (whsec_...) wird nur von diesem Endpunkt zurückgegeben. Speichern Sie ihn, um die Signaturen der Zustellungen zu prüfen. Erfordert einen Schlüssel mit dem Zugriffsumfang read_write.

Anfragetext (JSON):

project_iderforderlich
event_typeerforderlich, siehe Ereignistypen oben
target_urlerforderlich, öffentliche HTTPS-URL; private IP-Adressen, localhost und interne Hostnamen werden abgelehnt

Maximal 100 aktive Abonnements pro Konto.

GET`/webhooks`

Listet die aktiven Abonnements des Kontos auf. Die Einträge entsprechen der Antwort beim Erstellen, ohne den Signaturschlüssel. Bei einem API-Schlüssel mit Lesezugriff wird jede target_url auf Schema, Host und einen gegebenenfalls vom Standard abweichenden Port gekürzt, gefolgt von /…, weil mit der vollständigen URL Dritte Anfragen an den Empfänger senden könnten. Ein Schlüssel mit dem Zugriffsumfang read_write erhält die vollständige URL.

Parameter:

project_idoptionaler Filter
page
per_pagemaximal 100

DELETE`/webhooks/:id`

Löscht ein Abonnement. Die Ziel-URL erhält ab sofort keine Ereignisse mehr. Erfordert einen Schlüssel mit dem Zugriffsumfang read_write.

Pfad:

:idID des Abonnements

Gibt ERR_NOT_FOUND zurück, wenn das Abonnement nicht zum Konto gehört.

GET`/webhooks/sample/:event_type`

Bis zu 3 Beispiel-Payloads für den Ereignistyp, erstellt aus den neuesten echten Daten des Projekts (oder ein statisches Beispiel, wenn das Projekt noch keine Daten hat). Integrationseditoren nutzen sie, etwa beim Laden von Beispieldaten in Zapier. Auch als MCP-Tool get_webhook_sample verfügbar.

Parameter:

:event_typePfad
project_iderforderlich

Codebeispiele

Download: OpenAPI Swagger Postman

KI fragen: In ChatGPT öffnen In Claude öffnen Als Markdown anzeigen

Sprache

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","event_type":"mention.created","target_url":"https://example.com/webhooks/llmpulse"}' \
  "https://api.llmpulse.ai/api/v1/webhooks"

const response = await fetch("https://api.llmpulse.ai/api/v1/webhooks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","event_type":"mention.created","target_url":"https://example.com/webhooks/llmpulse"})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/webhooks",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id": "PROJECT_ID", "event_type": "mention.created", "target_url": "https://example.com/webhooks/llmpulse"}
)
data = response.json()

require 'httparty'
require 'json'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/webhooks",
  headers: {
    "Authorization" => "Bearer YOUR_API_KEY",
    "Content-Type" => "application/json"
  },
  body: { "project_id" => "PROJECT_ID", "event_type" => "mention.created", "target_url" => "https://example.com/webhooks/llmpulse" }.to_json
)
data = response.parsed_response

package main

import (
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/webhooks", strings.NewReader(`{"project_id":"PROJECT_ID","event_type":"mention.created","target_url":"https://example.com/webhooks/llmpulse"}`))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('POST', 'https://api.llmpulse.ai/api/v1/webhooks', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => ['project_id' => 'PROJECT_ID', 'event_type' => 'mention.created', 'target_url' => 'https://example.com/webhooks/llmpulse']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/webhooks"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"event_type\":\"mention.created\",\"target_url\":\"https://example.com/webhooks/llmpulse\"}"))
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/webhooks?project_id=PROJECT_ID"

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/webhooks?project_id=PROJECT_ID",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

package main

import "net/http"

func main() {
	req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/webhooks?project_id=PROJECT_ID", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/webhooks?project_id=PROJECT_ID', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/webhooks?project_id=PROJECT_ID"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Request

curl -X DELETE -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/webhooks/123"

const response = await fetch("https://api.llmpulse.ai/api/v1/webhooks/123", {
  method: "DELETE",
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

package main

import "net/http"

func main() {
	req, _ := http.NewRequest("DELETE", "https://api.llmpulse.ai/api/v1/webhooks/123", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('DELETE', 'https://api.llmpulse.ai/api/v1/webhooks/123', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/webhooks/123"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .DELETE()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/webhooks/sample/mention.created?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/webhooks/sample/mention.created?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/webhooks/sample/mention.created?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/webhooks/sample/mention.created?project_id=PROJECT_ID",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

package main

import "net/http"

func main() {
	req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/webhooks/sample/mention.created?project_id=PROJECT_ID", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/webhooks/sample/mention.created?project_id=PROJECT_ID', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/webhooks/sample/mention.created?project_id=PROJECT_ID"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Webhooks

POST/webhooks

GET/webhooks

DELETE/webhooks/:id

GET/webhooks/sample/:event_type

POST`/webhooks`

GET`/webhooks`

DELETE`/webhooks/:id`

GET`/webhooks/sample/:event_type`