# HubSpot

Connectez HubSpot pour que l'assistant reconnaisse les appelants par téléphone, crée des contacts et des affaires, et consigne chaque appel en note

> Full REST + WebSocket API reference: https://api.happ.tools/reference

HubSpot se connecte avec une Service Key que vous créez dans votre compte HubSpot. Une fois la liaison faite, l'assistant salue les clients connus par leur nom en ayant leur dernière affaire sous les yeux, crée un contact et une affaire quand quelqu'un laisse une demande, et écrit le résultat de chaque appel dans la fiche du client.

## Ce que l'assistant peut faire [#what-the-assistant-can-do]

* **Reconnaître l'appelant** — au début d'un appel, il recherche le numéro de téléphone dans HubSpot et obtient le nom, l'e-mail, l'entreprise du contact et sa dernière affaire (nom, étape, montant).
* **Créer une affaire** — trouve le contact par téléphone ou en crée un nouveau, puis crée une affaire dans le pipeline et l'étape de votre choix. La demande, l'adresse de livraison, les produits et l'annonce qui a amené le client sont ajoutés à l'affaire sous forme de note.
* **Consigner les appels** — après chaque appel, il ajoute une note au contact et à son affaire : sens, durée, résultat, résumé, lien vers l'enregistrement et, si vous le souhaitez, la transcription complète.

## Avant de commencer [#before-you-start]

* **Compte HubSpot** dans lequel vous pouvez gérer les clés (Super Admin, ou un utilisateur autorisé à créer des clés).
* **Espace de travail HAPP** avec au moins un assistant.
* **HubSpot activé pour votre espace de travail** — l'intégration est activée par entreprise. Demandez au support HAPP de l'activer.

## Créer une Service Key [#create-a-service-key]

1. Dans HubSpot, ouvrez **Development > Keys > Service keys** et cliquez sur **Create service key**.
2. Nommez-la `HAPP` et ajoutez les scopes :
   * `crm.objects.contacts.read`, `crm.objects.contacts.write`
   * `crm.objects.deals.read`, `crm.objects.deals.write`
   * `crm.objects.owners.read`
3. Créez la clé et copiez-la.

Un jeton d'application privée existant (**Settings > Integrations > Private apps**) avec les mêmes scopes fonctionne aussi. HubSpot cesse de créer de nouvelles applications privées en octobre 2026 ; utilisez donc une Service Key pour les nouvelles connexions.

## Connecter [#connect]

1. Dans HAPP, ouvrez **Intégrations** et trouvez HubSpot sous **Ajouter un CRM**.
2. Cliquez sur **Connecter**, collez la clé et confirmez.
3. HubSpot apparaît sous **Mes intégrations** en tant que « HubSpot \<account ID> ».

## Paramètres [#settings]

Ouvrez l'icône d'engrenage de la carte dans l'onglet **Intégrations** de l'assistant.

* **Rechercher** — reconnaître l'appelant par téléphone.
* **Créer** — des affaires. Choisissez le **pipeline**, l'**étape** et le **propriétaire** ; sans eux, l'affaire va dans votre premier pipeline, à la première étape.
* **Notes d'appel** — une note après chaque appel. **Transcription complète** ajoute le texte de la conversation.

## Limites [#limits]

* HubSpot stocke les numéros de téléphone tels qu'ils ont été saisis ; l'assistant compare les 9 derniers chiffres, donc `050 111 22 33` et `+380501112233` sont le même client.
* Un numéro absent de HubSpot ne reçoit pas de note d'appel — il n'y a aucune fiche à laquelle l'attacher.
* Si l'e-mail du client appartient déjà à un autre contact, l'affaire est rattachée à ce contact.

## Dépannage [#troubleshooting]

| Problème                           | Cause                                                  | Solution                                                                        |
| ---------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------- |
| « HubSpot rejected the token »     | La clé a été supprimée, renouvelée ou mal saisie       | Créez une nouvelle clé et cliquez à nouveau sur **Connecter**.                  |
| « HubSpot token lacks scopes: … »  | Il manque à la clé l'un des scopes ci-dessus           | Ajoutez les scopes indiqués à la clé (ou créez-en une nouvelle) et reconnectez. |
| « HubSpot API rate limit reached » | Trop de requêtes à la fois                             | Rien à faire — la requête suivante passe.                                       |
| La liste des pipelines est vide    | Aucun pipeline d'affaires avec des étapes dans HubSpot | Créez un pipeline d'affaires dans HubSpot.                                      |

## Déconnecter [#disconnect]

Déconnectez la carte dans HAPP et supprimez la clé dans **Development > Keys > Service keys**. Les contacts, affaires et notes déjà dans HubSpot restent.

## Ensuite [#next]

* [CRM](/docs/integrations/crm) — toutes les intégrations CRM
* [Outils](/docs/agents/tools) — ce que l'assistant appelle pendant les conversations