---
title: Guida all'installazione dell'app WeTransact HubSpot
slug: it/guida-allinstallazione-dellapp-wetransact-hubspot
icon: {"faIcon":"fa-brands fa-wordpress"}
createdAt: 2026-03-16T20:45:24.193Z
---

:::hint{type="danger"}
Questa guida è destinata agli amministratori HubSpot o agli utenti tecnici responsabili della configurazione dell'integrazione WeTransact HubSpot. Se è un utente Sales o Marketing che desidera creare offerte Co-Sell o Private Offers, faccia riferimento a[HubSpot - Creazione di accordi di co-selling e offerte private](https://docs.wetransact.io/it/hubspot-creazione-di-accordi-di-co-selling-e-offerte-private)
:::

## WeTransact per HubSpot: guida alla configurazione

L'app WeTransact per HubSpot consente al suo team di vendita di registrare private offer Microsoft e offerte co-sell dal record dell'affare HubSpot su cui sta già lavorando. Tutto ciò che un rappresentante invia viene inoltrato a WeTransact e successivamente a Microsoft Partner Center. Nulla viene riscritto in HubSpot e l'app non richiede autorizzazioni di scrittura.

La configurazione richiede circa quindici minuti ed è composta da tre parti: connessione e installazione, aggiunta delle card alla vista dell'affare, verifica.

## Prima di iniziare

Sono necessari:

- Un tenant WeTransact con Microsoft Partner Center connesso e un accesso **amministratore** per esso.
- Almeno un piano pubblicato contrassegnato come utilizzabile come modello e almeno una soluzione pubblicata in quel tenant. La procedura guidata Private Offer elenca i piani; la procedura guidata Co-Sell elenca le soluzioni.
- Un account HubSpot con Deals in uso e un utente che sia **Super amministratore** in tale account. L'installazione di un'app e la modifica della vista del record dell'affare richiedono entrambe tale ruolo.
- L'accesso effettuato sia a WeTransact sia a HubSpot nello stesso browser.

Un tenant WeTransact si connette a un account HubSpot. Se la sua organizzazione dispone di diversi account HubSpot, decida prima quale utilizza il suo team di vendita.

## 1. Connettere HubSpot a WeTransact

Inizi da WeTransact, non da HubSpot Marketplace. Il lato WeTransact è ciò che associa il suo account HubSpot al suo tenant, in modo che le card sappiano quale catalogo e Partner Center utilizzare. Lo stesso passaggio installa anche l'app.

1. Acceda a WeTransact come amministratore e vada a **Impostazioni → Integrazioni**.
2. Faccia clic su **Connetti HubSpot**. Verrà reindirizzato a HubSpot. Se appartiene a più di un account HubSpot, scelga quello utilizzato dal suo team di vendita.
3. Esamini l'accesso richiesto. L'app richiede accesso in lettura ad affari, contatti e aziende e, facoltativamente, all'impostazione della valuta del suo account. Non richiede alcun accesso in scrittura. Conceda l'accesso.
4. Tornerà a WeTransact. HubSpot ora risulta connesso, insieme all'ID del portale HubSpot a cui è associato. Tenga tale ID a portata di mano; appare sulle card ed è ciò che il supporto richiederà.
5. In HubSpot, **Impostazioni → Integrazioni → App connesse** ora elenca **App HubSpot WeTransact**. Non vi è nulla da configurare lì.

:::BlockQuote
**Installata prima dal Marketplace?** L'app è installata ma non ancora associata a un tenant e le card mostrano *WeTransact non è connesso* con il suo ID portale. Completi i passaggi da 1 a 4 sopra. L'installazione esistente viene riutilizzata.
:::

## 2. Aggiungere le card ai record degli affari

L'app fornisce due card per i record degli affari: **Offerta privata WeTransact** e **WeTransact Co-Sell**. HubSpot non posiziona automaticamente le card delle app; un Super Admin le aggiunge una volta alla vista dell'affare e ogni utente di tale vista le vedrà successivamente.

1. In HubSpot vada a **Impostazioni → Oggetti → Affari → Personalizzazione del record** e apra la vista utilizzata dal suo team, normalmente la vista predefinita.
2. Nella sezione della barra laterale destra, aggiunga una card, filtri per l'app WeTransact e aggiunga sia **Offerta privata WeTransact** sia **WeTransact Co-Sell**. Le trascini vicino alla parte superiore in modo che i rappresentanti non debbano scorrere.
3. Salvi la vista. Se i suoi team utilizzano viste degli affari diverse, ripeta l'operazione per ogni vista che deve avere le card.

