Collega la tua IA a Help Scout

Cosa può fare la tua IA con Help Scout

Una volta collegato, questi strumenti compaiono automaticamente nel tuo assistente IA:

• list_mailboxessola lettura

  Elencate le caselle di posta dell account.

• list_conversationssola lettura

  Elencate le conversazioni, eventualmente filtrate per casella e per stato.

• get_conversationsola lettura

  Ottenete una conversazione con i suoi thread (messaggi).

• list_conversation_threadssola lettura

  Elencate i thread di una conversazione a parte, paginati — ciò che ha scritto il cliente, ciò che hanno risposto gli agenti, e le note interne. Preferite questo strumento a get_conversation quando un lungo scambio va letto oltre la prima pagina.

• search_conversationssola lettura

  Cercate conversazioni per contenuto, oggetto, cliente o tag, con la sintassi di ricerca di Help Scout — per esempio subject:"rimborso" o tag:urgente.

• add_notescrittura · richiede approvazione

  Aggiungete una nota interna a una conversazione. La vede solo il team, nulla raggiunge il cliente. È il modo sicuro per un IA di lasciare una sintesi o una constatazione su un ticket. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• reply_to_conversationscrittura · richiede approvazione

  Scrivete una risposta al cliente. Viene creata come BOZZA per impostazione predefinita, in attesa in Help Scout che un umano la rilegga e la invii — perché una risposta pubblicata parte subito via email e non si recupera. Passate draft: false solo se l invio immediato è stato richiesto. Per qualcosa che deve vedere solo il team, usate add_note. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• schedule_replyscrittura · richiede approvazione

  Programmate l invio differito di una bozza di risposta esistente. Si applica alla bozza creata da reply_to_conversation — riprendete il suo identificatore dal risultato. Una nuova programmazione sostituisce la precedente. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• create_conversationscrittura · richiede approvazione

  Aprite una conversazione in una casella con un primo messaggio — registrare una telefonata, annotare ciò che un cliente ha detto altrove. La creazione non invia email al cliente se autoReply non è richiesto. Per uno storico ripreso da un altro strumento, attivate imported: Help Scout non genera allora né email né notifica. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• update_conversationscrittura · richiede approvazione

  Cambiate oggetto, stato, proprietario o casella di una conversazione. Assegnatela a una persona o a un team con assignTo, o rimettetela in coda con unassign. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• set_conversation_tagsscrittura · richiede approvazione

  Definite i tag di una conversazione. ATTENZIONE, QUESTO SOSTITUISCE TUTTO: ogni tag assente dall elenco viene rimosso, e un elenco vuoto li cancella tutti. Non esiste modo di aggiungere un solo tag — leggete prima i tag attuali con get_conversation, poi rinviateli insieme a quello nuovo. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• list_customerssola lettura

  Elencate o cercate clienti, per email, per nome o per organizzazione.

• get_customersola lettura

  Ottenete la scheda di un cliente, con le sue email, i telefoni e la sua organizzazione.

• create_customerscrittura · richiede approvazione

  Create una scheda cliente. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• update_customerscrittura · richiede approvazione

  Aggiornate i campi di una scheda cliente. Viene modificato solo ciò che passate, il resto resta invariato. Email e telefoni si gestiscono a parte e non vengono toccati qui. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• get_mailboxsola lettura

  Ottenete una casella di posta, con il suo indirizzo di invio e le sue impostazioni.

• list_saved_repliessola lettura

  Elencate le risposte salvate di una casella — le formulazioni che il team ha già approvato. Da leggere prima di redigere, perché una risposta somigli a ciò che il team scrive davvero.

• list_userssola lettura

  Elencate gli agenti dell account.

• get_usersola lettura

  Ottenete un agente dal suo identificatore.

• get_current_usersola lettura

  Ottenete l agente a cui appartiene la connessione — quello che Help Scout considera l autore delle azioni. Utile sapere prima di assegnare o firmare qualcosa.

• list_teamssola lettura

  Elencate i team dell account. Un team può possedere una conversazione, come un agente.

• list_team_memberssola lettura

  Elencate gli agenti di un team.

• list_tagssola lettura

  Elencate i tag dell account. Da leggere prima di set_conversation_tags, per riutilizzare un tag esistente invece di crearne uno quasi identico.

• get_tagsola lettura

  Ottenete un tag dal suo identificatore.

• list_organizationssola lettura

  Elencate le organizzazioni — le aziende sotto cui i clienti sono raggruppati, con i loro domini, il sito e le note.

• get_organizationsola lettura

  Ottenete un organizzazione dal suo identificatore.

• get_ratingsola lettura

  Ottenete una valutazione di soddisfazione: il punteggio (great, okay, not_good), il commento del cliente, l agente la cui risposta è stata valutata e la conversazione interessata. L identificatore è quello della valutazione, non della conversazione.

Esempi di prompt

Chiedi alla tua IA in linguaggio naturale: sceglierà lo strumento Help Scout giusto.

• “Elencate le caselle di posta dell account — da Help Scout, in linguaggio naturale.”
• “Elencate le conversazioni, eventualmente filtrate per casella e per stato — da Help Scout, in linguaggio naturale.”
• “Ottenete una conversazione con i suoi thread (messaggi) — da Help Scout, in linguaggio naturale.”
• “Elencate i thread di una conversazione a parte, paginati — ciò che ha scritto il cliente, ciò che hanno risposto gli agenti, e le note interne. Preferite questo strumento a get_conversation quando un lungo scambio va letto oltre la prima pagina — da Help Scout, in linguaggio naturale.”

Come funziona

1. Crea il tuo account Proxoria e aggiungi il tuo endpoint MCP a Claude o ChatGPT.
2. Collega Help Scout con la tua chiave API — ogni persona collega il proprio account, con credenziali cifrate a riposo.
3. La tua IA ottiene subito gli strumenti Help Scout. Le azioni di scrittura attendono la tua approvazione nella dashboard prima di qualsiasi modifica.

Domande frequenti

Help Scout ha un server MCP ufficiale?

Non ti serve. Proxoria espone Help Scout alla tua IA tramite il Model Context Protocol: puoi usarlo da Claude, ChatGPT, Mistral o da qualsiasi client compatibile con MCP, senza alcun server MCP ufficiale di Help Scout.

Cosa può fare la mia IA con Help Scout tramite Proxoria?

Ottiene 27 strumenti: list_mailboxes, list_conversations, get_conversation, list_conversation_threads, search_conversations, add_note, reply_to_conversation, schedule_reply, create_conversation, update_conversation, set_conversation_tags, list_customers, get_customer, create_customer, update_customer, get_mailbox, list_saved_replies, list_users, get_user, get_current_user, list_teams, list_team_members, list_tags, get_tag, list_organizations, get_organization, get_rating. Per esempio: elencate le caselle di posta dell account.

Il connettore Help Scout è in sola lettura?

No — può anche modificare i dati. Le azioni di scrittura passano per impostazione predefinita dal controllo di conferma di Proxoria: la tua IA le propone e tu approvi ciascuna dalla dashboard prima che venga scritto qualcosa su Help Scout.

Come collego Help Scout alla mia IA?

Crea un account Proxoria, collega Help Scout con la tua chiave API e aggiungi il tuo endpoint MCP Proxoria a Claude o ChatGPT. La tua IA ottiene subito gli strumenti Help Scout.