Skip to main content
Qargo

Integrationen – WhatsApp-Konfiguration

WhatsApp-Integration mit Qargo: Diese Anleitung beschreibt die erforderlichen Voraussetzungen und Schritte zur Einrichtung der Integration.

Inhaltsverzeichnis
  1. WhatsApp-Integration konfigurieren

WhatsApp-Integration konfigurieren

Diese Anleitung beschreibt, wie das WhatsApp-Business-Konto über den eingebetteten Registrierungsablauf der TMS-Plattform eingerichtet wird. Mit diesem Prozess kann ein Transportunternehmen:

  • Ein eigenes WhatsApp-Business-Konto (WABA) erstellen und verwalten
  • Nachrichten an Fahrer senden und die Kommunikation in großem Umfang verwalten
  • Die volle Eigentümerschaft und Kontrolle über die eigenen WhatsApp-Business-Ressourcen behalten

Zeitaufwand: ca. 15–30 Minuten

Jeden Abschnitt sorgfältig lesen, um eine erfolgreiche Einrichtung sicherzustellen.

Voraussetzungen

Vor Beginn der eingebetteten Registrierung sicherstellen, dass Folgendes vorhanden ist:

1. Meta-Business-Konto

2. Gültige Telefonnummer

  • Eine eigene geschäftliche Telefonnummer für WhatsApp

  • Die Nummer muss SMS oder Sprachanrufe zur Verifizierung empfangen können

  • Es kann eine Festnetznummer sein (z. B. mit 09 beginnend in Belgien)

  • Die Nummer darf derzeit nicht bei der WhatsApp Business App oder einem privaten WhatsApp registriert sein

  • Bei Verwendung einer bestehenden WhatsApp-Nummer muss das WhatsApp-Konto zuerst gelöscht werden

Falls keine Telefonnummer verfügbar ist, die nicht mit einem bestehenden WhatsApp-Konto verknüpft ist, empfiehlt sich eine eSIM (sofern das Telefon dies unterstützt). Die eSIM muss mit einer Telefonnummer verknüpft sein; reine Daten-eSIMs funktionieren nicht. Eine weitere Möglichkeit ist eine zweite physische SIM-Karte.

3. Unternehmensinformationen bereithalten

  • Offizieller Firmenname
  • Geschäftsadresse
  • URL der Unternehmenswebsite
  • Geschäftliche E-Mail-Adresse
  • Unternehmenskategorie (z. B. „Transport/Logistik“)

4. Dokumente zur Unternehmensverifizierung (für vollen Zugriff)

  • Dokumente zur Unternehmensregistrierung
  • Steuer-Identifikationsnummern
  • Versorgerrechnungen oder Kontoauszüge (zur Adressverifizierung)

5. Technische Voraussetzungen

  • Aktueller Webbrowser (Chrome, Firefox, Safari oder Edge)
  • Stabile Internetverbindung
  • Pop-up-Blocker für den Registrierungsprozess deaktiviert :::
Checkliste vor dem Onboarding

Diese Aufgaben vor Beginn der eingebetteten Registrierung abschließen:

  • [ ] Telefonnummer vorbereiten

    • Bei Verwendung einer bestehenden WhatsApp-Nummer das Konto in der WhatsApp-App löschen
    • Sicherstellen, dass die Nummer SMS oder Sprachanrufe empfangen kann
  • [ ] Zwei-Faktor-Authentifizierung deaktivieren

    • Falls die Nummer zuvor mit WhatsApp verwendet wurde, sicherstellen, dass die 2FA deaktiviert ist
    • Dies ist über Einstellungen > Account > Verifizierung in zwei Schritten in WhatsApp möglich
  • [ ] Zugriff auf den Meta Business Manager prüfen

    • Bei https://business.facebook.com anmelden
    • Sicherstellen, dass Admin-Zugriff auf den richtigen Business Manager besteht
    • Hinweis: Verifizierte Business Manager können mehr als 2 Telefonnummern haben
  • [ ] Unternehmensinformationen vorbereiten

    • Alle Unternehmensdaten griffbereit halten
    • Sicherstellen, dass die Website aktiv und erreichbar ist
    • Eine Unternehmensbeschreibung vorbereiten (für die Profileinrichtung)
  • [ ] Browser-Cache leeren

    • Cookies und Cache für Facebook-/Meta-Domains leeren
    • Werbeblocker vorübergehend deaktivieren
Eingebettete Registrierung Schritt für Schritt

Schritt 1: Eingebettete Registrierung starten

  1. Mit einem Admin-Konto bei Qargo anmelden

  2. Zu Konfiguration > Organisationseinstellungen > WhatsApp-Integration navigieren

  3. Auf „WhatsApp-Business-Konto verknüpfen“ klicken

  4. Es erscheint die Schaltfläche „Mit Facebook anmelden“. Darauf klicken, um zu beginnen

