Intégration Twist n8nAutomatiser Twist avec n8n.

L'archivage bascule le canal en état archivé au lieu de le supprimer. Les canaux archivés répondent toujours à Get many channels quand son filtre Archived est actif, et Unarchive a channel les remet dans la liste active.

• Channel ID : l'identifiant du canal à archiver, saisi à la main ou récupéré d'un nœud précédent avec {{ $json.field }}.

C'est l'opération qui ouvre une conversation par canal dans Twist. Tous les fils publiés ensuite viendront se rattacher au canal créé ici.

• Workspace Name or ID : l'espace de travail, choisi dans la liste que n8n charge ou passé en identifiant via une expression.
• Name : le nom du canal.
• Color : la couleur du canal, parmi les douze valeurs Twist, Blue, Teal Blue ou Salmon par exemple.
• User Names or IDs : les utilisateurs qui participeront au canal.

Delete retire le canal de l'espace de travail. Il lit le même identifiant unique que la voie d'archivage, et les deux se confondent vite dans une branche : vérifie laquelle le workflow appelle avant de le brancher sur un espace de travail réel.

• Channel ID : le canal à supprimer. Le champ est requis, n8n arrête le nœud s'il arrive vide.

Un canal en entrée, ses informations en sortie. C'est l'étape de lecture qu'un workflow exécute avant de décider quoi que ce soit, souvent pour confirmer qu'un canal existe encore avant d'écrire dedans.

• Channel ID : l'identifiant du canal à consulter.

La liste se fait au niveau de l'espace de travail : tu donnes l'espace, n8n renvoie ses canaux en items, prêts pour une boucle ou un filtre.

• Workspace Name or ID : l'espace de travail à lister, depuis la liste déroulante ou via une expression.
• Return All : activé, n8n enchaîne les pages de l'API jusqu'au dernier canal ; désactivé, il s'arrête à Limit.
• Limit : le nombre maximal de canaux renvoyés quand Return All est désactivé.
• Archived : ne renvoie que les conversations archivées.

Unarchive, c'est le chemin retour. Un canal archivé revient parmi les conversations actives, et le workflow qui l'avait sorti de la liste peut donc annuler son propre geste.

• Channel ID : le canal archivé à restaurer. Get many channels avec le filtre Archived reste la façon la plus simple de retrouver cet identifiant.

Update modifie un canal déjà en place. Renseigne uniquement les entrées qui changent sous Update Fields et laisse les autres de côté.

• Channel ID : le canal à modifier.
• Name : le nom du canal.
• Description : la description du canal.
• Color : la couleur du canal, de Grey à Yellow en passant par Berry Red.

Un commentaire répond dans un fil qui existe déjà. Le fil sert d'ancrage, le contenu porte le message, et les champs de mention désignent les utilisateurs nommés dedans.

• Thread ID : le fil auquel le commentaire est rattaché.
• Content : le contenu du commentaire.
• Direct Mention Names or IDs : les utilisateurs mentionnés directement, choisis dans la liste ou passés en identifiants.
• Send as Integration : afficher ou non l'intégration comme autrice du commentaire.

La suppression porte sur un commentaire précis, désigné par son propre identifiant et non par le fil qui l'héberge.

• Comment ID : le commentaire à supprimer, en général récupéré depuis Get many comments.

Lire un commentaire seul, c'est ce que fait un workflow quand un autre système a gardé l'identifiant et veut la version actuelle du texte.

• Comment ID : l'identifiant du commentaire à lire.

Tous les commentaires d'un fil reviennent en items, dans l'ordre demandé. C'est la matière première d'un résumé, d'un export ou d'une relecture.

• Thread ID : le fil dont on lit les commentaires.
• Return All : activé, toutes les pages de commentaires sont récupérées ; désactivé, le nœud s'arrête à Limit.
• Limit : le nombre maximal de commentaires renvoyés.
• Order By : ASC ou DESC.
• As IDs : ne renvoie que les identifiants des commentaires.

La modification remplace le texte d'un commentaire déjà publié, au lieu d'en ajouter un second en dessous.

• Comment ID : le commentaire à modifier.
• Content : le contenu du commentaire.
• Attachments : le nom de la propriété qui porte les données binaires, plusieurs séparées par des virgules.

La conversation est l'autre endroit où un workflow peut écrire, à côté des fils de canal. Cette opération y dépose un message.

• Workspace Name or ID : l'espace de travail qui héberge la conversation.
• Conversation Name or ID : la conversation visée, depuis la liste ou via une expression.
• Content : le contenu du nouveau message. Les mentions s'écrivent [Name](twist-mention://user_id) pour un utilisateur et [Group name](twist-group-mention://group_id) pour un groupe.
• Direct Mention Names or IDs : les utilisateurs mentionnés directement.

Un message quitte la conversation. Le nœud travaille à partir de l'identifiant du message, pas de celui de la conversation : la branche de suppression a donc besoin de l'identifiant capté à la publication.

• Message ID : l'identifiant du message de conversation à supprimer.

Récupérer un message de conversation donne au workflow l'état courant d'un texte écrit plus tôt, par une personne ou par une exécution précédente.

• Message ID : l'identifiant du message de conversation à lire.

Lire une conversation entière est un travail de pagination, piloté par Limit et par les deux index d'objet.

• Workspace Name or ID : l'espace de travail de la conversation.
• Conversation Name or ID : la conversation à lire.
• Limit : le nombre maximal de messages renvoyés.
• Order By : ASC ou DESC.
• Starting Object Index : limite les messages à partir de l'index d'objet indiqué.

Le texte d'un message de conversation se réécrit sur place, pièces jointes comprises.

• Conversation Message ID : le message à modifier.
• Content : le contenu du nouveau message, avec la même syntaxe de mention qu'à la création.
• Attachments : la propriété qui porte les données binaires, séparées par des virgules s'il y en a plusieurs.

Le fil, c'est là que démarre une discussion de canal. Trois champs sont requis, et ils reprennent ce qu'une personne taperait : où, à quel sujet, et le message lui-même.

• Channel ID : le canal dans lequel le fil s'ouvre.
• Title : le titre du nouveau fil, en dessous de 300 caractères.
• Content : le contenu du fil.
• Recipient Names or IDs : les utilisateurs rattachés au fil.

La suppression prend l'identifiant du fil, celui-là même que Create a thread produit et que Get many threads renvoie.

• Thread ID : le fil à supprimer.

Un fil, lu à la demande. Utile dès qu'un identifiant arrive d'ailleurs et que le workflow a besoin du fil derrière avant d'agir.

• Thread ID : l'identifiant du fil à lire.

Canal par canal, le nœud renvoie les fils en items, avec des filtres qui resserrent la fenêtre avant que la suite du workflow tourne.

• Channel ID : le canal dont on lit les fils.
• Return All : activé, toutes les pages reviennent ; désactivé, le nœud s'arrête à Limit.
• Limit : le nombre maximal de fils renvoyés.
• Filter By : attached_to_me, everyone ou is_starred.
• Newer Than : garde les fils plus récents que le temps Unix indiqué.

Le titre et le contenu se corrigent après publication, ce qui compte quand la première version sort d'un gabarit avec une mauvaise valeur dedans.

• Thread ID : le fil à modifier.
• Title : le titre du fil, sous 300 caractères.
• Content : le contenu du fil.
• Direct Mention Names or IDs : les utilisateurs mentionnés directement.