Hubspot

  Die Hubspot-Integration ermöglicht es Ihnen, Ihren Botpress mit Hubspot, einer führenden CRM- und Marketing-Automatisierungsplattform, zu verbinden. Mit dieser Integration kann Ihr Chatbot Kontakte, Tickets und mehr direkt in Hubspot verwalten, was eine nahtlose Automatisierung von Vertriebs-, Marketing- und Support-Workflows ermöglicht.

## Konfiguration

Um die sensiblen Daten in Ihrem HubSpot-Arbeitsbereich zu schützen, müssen Sie für diese Integration Ihre eigene private HubSpot-App erstellen und konfigurieren. Wir sind uns bewusst, dass dies den Einrichtungsprozess komplizierter macht, aber es gewährleistet, dass Ihre Daten sicher bleiben. Wir arbeiten aktiv mit HubSpot zusammen, um die Einrichtung mit einem Mausklick zu vereinfachen. In der Zwischenzeit führen Sie bitte die folgenden Schritte aus, um die Integration manuell zu konfigurieren.

### Manuelle Konfiguration mit einer benutzerdefinierten OAuth-App

1. Installieren Sie die Integration in Ihrem Bot und kopieren Sie die webhook . Diese URL beginnt mit botpress.
2. Navigieren Sie in Ihrem HubSpot-Einstellungs-Dashboard zu _Account Management_ > _Integrationen_ > _Legacy Apps_.
3. Erstellen Sie eine neue Legacy App und machen Sie sie privat.
4. Fügen Sie unter der Registerkarte _Scopes_ die folgenden Bereiche hinzu:
   - `oauth`: für die Authentifizierung mit der HubSpot-API
   - `crm.objects.contacts.read`: zum Abrufen von Kontakten
   - crm.objects.contacts.write`: zum Erstellen und Aktualisieren von Kontakten
   - tickets": zum Abrufen von Ticketeigenschaften und Erstellen von Tickets
   - crm.objects.owners.read`: zum Abrufen und Zuweisen von Besitzern zu Tickets
   - crm.objects.companies.read`: zum Abrufen und Zuordnen von Unternehmen zu Tickets
   - crm.objects.companies.write`: zum Erstellen und Aktualisieren von Unternehmen
   - `crm.objects.leads.read`: zum Abrufen von Leads
   - `crm.objects.leads.write`: zum Erstellen und Aktualisieren von Leads
   - `crm.objects.deals.read`: zum Abrufen von Geschäften
   - crm.objects.deals.write`: zum Erstellen und Aktualisieren von Geschäften
5. Fügen Sie auf der Registerkarte _Webhooks_ Ihre webhook ein, setzen Sie _Event Throttling_ auf 1 und klicken Sie auf _Create Subscription_.
6. Sie können nun optional webhook abonnieren. Aktivieren Sie im Dialogfeld _Neue webhook erstellen_ die Option _Erweiterte Objektunterstützung_, und wählen Sie dann die Ereignisse aus, die Sie abonnieren möchten. Derzeit unterstützt die Integration die folgenden Ereignisse:
   - Unternehmen erstellt
   - Unternehmen Gelöscht
   - Kontakt erstellt
   - Kontakt Gelöscht
   - Lead erstellt
   - Lead Gelöscht
   - Ticket erstellt
   - Ticket Gelöscht
7. Sie können nun auf die Schaltfläche _Anwendung erstellen_ klicken, um Ihre Legacy-Anwendung zu erstellen.
8. Navigieren Sie auf der Einstellungsseite Ihrer App zur Registerkarte _Authentifizierung_ und kopieren Sie das _Access Token_ und das _Client Secret_.
9. Fügen Sie das _Access Token_ und das _Client Secret_ in Botpress ein und speichern Sie dann die Konfiguration der Integration.