Schritt 2: Bei Meta authentifizieren

  1. Bei Facebook/Meta anmelden

    • Die Facebook-Zugangsdaten eingeben

      • Gegebenenfalls ist eine Zwei-Faktor-Authentifizierung erforderlich
    • Das Konto verwenden, das Admin-Zugriff auf den Meta Business Manager hat

  2. Berechtigungen erteilen

    • Auf „Loslegen“ klicken, um das Konto zu verbinden

    • Die angeforderten Berechtigungen prüfen

    • Auf „Weiter“ klicken, um fortzufahren

Schritt 3: Business-Portfolio auswählen oder erstellen

  1. Business-Portfolio auswählen
    • Das bestehende Meta-Business-Portfolio aus der Dropdown-Liste auswählen
    • Oder ein neues erstellen, wenn es sich um die erste Einrichtung handelt

Entscheidend: Den Business Manager sorgfältig auswählen, da er nach der Registrierung der Nummer nicht mehr geändert werden kann.

Schritt 4: WhatsApp-Business-Konto einrichten

Es gibt zwei Möglichkeiten:

Option A: Neues WABA erstellen (Erstnutzer)
  1. „Neues WhatsApp-Business-Konto erstellen“ auswählen

  2. Folgende Informationen eingeben:

    • Name des WhatsApp-Business-Kontos: Name des Unternehmens
    • Anzeigename für WhatsApp Business: Für Kunden sichtbarer Name
    • Kategorie: „Transport“ oder die passendste Kategorie auswählen
  3. Auf „Weiter“ klicken

Option B: Bestehendes WABA verwenden (wiederkehrende Nutzer)
  1. Das bestehende WABA aus der Dropdown-Liste auswählen
  2. Ein neues WhatsApp-Business-Profil für die neue Nummer erstellen
  3. Auf „Weiter“ klicken

Schritt 5: Telefonnummer hinzufügen und verifizieren

  1. Telefonnummer eingeben

    • Internationales Format mit Ländervorwahl verwenden (z. B. +1234567890)
    • Keine Leerzeichen oder Sonderzeichen eingeben
  2. Verifizierungsmethode auswählen

    • SMS (empfohlen): Ein 6-stelliger Code wird per SMS gesendet
    • Sprachanruf: Der Verifizierungscode wird per Anruf übermittelt
  3. Verifizierungscode eingeben

    • Den erhaltenen 6-stelligen Code eingeben
    • Zur Bestätigung auf „Bestätigen“ klicken

Fehlerbehebung: Wenn der Code nicht innerhalb von 5 Minuten eintrifft, die alternative Verifizierungsmethode verwenden.

Schritt 6: Unternehmensprofil konfigurieren

  1. Unternehmensinformationen

    • Firmenlogo hochladen (empfohlen: 640x640 px, PNG oder JPG)
    • Unternehmensbeschreibung hinzufügen (bis zu 512 Zeichen)
    • Geschäftszeiten auswählen (optional)
    • URL der Unternehmenswebsite hinzufügen
  2. Kontaktinformationen

    • Geschäftliche E-Mail-Adresse bestätigen
    • Bei Bedarf weitere Kontaktmöglichkeiten hinzufügen
  3. Prüfen und bestätigen

    • Alle eingegebenen Informationen prüfen
    • Auf „Fertig“ klicken, um die Einrichtung abzuschließen

Schritt 7: Einrichtung der Integration abschließen

Nach der Verifizierung durch Meta erfolgt die Weiterleitung zurück zur TMS-Plattform:

  1. Telefonnummer bestätigen

    • Prüfen, ob die Telefonnummer korrekt angezeigt wird
  2. PIN erstellen

    • Eine 6-stellige PIN für zukünftige administrative Aktionen festlegen

Bei einer erneuten Authentifizierung muss dieselbe hier gewählte PIN angegeben werden. Daher ist es wichtig, sie sich zu merken.

Um die PIN für die Verifizierung in zwei Schritten eines WhatsApp-Business-Kontos zu ändern, den WhatsApp Manager öffnen, zu Kontotools > Telefonnummern navigieren und die betreffende Telefonnummer auswählen. Dort die Einstellungen zur Verifizierung in zwei Schritten öffnen und die Option „PIN ändern“ wählen. :::

Einrichtung nach dem Onboarding

1. Gültige Zahlungsmethode hinzufügen

Um Vorlagennachrichten zum Eröffnen von Unterhaltungen mit Fahrern zu senden, muss dem WhatsApp-Business-Konto eine gültige Zahlungsmethode hinzugefügt werden. Dies erfolgt im Facebook-Abrechnungsbereich: https://business.facebook.com/billing_hub. Unter Zahlungsmethoden > WhatsApp-Business-Konten anschließend das eigene Business-Konto auswählen:

2. Unternehmensverifizierung abschließen (innerhalb von 30 Tagen)

