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. Abonnierepost.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 Scopestweet.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
- Lege unter developer.x.com ein Projekt und eine App an.
- Öffne Keys and tokens und kopiere das API Key Secret.
- Aktiviere OAuth 2.0 für den Bot-Benutzer mit den Scopes von oben.
- Schließe die Anmeldung ab und kopiere den User Access Token oder die Client-ID und den Refresh Token.
- 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
- Kopiere die Famulor-Webhook-URL aus dem Menü der Verbindung. Sie muss öffentliches HTTPS sein, ohne Port in der Adresse.
- Registriere diese URL in der X-Entwicklerkonsole als Activity-API-Webhook. X sendet eine CRC-Herausforderung, und Famulor beantwortet sie.
- Abonniere
post.mention.create,dm.receivedunddm.sent. Das Bot-Konto muss die App vorher freigegeben haben. - Eine neue Erwähnung oder Direktnachricht erscheint im Verlauf.