Apra qualsiasi affare. Entrambe le card appaiono nella barra laterale destra, mostrando inizialmente *Verifica della connessione a WeTransact in corso…* e successivamente i rispettivi pulsanti:

- **Apri l'interfaccia utente di WeTransact** apre il dashboard WeTransact in una nuova scheda.
- **Ricarica** aggiorna quel collegamento se non è stato possibile caricarlo.
- **Avvia offerta privata** / **Avvia co-selling** apre la procedura guidata.

## 3. Verifica

1. **Connessione.** Apra un affare. Ogni card mostra i propri pulsanti entro pochi secondi. Se mostra *WeTransact non è connesso*, torni alla parte 1.
2. **Link della dashboard.** Faccia clic su **Apri l'interfaccia utente di WeTransact**. Si apre la dashboard di WeTransact, con accesso effettuato al tenant collegato.
3. **Catalogo.** Faccia clic su **Avvia offerta privata**. Nel passaggio 1, l'elenco Products mostra i piani pubblicati. Faccia clic su **Annulla** e confermi; non è stato creato nulla.
4. **Precompilazione.** In una trattativa che dispone di nome, importo e contatto principale, avvii nuovamente la Private Offer: Offer Name e il primo indirizzo email del sottoscrittore sono precompilati. Annulli nuovamente.
5. **Un'esecuzione reale, solo con una sandbox.** Se la connessione Partner Center è una sandbox, completi la procedura guidata fino alla fine. Altrimenti si fermi qui: una Private Offer completata è un'offerta reale pubblicata su Microsoft.

I suoi rappresentanti possono ora utilizzare entrambe le procedure guidate. Li indirizzi al Manuale utente.

## Funzioni delle schede

### Registrare una private offer da una trattativa

Faccia clic su **Avvia offerta privata** in una trattativa. Cinque passaggi; i campi già presenti nella trattativa sono precompilati e possono essere modificati.

1. **Dettagli dell'offerta e prodotti.** Offer Name (dal nome della trattativa), Billing ID, Prepared By (la sua email), mese di inizio e fine dell'offerta oppure inizio all'accettazione, Offer Valid Until Date, Publisher Location e i prodotti e piani pubblicati su cui si basa questa offerta. Fino a dieci piani.
2. **Sottoscrittori.** Indirizzi email dei contatti cliente che ricevono l'offerta. Il contatto principale della trattativa è precompilato. Fino a cinque, aggiunti uno alla volta.
3. **Prezzi per piano.** Per ogni piano selezionato: durata del contratto, intervallo di fatturazione, valuta e prezzo, precompilati dal modello del piano. Facoltativamente, valute secondarie, una pianificazione di fatturazione con date, dimensioni personalizzate con quantità inclusa e prezzo per eccedenza e utenti minimi o massimi laddove il piano lo consenta.
4. **Termini e condizioni personalizzati.** Incolli l'URL dei termini oppure carichi un PDF e incolli l'URL fornito. Facoltativo.
5. **Pronto per la pubblicazione.** Selezioni **Pronto per la pubblicazione**, quindi **Fine**. L'offerta viene creata in WeTransact e pubblicata su Microsoft.

Gestisca l'offerta successivamente in WeTransact tramite **Apri l'interfaccia utente di WeTransact**.

### Registrare una trattativa co-sell da una trattativa

Faccia clic su **Avvia co-selling** in una trattativa. Sei passaggi, quindi una conferma.

1. **Trovi il cliente Microsoft.** Nome e paese del cliente, precompilati dalla società associata alla trattativa. **Avanti** recupera tutti i clienti Microsoft corrispondenti.
2. **Selezioni il cliente.** Ne scelga uno dall'elenco. Il filtraggio avviene localmente.
3. **Dettagli della trattativa.** Deal Name, Estimated Value, Currency ed Estimated Closing Date (precompilati dalla trattativa), Your CRM ID (precompilato con un collegamento a questa trattativa HubSpot), Your Campaign ID, Organization, Solution Area, Conversation e Notes.
4. **Membri del team.** Selezioni membri del team esistenti oppure ne aggiunga di nuovi con nome, telefono ed email. Almeno uno.
5. **Soluzioni.** Selezioni almeno una delle soluzioni pubblicate.
6. **Coinvolgimento Microsoft e invio.** Scelga il livello di coinvolgimento Microsoft, specifichi il contatto cliente principale, quindi **Invia**.
7. **Conferma.** *Offerta inviata* conferma che Microsoft ha accettato la registrazione.

