AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Social-Media-Webhooks: Kommentare, Erwähnungen und Nachrichten an einen Endpoint

easyCoexistence leitet Social-Media-Ereignisse sofort an Ihren eigenen HTTPS-Endpoint weiter: Kommentare, Erwähnungen und DMs von Instagram und Facebook sowie Kommentare von TikTok. Jedes Ereignis kommt in einem Envelope an, das das Ereignis des Netzwerks unverändert enthält und pro Konto mit X-EC-Signature signiert ist. Aktivieren Sie es pro Konto mit set_social_webhook_destination aus Claude oder ChatGPT oder über die Partner API. Auch Nachrichten einer WhatsApp-Nummer erreichen Ihren Server.

  • Kommentare, Erwähnungen und DMs, sobald sie eintreffen
  • Ein Envelope, pro Konto signiert
  • Einrichtung über Claude, ChatGPT oder die Partner API
Kostenlose Testphase starten

3 Tage lang keine Kosten. Jederzeit kündbar.

Nur offizielle APIsMCP für Claude und ChatGPTJede Verbindung 24/7 überwacht3 Tage kostenlos
1 attempt

Wie oft easyCoexistence jedes weitergeleitete Social-Media-Ereignis sendet; es behält keine Kopie, daher wird nichts später erneut gesendet.

Within 5 minutes

Wie schnell der comment.update-Webhook von TikTok meldet, dass ein Kommentar auf öffentlichen Videos eines eigenen Kontos erstellt, gelöscht oder in seiner Sichtbarkeit geändert wurde.

In comments

Wo Apps mit Instagram Login @Erwähnungen erhalten: innerhalb der Benachrichtigung des Kommentar-Webhooks, nicht als eigenes Feld.

3 events

Was die Push-Benachrichtigungen von YouTube für einen Kanal melden: einen neuen Upload, einen neuen Titel oder eine neue Beschreibung.

7 days

Wie lange Meta einen WhatsApp-Webhook wiederholt, den Ihr Server nicht angenommen hat, was zu Duplikaten führen kann.

Welche Ereignisse sendet jedes Netzwerk?

Instagram, Facebook und TikTok senden Ereignisse an easyCoexistence, das jedes an die URL weitergibt, die Sie für dieses Konto hinterlegt haben. Instagram sendet neue Kommentare, wobei @Erwähnungen innerhalb der Kommentar-Benachrichtigung eintreffen, sowie DMs. Eine Facebook-Seite sendet Feed-Aktivitäten, zu denen neue Kommentare gehören, außerdem Messenger-Nachrichten und Erwähnungen der Seite. TikTok sendet comment.update, ausgelöst, wenn ein Kommentar erstellt oder gelöscht wird oder seine Sichtbarkeit ändert.

YouTube und LinkedIn senden an easyCoexistence keine Kommentar- oder Nachrichtenereignisse, daher liest ein Agent deren Kommentare auf Anfrage. Eine WhatsApp-Nummer läuft über einen eigenen Weg: Meta liefert ihre Nachrichten direkt an Ihren Server, oder easyCoexistence leitet sie signiert weiter, wenn die Nummer im verwalteten Modus läuft.

What arrivesSent by
InstagramComments, mentions and DMseasyCoexistence, signed per account
FacebookFeed activity, Messenger and mentionseasyCoexistence, signed per account
TikTokcomment.update eventseasyCoexistence, signed per account
WhatsAppMessages and echoes from the appMeta directly, or easyCoexistence in managed mode
YouTubeNo comment eventsRead with list_youtube_comments
LinkedInNo comment eventsRead with list_linkedin_comments

Wie sieht ein weitergeleitetes Ereignis aus?

Auf jedem Netzwerk dasselbe JSON-Envelope, gesendet mit Content-Type application/json: platform, das Netzwerk; account_id, die ID, die die MCP-Tools und die Partner API verwenden; external_id, die ID des Kontos im Netzwerk; und entry, das Ereignis des Netzwerks, so wie es eintraf. Bei Instagram und Facebook ist entry der Webhook-Eintrag von Meta, mit changes für Kommentare und Erwähnungen und messaging für DMs. Bei TikTok enthält es das comment.update-Ereignis mit comment_id, video_id und parent_comment_id als Strings, damit 64-Bit-IDs nicht gerundet werden. Eine Messenger-Nachricht kommt so an:

