Intégration Twitter / X

Mis à jour le 4 nov. 20266 min de lecture

Français

Sur cette page

Connectez votre compte Twitter/X pour traiter les messages privés depuis Deskwoot. Créez une app dans le X Developer Portal, collez ses clés dans Deskwoot et enregistrez l'URL du webhook. Les messages privés reçus arrivent sous forme de conversations ; les agents répondent depuis Deskwoot et le client reçoit la réponse sur Twitter. Les mentions publiques et les tweets ne sont PAS synchronisés (l'intégration ne gère que les messages privés). C'est utile pour les marques dont les clients préfèrent X pour demander de l'aide.

L'intégration Twitter (X) de Deskwoot fait arriver les messages privés dans votre boîte de réception partagée : la même équipe répond aux messages privés X en plus des e-mails et du chat, sans jamais ouvrir twitter.com. Au lieu de passer d'une plateforme à l'autre, votre équipe peut répondre aux messages privés des clients directement depuis Deskwoot. Les conversations restent bien rangées et les délais de réponse restent courts.

Connecter votre compte Twitter (X) à Deskwoot

Suivez ces étapes pour relier votre compte Twitter :

Dans le X Developer Portal, ouvrez votre app et allez dans Keys and tokens. Il vous faut l'API Key et l'API Secret, un Access Token et un Access Token Secret, ainsi que le Bearer Token.
Dans Deskwoot, allez dans Paramètres > Boîtes de réception > Ajouter une boîte de réception.
Choisissez X dans la liste des canaux disponibles.
Saisissez un Nom de la boîte de réception et remplissez Clé API, Secret d'API, Jeton d'accès, Secret du jeton d'accès, Bearer Token et Votre ID utilisateur X (l'ID numérique du compte X qui reçoit les messages privés).
Cliquez sur Créer la boîte de réception.
Ouvrez l'onglet Configuration de la boîte de réception, copiez l'URL du webhook et indiquez-la comme URL du webhook Account Activity dans le X Developer Portal. Les messages privés envoyés à votre compte X arrivent maintenant dans cette boîte de réception.

Comment ça marche

Quand quelqu'un envoie un message privé à votre compte Twitter connecté, il apparaît automatiquement comme une nouvelle conversation dans Deskwoot. Votre équipe peut alors répondre, attribuer la conversation à des agents précis, ajouter des notes internes et utiliser toutes les fonctionnalités habituelles de la boîte de réception Deskwoot. Exactement comme avec n'importe quel autre canal.

Dépannage et erreurs fréquentes

Aucun message n'arrive : Vérifiez que l'URL du webhook de l'onglet Configuration de la boîte de réception est bien indiquée comme URL du webhook Account Activity dans le X Developer Portal, et que Votre ID utilisateur X est l'ID numérique du compte qui reçoit les messages privés.
Certains messages manquent : Vérifiez que le message de l'expéditeur est bien un message privé, car les mentions et les réponses publiques n'arrivent pas dans la boîte de réception.
Compte déconnecté : Twitter peut retirer l'accès de l'app si vous changez votre mot de passe ou modifiez les autorisations de l'app du côté de Twitter. Dans ce cas, générez de nouvelles clés et de nouveaux jetons dans le X Developer Portal, supprimez la boîte de réception dans Deskwoot et connectez-la de nouveau avec les étapes ci-dessus. Les clés d'une boîte de réception existante ne peuvent pas être modifiées.

Bonnes pratiques

Acceptez les messages privés de tout le monde : Dans les paramètres de votre compte Twitter, autorisez les messages privés de tous les utilisateurs (pas seulement de vos abonnés), pour que les clients puissent vous écrire sans devoir d'abord suivre votre compte.
Utilisez des règles d'attribution : Configurez l'attribution par équipe ou la répartition Round Robin dans Deskwoot pour que les bons agents traitent vite les messages privés Twitter.
Faites des réponses courtes : Les messages privés Twitter acceptent des textes plus longs que les tweets, mais les clients sur cette plateforme attendent en général des réponses rapides et directes.

