Intégration Help Scout n8nAutomatiser Help Scout avec n8n.

Ouvre une conversation dans une boîte et renvoie la conversation créée. C'est l'opération qui transforme un événement venu d'ailleurs en ticket exploitable par un agent.

• Mailbox Name or ID : la boîte dans laquelle la conversation est créée. À prendre dans la liste, ou à passer par expression sous la forme {{ $json.field }}.
• Status : active, closed ou pending.
• Subject : le sujet, la ligne que les agents lisent dans la file.
• Type : chat, email ou phone.
• Resolve Data : désactivé, la réponse ne contient que l'ID de la ressource ; activé, n8n résout les données automatiquement.

Supprime une conversation de Help Scout. Aucune étape de confirmation dans le nœud : ce qui arrive ici quitte la boîte.

• Conversation ID : la conversation à supprimer, en général reprise d'un nœud précédent avec {{ $json.field }}.

Récupère une conversation à partir de son identifiant, pour qu'un workflow qui ne connaît qu'un ID puisse travailler sur la fiche complète.

• Conversation ID : l'identifiant de la conversation à lire, souvent pris dans le payload du trigger avec {{ $json.field }}.

Liste les conversations. C'est le point de départ des workflows de reporting, parce que les filtres travaillent avant que les données n'entrent dans n8n.

• Return All : activé, n8n parcourt toutes les pages ; désactivé, il s'arrête à Limit.
• Modified Since : ne renvoie que les conversations modifiées après cette date, le garde-fou habituel d'une exécution planifiée.
• Status : active, all, closed, open, pending ou spam.
• Mailbox ID : restreint la liste à une boîte.
• Embed : réglé sur threads, charge les sous-entités avec la conversation.

Ajoute une fiche client dans Help Scout. Aucun champ n'est obligatoire, donc la forme de la fiche dépend entièrement de ce que tu décides d'envoyer.

• Emails : une collection où chaque entrée ajoute une adresse à la fiche.
• First Name : s'il est renseigné, il doit faire entre 1 et 40 caractères.
• Job Title : 60 caractères au maximum.
• Organization : l'entreprise à laquelle le contact appartient.
• Phones, Websites, Social Profiles, Chat Handles, Address : une collection chacun, remplie entrée par entrée.

Lit une fiche client et la transmet à la suite du workflow.

• Customer ID : l'identifiant de la fiche à lire, hérité en général du nœud précédent sous la forme {{ $json.field }}.

Renvoie une liste de clients, avec des filtres appliqués par l'API plutôt que par un nœud de filtrage placé plus loin.

• Return All : activé, toutes les pages de clients reviennent ; désactivé, l'exécution s'arrête à Limit.
• Query : la recherche avancée, pour ce que les filtres simples n'expriment pas.
• Mailbox ID : ne garde que les clients d'une boîte.
• Sort Field et Sort Order : l'ordre du résultat, par exemple modifiedAt en desc.

Renvoie les définitions de propriétés client du compte, c'est-à-dire les champs personnalisés configurés par un administrateur dans Help Scout, et non les valeurs stockées sur un contact. Aucun paramètre à remplir : tu poses le nœud et tu exécutes.

Modifie une fiche client existante. Seuls les champs remplis dans la collection partent, donc un workflow peut toucher un attribut sans réécrire tout le contact.

• Customer ID : la fiche à modifier, souvent passée en {{ $json.field }} depuis le nœud d'avant.
• Organization, Job Title, Location : les attributs qu'on rafraîchit le plus souvent depuis un autre outil.
• Notes : le texte libre de contexte sur le contact.
• Photo Url : l'URL de la photo du client.

Renvoie les données d'une boîte. Pratique quand un workflow ne tient qu'un identifiant et doit décrire la boîte dans un message destiné à un humain.

• Mailbox ID : la boîte à lire, saisie directement ou construite par expression.

Liste les boîtes du compte. C'est l'opération la plus simple du nœud, et donc le premier test naturel après l'enregistrement d'un credential.

• Return All : activé, toutes les boîtes reviennent ; désactivé, le nœud s'arrête à Limit.

Ajoute un message à une conversation existante. C'est l'opération qui écrit le contenu, là où conversation.create ne fait qu'ouvrir le contenant.

• Conversation ID : la conversation à laquelle le thread s'ajoute.
• Type : chat, customer, note, phone ou reply. Ce choix décide si le message se lit comme une note interne ou comme une réponse.
• Text : le texte du message.
• Attachments : une collection où chaque entrée porte FileName, Mime Type et Data, un flux encodé en Base64.

Renvoie les threads d'une conversation, donc l'échange lui-même et pas seulement l'en-tête du ticket.

• Conversation ID : la conversation dont tu veux les threads.
• Return All : activé pour tout l'échange, désactivé pour s'arrêter à Limit.