CRM e supporto
HubSpot
Contatti, aziende, trattative e ticket del CRM HubSpot; note e record con conferma.
- Accesso con Connetti (OAuth)
- Azioni con conferma
Strumenti per l’agente
L’agente sceglie da solo lo strumento adatto alla domanda. Nella scheda MCP e database dell’agente puoi disattivare quelli che non servono.
| Strumento | Cosa fa | Tipo |
|---|---|---|
search_records | Cerca contatti, aziende, trattative o ticket per testo; restituisce una tabella (grafici ed export). | Lettura |
get_record | Dettaglio di un record con i record associati (contatti, aziende, trattative). | Lettura |
create_record | Crea un contatto, un’azienda o una trattativa con le proprietà indicate. Richiede conferma. | Con conferma |
add_note | Aggiunge una nota a un contatto, un’azienda o una trattativa. Richiede conferma. | Con conferma |
Le azioni che modificano dati sono spente di default. Si attivano nella connessione con l’opzione Consenti creazione di record e note (con conferma); poi ogni azione mostra in chat un riepilogo e parte solo con Conferma ed esegui.
Configurazione passo per passo
In Kaiross apri Integrazioni, scegli HubSpot e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.
- Via semplice: HubSpot → Settings → Integrations → Private Apps → Create; scope crm.objects.contacts/companies/deals.read e tickets (più .write se abiliti la scrittura). Incolla l’access token.
- In alternativa (app pubblica): developers.hubspot.com → app con gli stessi scope e il Redirect URI mostrato qui sotto; inserisci Client ID e secret e premi Connetti.
- Il token resta nel Vault.
Campi del modulo: Client ID (per Connetti).
Da incollare (cifrato nel Vault, poi non più visibile): Access token della private app (alternativa a Connetti), Client secret (per Connetti).
Accesso con «Connetti» (OAuth)
- Nel modulo della connessione copia il valore Indirizzo di ritorno (Redirect URI) da registrare nell’app OAuth (icona Copia indirizzo di ritorno).
- Registra l’app OAuth presso il fornitore (passi qui sopra) incollando quel Redirect URI.
- Inserisci in Kaiross Client ID e Client secret e premi Salva e connetti: si apre la finestra del fornitore, accedi con l’account da usare e autorizza.
- Se in seguito il test segnala «Accesso scaduto», premi Ricollega nella connessione.
In alternativa al flusso «Connetti» puoi incollare un token nel campo dedicato (vedi i passi qui sopra).
Permessi (scope) richiesti
Kaiross chiede solo questi permessi al fornitore; le azioni di scrittura restano comunque spente finché non le attivi.
oauthcrm.objects.contacts.readcrm.objects.companies.readcrm.objects.deals.readticketscrm.objects.contacts.writecrm.objects.companies.writecrm.objects.deals.write
Collegarla a un agente
- Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
- In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
- Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
- Premi Prova in chat e fai una domanda che richiede i dati del servizio.
Errori frequenti
- Credenziali non valide
- Controlla token, password o chiave API: spesso manca un carattere o il token è scaduto. Creane uno nuovo e aggiorna la connessione.
- Account non collegato o accesso scaduto
- Il collegamento OAuth non è mai stato completato o non è più valido: premi Connetti o Ricollega nella connessione.
- Permessi insufficienti
- All’account mancano gli scope necessari: confrontali con l’elenco qui sopra.
- Troppe richieste
- Il servizio limita la frequenza delle chiamate: riprova tra qualche minuto.
Link utili
Console del fornitore citate nei passi: