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.

• get_company_reportsola lettura

  Panoramica aziendale su un periodo: clienti assistiti, conversazioni chiuse, risposte inviate, risposte al giorno e per operatore, con gli stessi dati su un periodo precedente e lo scarto.

• get_company_customers_helpedsola lettura

  Quanti clienti distinti ha assistito il team, tracciato sul periodo. viewBy fissa la risoluzione: giorno fino a 60 giorni, settimana fino a un anno, mese oltre.

• get_company_drilldownsola lettura

  Le conversazioni dietro un dato aziendale, pagina per pagina. range indica quale, rangeId lo restringe dove previsto.

• get_conversations_reportsola lettura

  Volume di conversazioni su un periodo: entrate, chiuse, ancora aperte, rispetto al periodo precedente.

• get_conversations_newsola lettura

  Nuove conversazioni nel tempo — la curva degli arrivi, alla risoluzione richiesta.

• get_conversations_busy_timessola lettura

  Quando le conversazioni arrivano davvero, in griglia giorno della settimana per ora. Il report che risponde alle domande di organico, non di prestazione.

• get_conversations_received_messagessola lettura

  Messaggi ricevuti nel tempo, che non è lo stesso delle conversazioni: un thread può portarne molti.

• get_conversations_volume_by_channelsola lettura

  Volume ripartito per canale — email, chat, telefono — nel tempo.

• get_conversations_drilldownsola lettura

  Le conversazioni contate dal report conversazioni, elencate pagina per pagina.

• get_conversations_new_drilldownsola lettura

  Le conversazioni contate come nuove, elencate pagina per pagina.

• get_conversations_field_drilldownsola lettura

  Le conversazioni dietro un tag, una risposta salvata, un workflow o un cliente. field dice quale dei quattro, fieldId quale in particolare.

• get_productivity_reportsola lettura

  Produttività del team sul periodo: tempo di prima risposta, tempo di risposta, tempo di risoluzione, risposte inviate, risolte. officeHours misura in orario di lavoro anziché in tempo di calendario.

• get_productivity_first_response_timesola lettura

  Tempo di prima risposta sul periodo — quanto attende un cliente prima della prima risposta umana.

• get_productivity_response_timesola lettura

  Tempo di risposta sul periodo, contando ogni risposta e non solo la prima.

• get_productivity_resolution_timesola lettura

  Tempo di risoluzione sul periodo — quanto resta aperta una conversazione prima di essere chiusa.

• get_productivity_replies_sentsola lettura

  Risposte inviate sul periodo, alla risoluzione richiesta.

• get_productivity_resolvedsola lettura

  Conversazioni risolte sul periodo, alla risoluzione richiesta.

• get_happiness_reportsola lettura

  Punteggio di soddisfazione su un periodo: quante valutazioni great, okay e not good, con la stessa ripartizione sul periodo precedente.

• get_happiness_ratingssola lettura

  Le singole valutazioni di soddisfazione con il commento del cliente. rating filtra su great, ok o not-good: è qui che si legge cosa ha davvero scritto un cliente insoddisfatto.

• get_user_reportsola lettura

  I dati di un operatore su un periodo: conversazioni gestite, risposte inviate, tempi di risposta e risoluzione, soddisfazione, rispetto al periodo precedente.

• get_user_customers_helpedsola lettura

  Quanti clienti distinti ha assistito un operatore, tracciato sul periodo.

• get_user_repliessola lettura

  Risposte inviate da un operatore sul periodo, alla risoluzione richiesta.

• get_user_resolutionssola lettura

  Conversazioni risolte da un operatore sul periodo, alla risoluzione richiesta.

• get_user_happinesssola lettura

  Punteggio di soddisfazione di un operatore sul periodo, rispetto al precedente.

• get_user_ratingssola lettura

  Le singole valutazioni ricevute da un operatore, con il commento del cliente. Filtrate con rating per leggere solo quelle negative.

• get_user_conversation_historysola lettura

  Le conversazioni gestite da un operatore sul periodo, con il numero di risposte e i tempi. sortField porta in testa le più lente.

• get_user_drilldownsola lettura

  Le conversazioni dietro i dati di un operatore, elencate pagina per pagina.

• get_user_chat_reportsola lettura

  I dati di chat di un operatore sul periodo: chat gestite, tempi di risposta e risoluzione.

• get_chat_reportsola lettura

  I dati di chat del team sul periodo, rispetto al precedente.

• get_email_reportsola lettura

  I dati email del team sul periodo, rispetto al precedente.

• get_phone_reportsola lettura

  I dati telefonici del team sul periodo, rispetto al precedente.

• get_docs_reportsola lettura

  Come è andata la base di conoscenza Docs sul periodo: visualizzazioni, ricerche e le ricerche senza risultato — l'elenco di ciò che i clienti hanno cercato senza trovarlo.

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 59 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, get_company_report, get_company_customers_helped, get_company_drilldown, get_conversations_report, get_conversations_new, get_conversations_busy_times, get_conversations_received_messages, get_conversations_volume_by_channel, get_conversations_drilldown, get_conversations_new_drilldown, get_conversations_field_drilldown, get_productivity_report, get_productivity_first_response_time, get_productivity_response_time, get_productivity_resolution_time, get_productivity_replies_sent, get_productivity_resolved, get_happiness_report, get_happiness_ratings, get_user_report, get_user_customers_helped, get_user_replies, get_user_resolutions, get_user_happiness, get_user_ratings, get_user_conversation_history, get_user_drilldown, get_user_chat_report, get_chat_report, get_email_report, get_phone_report, get_docs_report. 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.