Hubspot

  L'intégration Hubspot vous permet de connecter votre chatbot Botpress avec Hubspot, une plateforme de CRM et d'automatisation du marketing. Avec cette intégration, votre chatbot peut gérer des contacts, des tickets, et plus encore directement dans Hubspot, permettant une automatisation transparente des ventes, du marketing, et des flux de travail du support.

## Configuration

Pour protéger les données sensibles de votre espace de travail HubSpot, cette intégration nécessite que vous créiez et configuriez votre propre application HubSpot privée. Bien que nous reconnaissions que cela ajoute de la complexité au processus de configuration, cela garantit que vos données restent sécurisées. Nous collaborons activement avec HubSpot pour rationaliser ce processus et le rendre accessible en un seul clic. En attendant, veuillez suivre les étapes ci-dessous pour configurer manuellement l'intégration.

### Configuration manuelle avec une application OAuth personnalisée

1. Installez l'intégration dans votre bot et copiez l'URL du webhook . Cette URL commence par botpress.
2. Depuis votre tableau de bord HubSpot, naviguez vers _Account Management_ > _Integrations_ > _Legacy Apps_.
3. Créez une nouvelle Legacy App et rendez-la privée.
4. Sous l'onglet _Scopes_, ajoutez les scopes suivants :
   - `oauth` : pour s'authentifier avec l'API HubSpot
   - `crm.objects.contacts.read` : pour récupérer les contacts
   - `crm.objects.contacts.write` : pour créer et mettre à jour des contacts
   - `tickets` : pour récupérer les propriétés des tickets et créer des tickets
   - `crm.objects.owners.read` : pour récupérer et assigner des propriétaires aux tickets
   - `crm.objects.companies.read` : pour récupérer et assigner des sociétés aux tickets
   - `crm.objects.companies.write` : pour créer et mettre à jour des sociétés
   - `crm.objects.leads.read` : pour récupérer des leads
   - `crm.objects.leads.write` : pour créer et mettre à jour des leads
   - `crm.objects.deals.read` : pour récupérer les contrats
   - `crm.objects.deals.write` : pour créer et mettre à jour des contrats
5. Sous l'onglet _Webhooks_, collez l'URL de votre webhook , réglez _Event Throttling_ sur 1, et cliquez sur _Create Subscription_.
6. Vous pouvez maintenant vous abonner aux événements du webhook . Dans la boîte de dialogue _Create new webhook subscriptions_, activez _expanded object support_, puis sélectionnez les événements auxquels vous souhaitez vous abonner. Actuellement, l'intégration prend en charge les événements suivants :
   - Entreprise créée
   - Société supprimée
   - Contact créé
   - Contact supprimé
   - Dirigeant créé
   - Dirigeant supprimé
   - Ticket créé
   - Ticket supprimé
7. Vous pouvez maintenant cliquer sur le bouton _Create App_ pour créer votre application patrimoniale.
8. Depuis la page des paramètres de votre application, naviguez jusqu'à l'onglet _Auth_ et copiez le _Token d'accès_ et le _Secret du client_.
9. Collez le _Access Token_ et le _Client Secret_ dans Botpress, puis sauvegardez la configuration de l'intégration.