> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# X

> Auf Beitrag-Erwähnungen und Direktnachrichten auf X antworten

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](https://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](https://console.x.com). Offizielle Anleitung: [Activity API](https://docs.x.com/x-api/activity/introduction).

## Beim Anbieter anlegen

1. Lege unter [developer.x.com](https://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](https://docs.famulor.io/de/channels/messaging.md).

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](https://console.x.com) 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](https://docs.famulor.io/de/monitoring/history.md) 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.