> ## 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

> Répondre aux mentions de posts et aux messages directs sur X

X permet à l'assistant de répondre quand quelqu'un mentionne le compte connecté dans un post, ou lui envoie un message direct. La réponse reste sur X, et le fil est gardé dans l'historique. Les images et les fichiers de ce canal ne sont pas reçus comme médias.

## Quand l'utiliser

Utilisez-le pour un identifiant public de support ou une boîte de messages directs sur X. Connecter un assistant veut dire que ces mentions et messages directs sont répondus avec ses consignes et ses outils, au lieu d'attendre dans la boîte X.

## Ce que l'assistant entend

L'assistant entend les mentions de posts et les messages directs du compte qui a autorisé l'application. X vérifie le webhook avec un défi CRC, et Famulor répond à ce contrôle. Abonnez `post.mention.create`, `dm.received` et `dm.sent`.

## Où trouver les clés

Le guide du fournisseur lié montre les écrans de ces clics. Suivez les clics ci-dessous avec ces images.

Créez un projet et une application sur [developer.x.com](https://developer.x.com). Sous **Keys and tokens**, copiez l'**API Key Secret**. C'est le champ **API Key Secret (consumer secret)** sur la carte Famulor. Activez aussi l'authentification utilisateur OAuth 2.0 avec les portées `tweet.read`, `tweet.write`, `users.read`, `dm.read`, `dm.write`, `like.write` et `offline.access`. Terminez la connexion du compte bot et gardez soit le jeton d'accès utilisateur, soit l'ID client avec le jeton de rafraîchissement. Le webhook lui-même s'enregistre dans la [console développeur X](https://console.x.com). Guide officiel : [Activity API](https://docs.x.com/x-api/activity/introduction).

## Le créer chez le fournisseur

1. Sur [developer.x.com](https://developer.x.com), créez un projet et une application.
2. Ouvrez **Keys and tokens** et copiez l'**API Key Secret**.
3. Activez OAuth 2.0 pour l'utilisateur bot avec les portées ci-dessus.
4. Terminez la connexion et copiez le jeton d'accès utilisateur, ou l'ID client et le jeton de rafraîchissement.
5. Facultatif : copiez l'ID utilisateur du bot et le @handle si vous les avez déjà. Famulor peut garder les deux sur la carte.

## Le connecter dans Famulor

Votre forfait inclut ce canal. Ouvrez **Settings → Channels**, choisissez la carte, nommez la connexion, sélectionnez un assistant et enregistrez. Les paramètres de conversation communs — délai de réponse (5 secondes par défaut) et délai d'inactivité (30 minutes par défaut) — sont décrits sur la page [canaux de messagerie](https://docs.famulor.io/fr/channels/messaging.md).

Sur la carte **X**, **API Key Secret (consumer secret)** est obligatoire. Collez aussi soit **OAuth 2.0 user access token**, soit à la fois **OAuth client ID (optional, managed refresh)** et **OAuth refresh token (optional)**. **Bot user ID (optional)** et **Bot @handle (optional)** peuvent rester vides.

## Pointer le fournisseur vers Famulor

1. Copiez l'URL de webhook Famulor depuis le menu de la connexion. Elle doit être en HTTPS public, sans port dans l'adresse.
2. Dans la [console développeur X](https://console.x.com), enregistrez cette URL comme webhook de l'Activity API. X envoie un défi CRC, et Famulor y répond.
3. Abonnez `post.mention.create`, `dm.received` et `dm.sent`. Le compte bot doit avoir autorisé l'application au préalable.
4. Une nouvelle mention ou un message direct apparaît dans l'historique.

## Historique

Ouvrez l'[historique](https://docs.famulor.io/fr/monitoring/history.md) et filtrez par **X**. Le fil, la réponse de l'assistant et l'analyse éventuelle y apparaissent. Vous pouvez mettre l'assistant en pause et répondre vous-même.

## API, MCP et ligne de commande

Créez cette connexion dans le tableau de bord. L'API publique et la ligne de commande ne peuvent pas transmettre chaque valeur demandée par cette carte, donc elles ne peuvent pas terminer cette configuration. La carte a besoin de l'API Key Secret, et un appel public de création n'accepte pas cette valeur.


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