HubSpot — Intégration QwiQ Talk

Connecter votre portail HubSpot pour ouvrir une fiche contact depuis la liste d’appels (recherche par numéro). Authentification par application privée et jeton d’accès commençant par pat-.

Ne pas confondre : la page « Intégrations → Applications connectées » (apps installées sur le compte) n’est pas celle où l’on crée le jeton API. Pour ce guide, utilisez l’espace Développement → Applications héritées (Legacy apps), puis une application privée. Compte HubSpot : droits de super administrateur en général requis.

1. Ouvrir l’espace Développement → Applications héritées

Dans HubSpot, accédez au menu Développement (Development), puis Applications héritées. Vous pouvez utiliser le bouton Créer une application héritée lorsque la liste est vide.

HubSpot — Développement, Applications héritées, bouton Créer une application héritée — Champs visibles : titre « Applications héritées », message éventuel sur la plateforme projets, bouton « Créer une application héritée ».

2. Choisir le type d’application : Public ou Privé

Dans la fenêtre Créer une application héritée, HubSpot demande le type : Public (pour plusieurs comptes) ou Privé (pour un seul compte). Pour QwiQ Talk, choisissez Privé — c’est ce qui correspond à une application privée et au jeton pat-.

Modal Créer une application héritée — choix Public ou Privé — Sélectionner **Privé** (« Pour un compte »).

3. Informations de base

Renseignez l’onglet Informations de base : Nom (obligatoire), Logo (optionnel), Description (optionnel). Exemple de nom : clicksip ou le nom de votre choix, unique sur le compte.

Onglets : Informations de base, Domaines (scopes), Webhooks. Bouton « Créer une application » en haut à droite une fois les scopes définis.

4. Domaines (scopes) — CRM contacts en lecture

Ouvrez l’onglet Domaines. Cliquez sur Ajouter un nouveau domaine / Ajoutez un nouveau champ d'application, utilisez la recherche « Trouver un domaine » et cochez au minimum le scope permettant la lecture des contacts, par exemple :

crm.objects.contacts.read — lecture des contacts (recommandé pour la recherche par téléphone).

Validez l’ajout des scopes. Sans ce type d’autorisation, l’API ne pourra pas rechercher les contacts par numéro.

Modal d’ajout de scopes CRM — recherche de domaines — Rechercher « contacts » ou faire défiler la liste CRM jusqu’à cocher la lecture sur les contacts.

5. Webhooks (optionnel pour QwiQ Talk)

L’onglet Webhooks permet d’envoyer des événements HubSpot vers une URL de votre infrastructure. Pour l’intégration actuelle QwiQ Talk (ouverture de fiche contact depuis les appels), ce n’est pas obligatoire. Vous pouvez laisser cette section vide.

Onglet Webhooks — URL cible et abonnements, optionnel — Champs typiques : URL cible (`https://`), ralentissement d’événement, création d’abonnements — à utiliser seulement si vous avez un besoin temps réel côté serveur.

6. Créer l’application et copier le jeton

Enregistrez / cliquez sur Créer une application. Sur la fiche de l’application privée, ouvrez l’onglet d’authentification (Auth ou équivalent) et affichez le jeton d’accès. Copiez la valeur complète (elle commence par pat-).

7. Coller le jeton dans QwiQ Talk

Dans QwiQ Talk : Intégrations → HubSpot (administrateur niveau 9). Collez le jeton dans le champ prévu, enregistrez, puis utilisez Tester la connexion. Activez l’intégration pour afficher le bouton HubSpot sur la page Appels.

Documentation développeurs HubSpot : Créer une application privée.