Um den vollen Funktionsumfang für Nachrichten freizuschalten:

  1. Den Meta Business Manager öffnen: https://business.facebook.com

  2. Zu Unternehmenseinstellungen > Unternehmensinfo navigieren

  3. Auf „Verifizierung starten“ klicken

  4. Die erforderlichen Dokumente einreichen:

    • Nachweis der Unternehmensregistrierung
    • Steuerdokumente
    • Versorgerrechnungen oder Kontoauszüge

:::

Fehlerbehebung

1. Verifizierung der Telefonnummer schlägt fehl

Problem: Der Verifizierungscode kommt nicht an
Lösungen:

  • Sicherstellen, dass die Nummer SMS/Anrufe empfangen kann
  • Alternative Verifizierungsmethode verwenden
  • Prüfen, ob die Nummer vom Mobilfunkanbieter gesperrt ist

2. Business Manager nicht verifiziert

Problem: Begrenzung auf 2 Telefonnummern
Lösung:

  • Unternehmensverifizierung im Meta Business Manager abschließen
  • Alle erforderlichen Dokumente einreichen
  • Für die Prüfung 2–3 Werktage einplanen

4. Sitzungs-Timeout

Problem: Die Sitzung der eingebetteten Registrierung läuft ab
Lösung:

  • Registrierung innerhalb von 60 Minuten abschließen
  • Alle Informationen vor dem Start bereithalten
  • Bei Bedarf Browser-Cache leeren und neu starten

5. Nummer bereits registriert

Problem: Die Telefonnummer ist bereits mit WhatsApp verknüpft
Lösung:

  • Zuerst das bestehende WhatsApp-Konto löschen
  • 24 Stunden warten, bevor die Registrierung erneut versucht wird
  • Den bisherigen Anbieter kontaktieren, um die Nummer freizugeben (falls zutreffend)
FAQs

Warum ist für die WhatsApp-Integration ein Facebook-Konto erforderlich?

WhatsApp gehört zu Meta (ehemals Facebook), daher ist für die Authentifizierung ein Facebook-Konto erforderlich. Das Facebook-Konto, mit dem das WhatsApp-Business-Konto eingerichtet wird, wird zum Admin-Konto und ermöglicht die Verwaltung der WhatsApp-Business-Einstellungen. Als Admin können weitere Konten mit unterschiedlichen Rollen zum WhatsApp-Business-Konto hinzugefügt werden.

Ist eine neue Telefonnummer erforderlich?

Das hängt von der aktuellen Situation ab:

  • Wenn das Unternehmen bereits eine geschäftliche Telefonnummer hat, die nicht mit einem WhatsApp-Konto verknüpft ist, kann diese bestehende Nummer verwendet werden
  • Wenn die Nummer bereits mit einem WhatsApp-Konto verknüpft ist, wird eine neue Nummer benötigt
  • Für Tests oder die Implementierung ohne Kauf eines zweiten physischen Telefons wird eine eSIM empfohlen, sofern das Gerät eSIM und physische SIM gleichzeitig unterstützt

Wie lässt sich der Zugriff auf das WhatsApp-Business-Konto innerhalb des Unternehmens teilen?

Sobald das WhatsApp-Business-Konto von einem Admin eingerichtet wurde, kann dieser Admin weiteren Teammitgliedern Zugriff gewähren, indem sie über den Meta Business Manager mit passenden Rollen hinzugefügt werden. So können mehrere Teammitglieder Unterhaltungen verwalten, ohne Telefone teilen zu müssen.
Diese Ergänzung soll die häufigsten Fragen klären, die während der Einrichtung auftreten, und ähnlichen Fragen in Zukunft vorbeugen.

Fehlermeldung „Maximale Anzahl an Telefonnummern erreicht“

Ein nicht verifiziertes WhatsApp-Business-Konto kann maximal 2 verknüpfte Telefonnummern haben. Um eine weitere hinzuzufügen, gibt es folgende Möglichkeiten:

  • Das WhatsApp-Business-Konto verifizieren
  • Eine der bestehenden Nummern entfernen

Fallen Kosten für Nachrichten an Fahrer an?
Qargo erhebt keine Gebühren für die Nutzung der WhatsApp-Integration. Es können jedoch WhatsApp-Gebühren anfallen, die direkt an Meta gezahlt werden.

  • Wenn der Fahrer die erste Nachricht sendet, können innerhalb von 24 Stunden kostenlos Nachrichten gesendet und empfangen werden. Jede Nachricht des Fahrers setzt diesen Zeitraum neu in Gang.

    • Der gesamte Unterhaltungsverlauf bleibt in der App erhalten.
  • Wenn ein Qargo-Nutzer eine „Vorlagennachricht“ sendet, um eine Unterhaltung mit einem Fahrer zu beginnen, fällt eine WhatsApp-Gebühr an (2 Cent).

    • Diese wird der Kreditkarte belastet, die mit dem Meta-Business-Konto verknüpft ist.

Fahrern in Qargo über WhatsApp Nachrichten senden