Zum Hauptinhalt springen
X lässt den Assistenten antworten, wenn jemand das verbundene Konto in einem Beitrag erwähnt oder ihm eine Direktnachricht schickt. Die Antwort bleibt auf X, und der Thread liegt im Verlauf. Bilder und Dateien kommen auf diesem Kanal nicht als Medien an.

Wann du ihn nutzt

Nutze ihn für einen öffentlichen Support-Handle oder ein Direktnachrichten-Postfach auf X. Einen Assistenten zu verbinden heißt, dass diese Erwähnungen und Direktnachrichten mit seinen Anweisungen und Werkzeugen beantwortet werden, statt im X-Postfach zu warten.

Was der Assistent hört

Der Assistent hört Beitrag-Erwähnungen und Direktnachrichten für das Konto, das die App freigegeben hat. X prüft den Webhook mit einer CRC-Herausforderung, und Famulor beantwortet diese Prüfung. Abonniere post.mention.create, dm.received und dm.sent.

Woher die Schlüssel kommen

Die verlinkte Anbieter-Anleitung zeigt die Bildschirme zu diesen Klicks. Folge den Klicks unten zusammen mit diesen Bildern. Lege ein Projekt und eine App unter developer.x.com an. Kopiere unter Keys and tokens das API Key Secret. Das ist auf der Famulor-Karte API Key Secret (consumer secret). Schalte außerdem die OAuth-2.0-Benutzeranmeldung mit den Scopes tweet.read, tweet.write, users.read, dm.read, dm.write, like.write und offline.access ein. Schließe die Anmeldung für das Bot-Konto ab und behalte entweder den User Access Token oder die Client-ID zusammen mit dem Refresh Token. Den Webhook selbst registrierst du in der X-Entwicklerkonsole. Offizielle Anleitung: Activity API.

Beim Anbieter anlegen

  1. Lege unter developer.x.com ein Projekt und eine App an.
  2. Öffne Keys and tokens und kopiere das API Key Secret.
  3. Aktiviere OAuth 2.0 für den Bot-Benutzer mit den Scopes von oben.
  4. Schließe die Anmeldung ab und kopiere den User Access Token oder die Client-ID und den Refresh Token.
  5. Optional: kopiere die Bot-Benutzer-ID und den @Handle, wenn du sie schon hast. Famulor kann beides an der Karte speichern.

In Famulor verbinden

Dein Plan enthält diesen Kanal. Öffne Settings → Channels, wähle die Karte, benenne die Verbindung, wähle einen Assistenten und speichere. Die gemeinsamen Konversationseinstellungen — Antwortverzögerung (Standard 5 Sekunden) und Inaktivitätszeit (Standard 30 Minuten) — stehen auf der Seite Messaging-Kanäle. Auf der Karte X ist API Key Secret (consumer secret) Pflicht. Füge außerdem entweder OAuth 2.0 user access token ein oder sowohl OAuth client ID (optional, managed refresh) als auch OAuth refresh token (optional). Bot user ID (optional) und Bot @handle (optional) können leer bleiben.

Den Anbieter auf Famulor zeigen lassen

  1. Kopiere die Famulor-Webhook-URL aus dem Menü der Verbindung. Sie muss öffentliches HTTPS sein, ohne Port in der Adresse.
  2. Registriere diese URL in der X-Entwicklerkonsole als Activity-API-Webhook. X sendet eine CRC-Herausforderung, und Famulor beantwortet sie.
  3. Abonniere post.mention.create, dm.received und dm.sent. Das Bot-Konto muss die App vorher freigegeben haben.
  4. Eine neue Erwähnung oder Direktnachricht erscheint im Verlauf.

Verlauf

Öffne den Verlauf und filtere nach X. Der Thread, die Antwort des Assistenten und eine vorhandene Auswertung erscheinen dort. Du kannst den Assistenten pausieren und selbst antworten.

API, MCP und Kommandozeile

Lege diese Verbindung im Dashboard an. Die öffentliche API und die Kommandozeile können nicht jeden Wert übergeben, den diese Karte verlangt, und können dieses Setup deshalb nicht abschließen. Die Karte braucht das API Key Secret, und ein öffentlicher Create-Aufruf nimmt diesen Wert nicht an.