Zum Hauptinhalt springen

Messaging-Anbieter

Einstellungen → Kommunikation → Messaging-Anbieter ist der Ort, an dem Sie LeadHub mit bidirektionalen Messaging-Kanälen verbinden. Nach der Konfiguration können Leads direkt aus ihrer Detailansicht kontaktiert werden, und eingehende Nachrichten aus diesen Kanälen kommen in Gespräche an.

Unterstützte Kanäle:

KanalRichtungAnbieter
WhatsAppSenden & EmpfangenMeta Cloud API (WhatsApp Business)
SMSSenden & EmpfangenTwilio Programmable Messaging
TelegramSenden & EmpfangenTelegram Bot API
ViberSenden & EmpfangenViber Business Messages
Sprache (Click-to-Call)Ausgehend + AufzeichnungTwilio Programmable Voice

WhatsApp Business (Meta Cloud API)

Voraussetzungen

  • Ein Meta Business-Konto unter business.facebook.com
  • Ein WhatsApp Business-Konto mit einer genehmigten Telefonnummer
  • Die Nummer muss in der WhatsApp Cloud API registriert sein (nicht in der normalen WhatsApp-App)

Schritt 1 — Eine Meta-App erstellen

  1. Gehen Sie zu developers.facebook.comMeine Apps → App erstellen.
  2. Wählen Sie Business als App-Typ.
  3. Geben Sie einen Namen ein (z. B. LeadHub-Integration) und klicken Sie auf App erstellen.
  4. Suchen Sie unter Produkte hinzufügen nach WhatsApp und klicken Sie auf Einrichten.

Schritt 2 — Ihre Anmeldedaten abrufen

  1. Gehen Sie im WhatsApp-Produkt-Dashboard zu API-Setup.
  2. Notieren Sie sich:
    • Telefonnummer-ID (numerisch, z. B. 106540352242922)
    • WhatsApp Business-Konto-ID
  3. Gehen Sie zu Systembenutzer (in den Unternehmenseinstellungen) → erstellen Sie einen Systembenutzer → generieren Sie ein Permanentes Zugriffstoken mit der Berechtigung whatsapp_business_messaging.

Schritt 3 — In LeadHub konfigurieren

  1. Gehen Sie zu Einstellungen → Kommunikation → Messaging-Anbieter.

  2. Erweitern Sie den Abschnitt WhatsApp Business und füllen Sie aus:

    FeldWert
    AktiviertEinschalten
    Permanentes ZugriffstokenAus Schritt 2
    Telefonnummer-IDAus Schritt 2
    Angezeigte TelefonnummerIhre WhatsApp-Nummer (z. B. +49-30-12345678)
  3. Klicken Sie auf Einstellungen speichern.

  4. Die Eingehende Webhook-URL erscheint nach dem Speichern.

Schritt 4 — Webhook in Meta registrieren

  1. Gehen Sie im Meta-App-Dashboard zu WhatsApp → Konfiguration → Webhooks.
  2. Setzen Sie die Callback-URL auf Ihre eingehende Webhook-URL aus Schritt 3.
  3. Setzen Sie das Verify Token auf eine beliebige Zeichenfolge (z. B. leadhub_verify).
  4. Abonnieren Sie das Nachrichten-Webhook-Feld.

SMS (Twilio Programmable Messaging)

Schritt 1 — Twilio-Anmeldedaten abrufen

  1. Melden Sie sich bei console.twilio.com an.
  2. Kopieren Sie vom Dashboard Ihre Account SID und Ihr Auth Token.
  3. Notieren Sie sich unter Telefonnummern → Verwalten → Aktive Nummern Ihre Twilio-Nummer.

Schritt 2 — In LeadHub konfigurieren

  1. Gehen Sie zu Einstellungen → Kommunikation → Messaging-Anbieter.

  2. Erweitern Sie SMS (Twilio) und füllen Sie aus:

    FeldWert
    AktiviertEinschalten
    Account SIDAC... aus dem Twilio-Dashboard
    Auth TokenAus dem Twilio-Dashboard
    AbsendernummerIhre Twilio-Nummer im E.164-Format (z. B. +14155550199)
  3. Klicken Sie auf Einstellungen speichern.

  4. Kopieren Sie die Eingehende Webhook-URL, die nach dem Speichern erscheint.

