LetsBot Menü
Loslegen Deutsch Sprache

Meta Business Partner In Großbritannien registriertes Unternehmen

Sprache

Einrichtungsanleitung · HubSpot

Anleitung: HubSpot-WhatsApp-Integration einrichten

Diese Anleitung führt Sie Schritt für Schritt durch Installation und Konfiguration der LetsBot-App in HubSpot – bis Ihre erste automatische WhatsApp-Nachricht durch ein CRM-Ereignis ausgelöst wird.

Die Einrichtung dauert etwa fünf Minuten und erfordert keinen Code. Diese Seite ist öffentlich und ohne Anmeldung zugänglich.

1. Bevor Sie beginnen

  • Ein LetsBot-Konto. Sie können mit 14 Tagen kostenloser Testphase starten, ohne Kreditkarte.
  • Eine in LetsBot verbundene WhatsApp-Business-Nummer, da Nachrichten über die offizielle WhatsApp Business API gesendet werden.
  • Ein HubSpot-Konto, in dem Sie Apps installieren dürfen (Kontoadministrator).
  • Gültige Telefonnummern im internationalen Format bei Ihren HubSpot-Kontakten, damit die App den Empfänger ermitteln kann.

2. App installieren und HubSpot verbinden

Die Verbindung erfolgt über HubSpot OAuth. Sie müssen nie einen API-Schlüssel kopieren oder einfügen.

  1. Melden Sie sich im LetsBot-Panel an. letsbot.net/login
  2. Öffnen Sie den Bereich „Integrationen“ und wählen Sie HubSpot.
  3. Klicken Sie auf „HubSpot verbinden“. Sie werden zum OAuth-Autorisierungsbildschirm von HubSpot weitergeleitet.
  4. Wählen Sie das Konto, das Sie verbinden möchten, prüfen Sie die Berechtigungen und bestätigen Sie sie.
  5. Sie werden automatisch ins LetsBot-Panel zurückgeleitet, die Verbindung ist hergestellt und die wichtigsten Auslöser sind bereits aktiv und anpassbar.

3. Angeforderte Berechtigungen und warum

Die App fordert nur die Berechtigungen an, die ihre Funktionen tatsächlich benötigen. Hier die vollständige Liste:

Geltungsbereich Wofür sie benötigt wird
crm.objects.contacts.read Kontakteigenschaften (Name, Telefon, E-Mail) lesen, um den Empfänger zu ermitteln und die Nachrichtenvariablen zu füllen.
crm.objects.contacts.write Einen Kontakt anlegen, wenn eine WhatsApp-Nachricht von einer unbekannten Nummer eingeht, und Antworten als Notizen in der Kontakt-Timeline protokollieren.
crm.objects.deals.read Deal-Eigenschaften (Name, Phase, Betrag, Abschlussdatum) und den verknüpften Kontakt lesen, um die Deal-Auslöser zu steuern.
tickets Ticket-Eigenschaften (Betreff, Inhalt) und den verknüpften Kontakt lesen, um den Ticket-Auslöser zu steuern.

Die App ändert niemals Ihre Deals oder Tickets und löscht keine Datensätze. Sie schreibt nur in zwei Fällen: Sie legt einen Kontakt an, wenn eine Nachricht von einer unbekannten Nummer eingeht, und fügt der Timeline dieses Kontakts eine Gesprächsnotiz hinzu.

4. Auslöser-Ereignis wählen

Jedes Ereignis ist unabhängig: Sie aktivieren nur, was Sie brauchen, und können den Rest jederzeit abschalten. Für ein Ereignis, das Sie nicht selbst aktiviert haben, wird niemals eine Nachricht gesendet.

Ereignis HubSpot-Abonnementtyp Was passiert
Kontakt erstellt contact.creation Sendet eine Willkommensnachricht, sobald in HubSpot ein neuer Kontakt hinzugefügt wird.
Lifecycle-Phase des Kontakts geändert contact.propertyChange Sendet eine Nachricht, wenn der Kontakt in eine neue Lifecycle-Phase wechselt (zum Beispiel Marketing Qualified Lead).
Deal erstellt deal.creation Schreibt den mit dem Deal verknüpften Kontakt an, sobald der Deal angelegt wird.
Deal-Phase geändert deal.propertyChange Sendet ein Update, wenn der Deal in Ihrer Pipeline in eine andere Phase wechselt.
Ticket erstellt ticket.creation Informiert den Kunden per WhatsApp, dass sein Ticket eingegangen ist und bearbeitet wird.