Questions fréquentes

Les tweets publics sont-ils importés ?

Non, seulement les messages privés. Mentions publiques, réponses et retweets : rien de tout cela n'est synchronisé. Si vous devez suivre les mentions publiques, utilisez un autre outil comme Brand24 ou Mention.

Puis-je envoyer un message privé Twitter à quelqu'un qui ne m'a pas écrit ?

Non. Le bouton pour rédiger un nouveau message dans Deskwoot ne propose pas X, vous ne pouvez donc pas lancer un nouveau message privé depuis Deskwoot. Vous répondez aux messages privés que les clients vous envoient.

Que se passe-t-il si mon accès à Twitter est révoqué ?

Cela arrive quand vous changez votre mot de passe X ou révoquez les autorisations de l'app. La boîte de réception cesse de fonctionner. Paramètres → Boîtes de réception → supprimez la boîte de réception en panne et créez une nouvelle boîte de réception X avec de nouvelles clés du X Developer Portal.

Puis-je connecter plusieurs comptes Twitter ?

Oui. Chaque compte Twitter devient une boîte de réception à part. C'est utile pour les entreprises avec plusieurs marques qui ont un compte X différent par marque.

Le bot répond-il aux messages privés Twitter ?

Oui, dès que vous l'activez. Fynn répond aux messages privés X comme sur n'importe quel autre canal : il détecte la langue et répond à partir de vos sources de connaissances. Au-dessus de sa première réponse, les clients voient une ligne comme « Fynn, l'assistant IA d'Acme ». C'est utile en dehors de vos horaires de travail, quand les messages privés devraient sinon attendre.

Et les médias dans les messages privés ?

Le texte des messages privés reçus s'affiche dans la conversation. Les images et les vidéos d'un message privé ne s'affichent pas ; un message privé qui ne contient que des médias apparaît sous forme d'un court texte de remplacement. Les fichiers que vous joignez à une réponse sont envoyés sous forme de lien de téléchargement dans le texte du message privé, valable 7 jours.

Les messages privés ont-ils une longueur maximale ?

Oui, 10,000 caractères par message privé (bien plus que les 280 d'un tweet). De toute façon, la plupart des équipes écrivent des messages privés courts, car les clients attendent des réponses rapides dans le style de X.

L'intégration utilise-t-elle l'API Twitter v1 ou v2 ?

Les réponses partent par la X API v2. Les messages privés reçus arrivent dans Deskwoot par le webhook de l'Account Activity API que vous configurez dans le X Developer Portal.

Les réponses des clients aux réponses du bot reviennent-elles dans Deskwoot ?

Oui. Le fil du message privé est conservé ; les messages suivants du client arrivent dans la même conversation dans Deskwoot. Le bot ou un agent peut prendre le tour suivant.

Que se passe-t-il si Twitter (X) limite encore plus l'accès gratuit à l'API ?

Selon les changements des niveaux d'API de Twitter, certaines fonctionnalités peuvent demander un compte Twitter Developer payant. Nous mettons à jour le guide de l'intégration quand les règles changent ; consultez le centre d'aide pour les dernières infos.

Puis-je voir des statistiques sur les messages privés dans Rapports ?

Oui. Dans Rapports, cliquez sur + Filtre, choisissez Boîte de réception et sélectionnez votre boîte de réception X. Le tableau compte alors uniquement les conversations de cette boîte de réception. Voir Rapports : les réponses et les chiffres sur lesquels elles reposent.

Que se passe-t-il si je déconnecte la boîte de réception Twitter ?

Les conversations existantes restent dans Deskwoot pour consultation, mais aucun nouveau message privé n'arrivera. Vous pouvez connecter de nouveau le compte à tout moment, comme une nouvelle boîte de réception.

Ce guide vous a-t-il aidé ?

Continuer la lecture

Demander à Fynn à propos de ce guide

Obtenez une réponse courte tirée de ce guide et du reste du centre d'aide.