## Cosa leggono le schede da HubSpot

Ogni scheda legge un insieme fisso di proprietà dalla trattativa in cui viene aperta, solo per precompilare la procedura guidata. Non viene archiviato nulla e non viene scritto nulla.

| Leggi da                     | Proprietà                                        | Utilizzato per                                                                    |
| ---------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------------- |
| Deal                         | Nome del deal, importo, valuta, data di chiusura | Nome offerta; Nome deal co-sell, valore stimato, valuta, data di chiusura stimata |
| Contatto principale del deal | Email                                            | Primo sottoscrittore dell'offerta privata                                         |
| Azienda associata al deal    | Nome, paese                                      | Ricerca cliente co-sell                                                           |
| Account                      | Valuta predefinita (ambito opzionale)            | Valuta co-sell quando il deal non ne ha una                                       |
| Lei                          | Il suo utente HubSpot                            | Prepared By nell'offerta privata                                                  |

## Autorizzazioni

L'app utilizza HubSpot OAuth e richiede:

- `crm.objects.deals.read`, `crm.objects.contacts.read`, `crm.objects.companies.read`: leggono il deal, il suo contatto principale e l'azienda associata per il precompilamento.
- `settings.currencies.read` (opzionale): la valuta predefinita del suo account come fallback per i deal co-sell.

Nessun ambito di scrittura. I dati inseriti da un rappresentante vengono inviati tramite HTTPS al connettore CRM di WeTransact su `crmproxy.wetransact.io`, che opera su Microsoft Partner Center con le credenziali del suo tenant. HubSpot firma ogni richiesta dalla card affinché il connettore possa verificare da quale account proviene.

## Risoluzione dei problemi

| Si vede                                                         | Causa                                                                                                  | Correzione                                                                                                                      |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| *WeTransact non è connesso*                                     | Questo account HubSpot non è associato a un tenant WeTransact.                                         | Un amministratore WeTransact fa clic su Connect HubSpot in Settings → Integrations. Quindi **Controlla di nuovo** sulla scheda. |
| *Impossibile raggiungere WeTransact*                            | Un problema di rete o del servizio, non un problema di configurazione.                                 | Faccia clic su **Riprova**. Se il problema persiste, contatti il supporto con l'ID del portale mostrato sulla scheda.           |
| Schede mancanti nelle trattative                                | Le schede dell'app non vengono posizionate automaticamente oppure l'utente si trova in un'altra vista. | Parte 2 sopra.                                                                                                                  |
| Schede mancanti nei contatti o nelle aziende                    | Per progettazione; le schede sono solo per le trattative.                                              | Apra la trattativa.                                                                                                             |
| L'elenco di prodotti o soluzioni è vuoto                        | Nessun piano o soluzione pubblicato utilizzabile nel tenant connesso.                                  | Pubblichi il piano e lo abiliti come template oppure pubblichi una soluzione in WeTransact.                                     |
| **Apri l'interfaccia utente di WeTransact** rimane disabilitato | Impossibile caricare il link della dashboard.                                                          | Faccia clic su **Ricarica**.                                                                                                    |

## Disconnettere o disinstallare

Due azioni indipendenti; esegua entrambe per rimuovere completamente l'integrazione.

1. In WeTransact, **Impostazioni → Integrazioni**, rimuova la connessione HubSpot. Le schede mostrano immediatamente *WeTransact non è connesso*.
2. In HubSpot, **Impostazioni → Integrazioni → App connesse**, apra WeTransact HubSpot App e la disinstalli. Questa operazione revoca l'accesso e rimuove le schede da tutte le viste.

Le offerte e le registrazioni già create rimangono in WeTransact e in Microsoft Partner Center.

## Supporto

[support@wetransact.io](mailto\:support@wetransact.io). Includa l'ID del portale HubSpot mostrato sulla scheda.