5. Nachricht schreiben oder Vorlage wählen

Für jedes Ereignis können Sie eine kurze Textnachricht schreiben oder eine Rich-WhatsApp-Vorlage mit Schaltflächen, Listen und Medien wählen. HubSpot-Daten werden über diese Variablen in die Nachricht eingefügt:

Variable Wert
{CONTACT_FIRSTNAME} Vorname des Kontakts
{DEAL_NAME} Name des Deals
{DEAL_STAGE} Deal-Phase
{DEAL_AMOUNT} Deal-Betrag
{TICKET_SUBJECT} Ticket-Betreff
{TICKET_CONTENT} Ticket-Inhalt

Nachrichten gibt es auf Arabisch und Englisch. Ist die Sprache des Kontakts in LetsBot hinterlegt, wird die passende Version gesendet, sonst standardmäßig die englische.

6. Aktivieren und testen

  1. Aktivieren Sie den Schalter neben dem konfigurierten Ereignis und speichern Sie.
  2. Legen Sie in HubSpot einen echten Datensatz dieses Typs an – zum Beispiel einen neuen Kontakt – mit Ihrer eigenen Telefonnummer.
  3. Innerhalb von Sekunden erhalten Sie eine WhatsApp-Nachricht. Den Zustellstatus verfolgen Sie im Nachrichtenprotokoll in LetsBot.

7. Antworten zurück in HubSpot protokolliert

Antwortet ein Kunde per WhatsApp, protokolliert LetsBot die Antwort als Notiz in der Kontakt-Timeline in HubSpot, sodass der gesamte Gesprächskontext im Kundendatensatz bleibt. Kommt die Antwort von einer Nummer, die Sie noch nicht haben, wird automatisch ein Kontakt angelegt und die Notiz dort gespeichert.

8. Fehlerbehebung

Die Nachricht ist nicht angekommen

  • Prüfen Sie, ob der Schalter für das Ereignis aktiviert und gespeichert ist.
  • Prüfen Sie, ob der HubSpot-Kontakt eine gültige Telefonnummer im internationalen Format hat; ohne sie lässt sich der Empfänger nicht ermitteln.
  • Prüfen Sie, ob Ihre WhatsApp-Business-Nummer verbunden ist und in LetsBot als online angezeigt wird.

Deal- oder Ticket-Auslöser reagieren nicht

Deal- und Ticket-Auslöser benötigen einen verknüpften Kontakt, da die Nachricht an eine Person und nicht an einen Datensatz geht. Verknüpfen Sie den Deal oder das Ticket mit einem Kontakt mit Telefonnummer und versuchen Sie es erneut.

Die Verbindung wurde getrennt

Das passiert, wenn die App in HubSpot deinstalliert oder die Autorisierung widerrufen wurde. Verbinden Sie sie im LetsBot-Panel neu, indem Sie erneut auf „HubSpot verbinden“ klicken.

9. Trennen und deinstallieren

Sie können die Verbindung jederzeit über die Trennen-Schaltfläche im LetsBot-Panel aufheben oder die App in den Einstellungen für verbundene Apps Ihres HubSpot-Kontos entfernen. Sobald die Verbindung getrennt ist, stoppen alle automatischen Nachrichten sofort, und die App hat keinerlei Zugriff mehr auf Ihre Daten.

10. Daten und Datenschutz

Alle Daten werden über eine verschlüsselte Verbindung übertragen, Zugriffstokens werden verschlüsselt gespeichert. LetsBot liest aus HubSpot nur die Felder, die zum Personalisieren der Nachricht und zum Ermitteln des Empfängers nötig sind, und Ihre Daten werden niemals an Dritte weitergegeben.

Brauchen Sie Hilfe bei der Einrichtung? Unser KI-Support antwortet rund um die Uhr (24/7) in jeder Sprache, und unser Team hilft Ihnen auf Arabisch und Englisch, die Verbindung abzuschließen und Ihre erste Nachricht zu senden.

Jetzt verbinden

Die Einrichtung dauert etwa fünf Minuten und erfordert keinen Code.