A forwarded Messenger message, trimmed
{
  "platform": "facebook",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<PAGE_ID>",
  "entry": {
    "id": "<PAGE_ID>",
    "time": 1793318400512,
    "messaging": [
      {
        "sender": { "id": "<PAGE_SCOPED_ID>" },
        "recipient": { "id": "<PAGE_ID>" },
        "timestamp": 1793318399870,
        "message": { "mid": "<MESSAGE_ID>", "text": "Are you open on Sunday?" }
      }
    ]
  }
}

Wie prüfen Sie X-EC-Signature?

Mit dem Signing-Secret, das Sie beim Festlegen der Ziel-URL erhalten, eindeutig für dieses Konto und nur einmal angezeigt. Der Header lautet t=<unix>,v1=<hex>; v1 ist ein HMAC-SHA256 aus dem Zeitstempel, einem Punkt und dem rohen Request-Body, berechnet mit diesem Secret. Lesen Sie den Body als Bytes, bevor Sie ihn parsen, lehnen Sie einen Zeitstempel ab, der mehr als 5 Minuten von Ihrer Uhr abweicht, suchen Sie das Secret anhand der account_id des Ereignisses und vergleichen Sie beide Digests in konstanter Zeit. Antworten Sie dann mit 2xx und stellen Sie die Verarbeitung in eine Warteschlange. In PHP sind dafür wenige Zeilen nötig:

PHP: verifying a forwarded event
<?php
// POST /hooks/social: one endpoint for the events of each account
$raw = file_get_contents('php://input');          // the exact bytes that were signed
parse_str(str_replace(',', '&', $_SERVER['HTTP_X_EC_SIGNATURE'] ?? ''), $sig);
$event = json_decode($raw, true);                  // platform, account_id, external_id, entry
$secret = secret_for($event['account_id'] ?? '');  // the signing_secret stored for that account

$fresh = ctype_digit($sig['t'] ?? '') && abs(time() - (int) $sig['t']) <= 300;
$expected = hash_hmac('sha256', ($sig['t'] ?? '') . '.' . $raw, (string) $secret);
if (!$secret || !$fresh || !hash_equals($expected, $sig['v1'] ?? '')) {
    http_response_code(401);
    exit;
}

http_response_code(204);
enqueue($event); // keep this quick: the forward waits 8 seconds and is never resent

Wie aktivieren Sie die Weiterleitung für ein Konto?

Aus einem KI-Assistenten oder aus Ihrem Backend. Bitten Sie Claude oder ChatGPT, set_social_webhook_destination mit dem Konto und Ihrer HTTPS-URL auszuführen, oder rufen Sie PUT /api/v1/channels/:id/webhook der Partner API mit Ihrem ec_live_-Schlüssel und einem Body mit der url auf. Beide geben das signing_secret des Kontos einmal zurück. Speichern Sie es sofort zusammen mit der account_id. Ein erneuter Aufruf stellt ein neues Secret aus, und eine url von null schaltet die Weiterleitung ab.

Die URL muss HTTPS auf einem öffentlichen Host sein: Eine private Adresse wird beim Setzen und erneut bei der Zustellung abgelehnt. Ein Endpoint kann viele Konten bedienen, da jedes Ereignis seine account_id nennt. Für eine WhatsApp-Nummer leitet set_webhook_destination die Zustellungen von Meta an Sie weiter, und set_inbound_mode mit einer forward_url leitet sie stattdessen signiert weiter.

Was passiert, wenn Ihr Endpoint langsam ist oder ausfällt?

Das Ereignis wird nicht erneut gesendet. easyCoexistence unternimmt einen Versuch, wartet bis zu 8 Sekunden auf eine Antwort, folgt keinen Weiterleitungen und behält keine Kopie, denn ein Wiederholen würde bedeuten, Kommentare und Nachrichten Ihrer Kunden zu speichern. Antworten Sie mit 2xx, sobald die Signatur geprüft ist, erledigen Sie langsame Arbeit aus einer Warteschlange und deduplizieren Sie anhand der IDs des Netzwerks, etwa einer Kommentar-ID oder einer Nachrichten-mid, falls ein Ereignis zweimal eintrifft.

WhatsApp ist anders. Im Direktmodus wiederholt Meta eine Zustellung, die Ihr Server nicht angenommen hat, bis zu 7 Tage lang. Im verwalteten Modus stellt easyCoexistence Nachrichten für Ihre Forward-URL in eine Warteschlange und wiederholt mit Backoff. Partner-Statusereignisse, etwa wenn eine Verbindung abbricht, werden etwa 33 Stunden lang wiederholt.

