HubSpot

Connexion de HubSpot avec Siesta AI

1. Dans Connexion, sélectionnez Ajouter une connexion et choisissez HubSpot.

2. Entrez le jeton d'application privée (clé API) et définissez Partagé ou Privé.

3. Dans HubSpot, ouvrez Paramètres -> Intégrations -> Applications privées et créez une nouvelle application.

4. Complétez les informations de base de l'application.

5. Configurez les scopes nécessaires pour les objets CRM.

6. Dans l'onglet Auth, copiez le jeton d'accès et utilisez-le dans Siesta AI.

Aperçu

Cette connexion fournit une interface standardisée pour travailler avec HubSpot CRM. Elle permet la création et la lecture des entités CRM de base : Entreprises, Contacts, Offres et Pipelines.

L'intégration est conçue comme sans état, déterministe et fail-fast, adaptée pour :

• L'automatisation CRM
• La synchronisation des leads
• L'orchestration des pipelines de vente et de revenus
• Des workflows d'entreprise auditables

Authentification et sécurité

• La connexion communique exclusivement via l'API officielle de HubSpot.
• L'authentification est gérée au niveau du compte HubSpot (OAuth / jeton d'application privée).
• Aucune donnée sensible n'est enregistrée ni mise en cache.
• Toutes les opérations s'exécutent avec les autorisations attribuées dans HubSpot.

Les droits d'accès (scopes) influencent directement la disponibilité des opérations. Un scope incorrect signifie un échec.

Entités prises en charge

• Entreprise
• Contact
• Offre
• Pipeline

Chaque opération fonctionne avec des ID internes de HubSpot, et non des noms.

1. Opérations sur les entreprises

1.1 CréerEntreprise

Description
Crée une nouvelle entreprise dans HubSpot CRM.

Paramètres d'entrée

Paramètre	Type	Obligatoire	Description
name	String	Oui	Nom de l'entreprise.
domain	String	Oui	Domaine de l'entreprise (doit être unique).

Comportement

• Si le domaine existe déjà, l'opération échoue.
• Ne fait pas de correspondance floue ni de normalisation de domaine.

Utilisation typique

• Intégration de nouveaux clients
• Synchronisation des entreprises à partir de systèmes externes

2. Opérations sur les contacts

2.1 CréerContact

Description
Crée un nouveau contact dans HubSpot CRM.

Paramètres d'entrée

Paramètre	Type	Obligatoire	Description
email	String	Oui	Email du contact (doit être unique).
firstName	String	Oui	Prénom.
lastName	String	Oui	Nom de famille.

Comportement

• L'email sert d'identifiant unique.
• Email dupliqué = erreur fatale.

2.2 ObtenirContactParEmail

Description
Retourne un contact basé sur l'adresse email.

Paramètres d'entrée

Paramètre	Type	Obligatoire
email	String	Oui

2.3 ObtenirContactParId

Description
Retourne un contact selon son ID unique HubSpot.

Paramètres d'entrée

Paramètre	Type	Obligatoire
contactId	Int64	Oui

2.4 ObtenirTousLesContacts

Description
Retourne une liste de contacts dans HubSpot CRM.

Paramètres d'entrée

Paramètre	Type	Obligatoire	Description
limit	Int	Non	Nombre maximum d'enregistrements retournés.

3. Opérations sur les offres

3.1 CréerOffre

Description
Crée une nouvelle offre et l'associe à un contact spécifique.

Paramètres d'entrée

Paramètre	Type	Obligatoire	Description
dealName	String	Oui	Nom de l'offre.
contactId	String	Oui	ID de contact existant.
pipelineId	Int64	Oui	ID du pipeline (pas le nom).
stageId	Int64	Oui	ID de l'étape (pas le nom).
amount	Int	Non	Valeur de l'offre.

Comportement

• Le pipeline et l'étape doivent exister.
• Ne fait pas de mappage automatique des noms vers les ID.
• Relation incorrecte = échec.

3.2 ObtenirOffreParId

Description
Retourne les détails de l'offre selon l'ID.

Paramètres d'entrée

Paramètre	Type	Obligatoire
dealId	Int64	Oui

3.3 ObtenirToutesLesOffres

Description
Retourne une liste d'offres.

Paramètres d'entrée

Paramètre	Type	Obligatoire
limit	Int	Non

4. Opérations sur les pipelines

4.1 ListerTousLesPipelines

Description
Retourne tous les pipelines, y compris leurs étapes et ID correspondants.

Paramètres d'entrée
Aucun.

Remarque Cette étape est obligatoire si vous ne souhaitez pas créer des offres à l'aveugle.

5. Opérations de recherche

5.1 RechercherEntreprises

Description
Recherche des entreprises par nom.

Paramètres d'entrée

Paramètre	Type	Obligatoire	Description
name	String	Non	Nom de l'entreprise (sans domaine).

Restrictions

• Ne pas utiliser de domaines, d'URL ou d'emails.
• La recherche est textuelle, sans correspondance floue.