Schritt 3 — Webhook in Twilio registrieren

  1. Gehen Sie in Twilio zu Telefonnummern → Verwalten → Aktive Nummern → klicken Sie auf Ihre Nummer.
  2. Setzen Sie unter MessagingEine Nachricht kommt herein die Webhook-URL auf Ihre LeadHub-Eingehende-Webhook-URL.
  3. Setzen Sie die Methode auf HTTP POST und speichern.

Telegram

Schritt 1 — Einen Telegram-Bot erstellen

  1. Öffnen Sie Telegram und schreiben Sie @BotFather.
  2. Senden Sie /newbot und folgen Sie den Anweisungen (Name und Benutzername).
  3. BotFather gibt Ihnen ein Bot-Token (Format: 123456:ABCdef...).
  4. Notieren Sie sich auch den Bot-Benutzernamen (z. B. @ihr_leadhub_bot).

Schritt 2 — In LeadHub konfigurieren

  1. Gehen Sie zu Einstellungen → Kommunikation → Messaging-Anbieter.

  2. Erweitern Sie Telegram und füllen Sie aus:

    FeldWert
    AktiviertEinschalten
    Bot-TokenVon BotFather
    Bot-Benutzernamez. B. @ihr_leadhub_bot
  3. Klicken Sie auf Einstellungen speichern.

LeadHub registriert den Webhook automatisch bei Telegram — Sie müssen die URL nicht manuell in Telegram einfügen.


Viber Business Messages

⚠️ Viber Business Messages erfordert ein genehmigtes Viber-Servicekonto (ISV/Business-Konto). Normale persönliche Viber-Konten können keine Geschäftsnachrichten senden.

Schritt 1 — Ihr Viber Auth-Token abrufen

  1. Wenden Sie sich an das Partnerprogramm von Viber und erhalten Sie Ihr Servicekonto.
  2. Melden Sie sich im Viber-Partnerportal an und finden Sie Ihr Auth-Token.
  3. Notieren Sie sich den Absendernamen (Ihr Markenname, bis zu 28 Zeichen).

Schritt 2 — In LeadHub konfigurieren

  1. Gehen Sie zu Einstellungen → Kommunikation → Messaging-Anbieter.

  2. Erweitern Sie Viber und füllen Sie aus:

    FeldWert
    AktiviertEinschalten
    Auth-TokenAus dem Viber-Partnerportal
    AbsendernameIhr Markenname
  3. Klicken Sie auf Einstellungen speichern.

  4. Kopieren Sie die Eingehende Webhook-URL und registrieren Sie sie in Ihrem Viber-Servicekonto-Dashboard.


Sprache / Click-to-Call (Twilio Voice)

Twilio Voice ermöglicht Ein-Klick-Anrufe direkt von der Detailseite eines Leads. Anrufe werden im Anrufverlauf protokolliert und können aufgezeichnet und automatisch transkribiert werden.

Voraussetzung: SMS (Twilio) muss zuerst konfiguriert werden — Voice verwendet dieselbe Account SID und dasselbe Auth Token.

Schritt 1 — In LeadHub konfigurieren

Gehen Sie zu Einstellungen → Kommunikation → Messaging-Anbieter, erweitern Sie Sprache (Twilio Voice) und füllen Sie die Felder aus. Klicken Sie auf Einstellungen speichern — drei URLs erscheinen: TwiML-URL, Status-URL und Aufzeichnungs-URL.

Schritt 2 — Webhooks in Twilio registrieren

Gehen Sie zu Ihrer Voice-Nummer in Twilio und tragen Sie die drei URLs in den entsprechenden Feldern ein.


Fehlerbehebung

ProblemLösung
"Einstellungen einmal speichern, um die eingehende Webhook-URL zu generieren"Noch nicht gespeichert — Anmeldedaten ausfüllen und zuerst Speichern klicken
WhatsApp-Webhook-Überprüfung schlägt fehlSicherstellen, dass das Verify Token in Meta mit dem bei der Einrichtung verwendeten übereinstimmt
Telegram-Nachrichten kommen nicht anLeadHub registriert den Webhook automatisch — prüfen Sie, ob das Bot-Token korrekt ist
SMS-Test schlägt fehlBestätigen Sie, dass das Auth Token korrekt ist und Ihre Twilio-Nummer aktiv ist
Sprachanrufe werden nicht verbundenSicherstellen, dass TwiML- und Status-URLs beide in Twilio registriert sind
Token erscheinen maskiert (••••••••••••)Dies ist beabsichtigt — bestehende Geheimnisse werden aus Sicherheitsgründen maskiert. Unverändert lassen, um das gespeicherte Geheimnis zu behalten.