Wie erreichen YouTube- und LinkedIn-Kommentare einen Agenten?

Indem er sie nach einem Zeitplan liest. Die Push-Benachrichtigungen von YouTube melden einen neuen Upload, einen neuen Titel oder eine neue Beschreibung, keine Kommentare, und easyCoexistence erhält von LinkedIn keine Kommentarereignisse, daher leitet keiner von beiden etwas weiter. Stattdessen prüft der Agent: list_youtube_comments liefert die Threads eines Videos oder des gesamten Kanals, einschließlich der zur Prüfung zurückgehaltenen, und list_linkedin_comments liefert die Kommentare eines Beitrags oder die Antworten unter einem Kommentar. In n8n, Make oder Zapier startet ein Zeitplan-Trigger die Prüfung. In eigenem Code ruft ein Cron-Job die Zugangsdaten des Kanals ab und fragt direkt den commentThreads-Endpoint von YouTube bzw. den comments-Endpoint von LinkedIn ab.

So richten Sie es ein

  1. Set the destinationRun set_social_webhook_destination with the account and an HTTPS URL, or call PUT /api/v1/channels/:id/webhook with your ec_live_ key.
  2. Store the secretSave the signing_secret from the response against that account_id, since it is shown only once.
  3. Verify each deliveryCheck that the timestamp is fresh and that v1 matches an HMAC-SHA256 of the timestamp, a dot and the raw body.
  4. Acknowledge, then workAnswer 2xx straight away and hand the event to a queue, because easyCoexistence sends it only once.

Häufige Fehler

  • Die HMAC über geparstes JSON prüfen. Die Signatur deckt den rohen Body Byte für Byte ab, und ein erneutes Serialisieren des geparsten Objekts ändert diese Bytes. Prüfen Sie daher, bevor Sie parsen.
  • Ein Secret für alle Konten verwenden. Jedes Konto signiert mit seinem eigenen Secret, also suchen Sie es anhand der account_id des Ereignisses, bevor Sie v1 vergleichen.
  • Das Ziel erneut setzen, ohne Ihren Endpoint anzupassen. Jeder Aufruf stellt ein neues Secret aus, und das alte signiert sofort nicht mehr, also speichern Sie das neue direkt.
  • Eine URL angeben, die weiterleitet. Weiterleitungen werden nicht gefolgt, daher geht ein Ereignis bei einem Wechsel zu einem neuen Pfad oder Host verloren. Setzen Sie die endgültige Adresse.
Mit EasyCoexistence

easyCoexistence sendet Kommentare, Erwähnungen und DMs von Instagram und Facebook sowie Kommentare von TikTok sofort an Ihren Endpoint, pro Konto signiert, und leitet WhatsApp-Nachrichten an Ihren Server weiter, damit Ihre KI-Agenten Nachrichten von Kunden über die offiziellen APIs jedes Netzwerks erhalten. Jede Verbindung wird rund um die Uhr überwacht. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.

Häufig gestellte Fragen

Wie gelangen Nachrichten einer WhatsApp-Nummer an meinen Endpoint?

Auf zwei Wegen. set_webhook_destination lässt Meta sie direkt an Ihren Server zustellen, während set_inbound_mode mit einer forward_url veranlasst, dass easyCoexistence sie signiert mit X-EC-Signature weiterleitet, mit Wiederholungen per Backoff.

Kann dasselbe Ereignis zweimal eintreffen?

Ja, daher deduplizieren Sie anhand der IDs des Netzwerks, etwa einer Kommentar-ID oder einer Nachrichten-mid. Auch Metas Wiederholungen einer WhatsApp-Zustellung, die Ihr Server nicht angenommen hat, bis zu 7 Tage lang, können Duplikate bringen.

Kann ein Endpoint Ereignisse mehrerer Konten empfangen?

Ja. Jedes Ereignis trägt platform und account_id, daher kann eine URL viele Konten bedienen, solange sie jede Signatur mit dem eigenen Secret des jeweiligen Kontos prüft.

Was kostet easyCoexistence für Social-Media-Webhooks?

US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung und auf jedem Netzwerk gleich. Weiterleitung, der MCP-Server und die Partner API sind enthalten, mit einer kostenlosen Testphase von 3 Tagen.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am