Wie verbinde ich meine WhatsApp-Nummer über die offizielle API (Cloud API)?

Um Ihre WhatsApp-Nummer über die offizielle API (Cloud API) zu verbinden, müssen Sie zunächst den Prozess auf der Papo-Plattform (https://papo.global/) starten, indem Sie einen neuen Posteingang vom Typ „WhatsApp – Cloud API (Meta)“ erstellen. Anschließend müssen Sie eine Anwendung und eine Telefonnummer im Meta Business Manager konfigurieren, um die Anmeldeinformationen (Telefonnummern-ID, Business-Konto-ID und Zugriffstoken) zu erhalten, die dann in Papo eingegeben werden, um die Verbindung abzuschließen.

Die Integration über die offizielle WhatsApp API, auch bekannt als Cloud API, ist die robusteste und skalierbarste Lösung für Unternehmen, die ihren Kundenservice auf diesem Kanal professionalisieren möchten. Im Gegensatz zur WhatsApp Business App ermöglicht die API mehreren Mitarbeitern die Nutzung derselben Nummer und bietet erweiterte Automatisierungen mit KI sowie Integrationen mit anderen Systemen wie CRMs und ERPs.

Papo Global erleichtert diese Verbindung, indem es Sie durch den Prozess führt und WhatsApp mit Ihren anderen Kommunikationskanälen in einem einzigen Posteingang vereint.

Voraussetzungen für die Verbindung

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes besitzen:

1. Ein Papo Global-Konto: Sie benötigen Zugang zum Papo-Dashboard, um die Konfiguration zu starten.
2. Ein Meta Business Manager-Konto (Facebook Business Manager): Ihr Unternehmen muss auf der Meta-Plattform konfiguriert und idealerweise verifiziert sein.
3. Eine exklusive Telefonnummer: Die Nummer, die Sie verbinden möchten, darf nicht in einem WhatsApp-App- oder WhatsApp Business-Konto aktiv sein. Falls doch, müssen Sie zuerst das mit dieser Nummer verknüpfte WhatsApp-Konto löschen, bevor Sie den Migrationsprozess zur API starten.

Schritt-für-Schritt-Anleitung zur Verbindung der WhatsApp API

Der Prozess ist in Schritte unterteilt, die sowohl auf der Papo-Plattform als auch in der Meta-Umgebung stattfinden.

Schritt 1: Konfiguration in Papo Global starten

Der erste Schritt ist, in Papo zu signalisieren, dass Sie einen neuen WhatsApp-Kanal über die offizielle API hinzufügen möchten.

1. Greifen Sie auf das Papo-Dashboard zu und gehen Sie zu Einstellungen → Posteingänge.
2. Klicken Sie auf die Schaltfläche „Neuen Posteingang hinzufügen“.
3. Wählen Sie in der Kanalliste die Option „WhatsApp – Cloud API (Meta)“.
4. Sie werden zu einem Konfigurationsbildschirm weitergeleitet. Lassen Sie diesen Tab geöffnet, da Sie ihn benötigen, nachdem Sie alles bei Meta konfiguriert haben.

Schritt 2: Eine Anwendung in Meta erstellen und konfigurieren

Nun wechseln wir zur Meta-Entwicklerumgebung, um die notwendige Struktur zu erstellen.

1. Greifen Sie auf das Portal Meta for Developers zu.
2. Klicken Sie auf „App erstellen“.
3. Wählen Sie den App-Typ „Unternehmen“ und klicken Sie auf „Weiter“.
4. Geben Sie Ihrer Anwendung einen Namen (z.B. Papo Support [Name des Unternehmens]) und verknüpfen Sie sie mit Ihrem Meta Business Manager-Konto.
5. Nachdem Sie die App erstellt haben, scrollen Sie im Haupt-Dashboard nach unten und suchen Sie das Produkt „WhatsApp“. Klicken Sie auf „Einrichten“.

Schritt 3: Telefonnummer hinzufügen und verifizieren

Innerhalb der WhatsApp-Produktkonfiguration in Ihrer Anwendung müssen Sie die zu verwendende Telefonnummer verknüpfen und verifizieren.

1. Befolgen Sie die Anweisungen, um Ihr Meta-Konto zu verbinden.
2. Im API-Konfigurationsbereich gibt es einen Schritt zum Hinzufügen einer Telefonnummer.
3. Geben Sie die Telefonnummer ein, die Sie verwenden möchten (denken Sie daran: sie darf nicht in einer anderen WhatsApp-App aktiv sein).
4. Wählen Sie eine Verifizierungsmethode (SMS oder Sprachanruf) und geben Sie den erhaltenen Code ein, um den Besitz der Nummer zu bestätigen.

Schritt 4: API-Anmeldeinformationen abrufen

Mit der erstellten Anwendung und der verifizierten Nummer haben Sie bereits Zugriff auf die für die Integration erforderlichen Anmeldeinformationen. Diese befinden sich im WhatsApp-Konfigurationsbereich innerhalb Ihrer Anwendung bei Meta.

Die drei wesentlichen Informationen sind:

• Telefonnummern-ID: Der eindeutige Bezeichner Ihrer Nummer auf der Meta-Plattform.
• WhatsApp Business-Konto-ID (WABA ID): Der Bezeichner Ihres WhatsApp Business-Kontos.
• Zugriffstoken: Ein Schlüssel, der Papo autorisiert, im Namen Ihres Unternehmens mit der API zu kommunizieren.

Schritt 5: Verbindung in Papo Global abschließen

Kehren Sie zum Papo-Tab zurück, den Sie in Schritt 1 geöffnet gelassen haben.

1. Füllen Sie die Formularfelder mit den Informationen aus, die Sie von Meta erhalten haben:
   • Name des Posteingangs: Ein interner Name, um den Kanal zu identifizieren (z.B. "Offizielles WhatsApp").
   • Telefonnummern-ID.
   • WhatsApp Business-Konto-ID (WABA ID).
   • Zugriffstoken.
2. Klicken Sie auf „Speichern“ oder „Posteingang erstellen“.

Fertig! Nach dem Speichern stellt Papo die Verbindung her. In wenigen Augenblicken ist Ihre offizielle WhatsApp-Nummer verbunden und bereit, Nachrichten direkt über Ihren vereinheitlichten Posteingang zu empfangen und zu senden.

Schritt 6: Nachrichtenvorlagen (Templates) erstellen

Um Gespräche mit Ihren Kunden zu initiieren oder Benachrichtigungen nach 24 Stunden seit deren letzter Interaktion zu senden, erfordert WhatsApp die Verwendung von Nachrichtenvorlagen (auch bekannt als HSM).

1. Gehen Sie in Ihrem Meta Business Manager zum WhatsApp Manager.
2. Navigieren Sie zum Bereich Nachrichtenvorlagen.
3. Klicken Sie auf „Vorlage erstellen“ und folgen Sie den Anweisungen, um Kategorie, Namen, Sprache und Inhalt Ihrer Nachricht festzulegen.
4. Senden Sie die Vorlage zur Genehmigung ein. Die Genehmigung dauert in der Regel einige Minuten bis Stunden.

Häufig gestellte Fragen (FAQ)

Kann ich meine aktuelle WhatsApp Business-Nummer verwenden?

Nicht gleichzeitig. Um eine Nummer in der offiziellen API zu verwenden, müssen Sie zuerst das damit verbundene WhatsApp Business- oder persönliche Konto löschen. Dadurch wird die Nummer für die Registrierung in der API freigegeben. Der Chatverlauf der App wird nicht migriert, daher empfehlen wir, vorab ein Backup zu erstellen, falls Sie alte Nachrichten einsehen müssen.

Was passiert, wenn ich keine Nachrichtenvorlage verwende?

Sie können nur Freiform-Nachrichten (ohne Vorlage) senden, wenn der Kunde das Gespräch initiiert oder auf eine Ihrer Nachrichten innerhalb der letzten 24 Stunden geantwortet hat. Außerhalb dieses „24-Stunden-Fensters“ muss jede vom Unternehmen initiierte Nachricht zwingend eine von Meta vorab genehmigte Vorlage verwenden.

Ist die Verbindung zur offiziellen API kostenpflichtig?

Ja. Meta berechnet die Nutzung der offiziellen API basierend auf einem Konversationsmodell. Die ersten 1.000 Service-Konversationen pro Monat sind in der Regel kostenlos. Hinzu kommen die Kosten für das Abonnement der Papo-Plattform, die die Oberfläche, das CRM, die KI und die Automatisierungen bereitstellt. Für Details zu den Meta-Preisen konsultieren Sie bitte deren offizielle Dokumentation.

Was ist die WABA ID?

WABA steht für „WhatsApp Business Account“. Die WABA ID ist der eindeutige Bezeichner Ihres WhatsApp Business-Kontos. Über dieses Konto verwalten Sie Ihre Telefonnummern, Nachrichtenvorlagen und überprüfen die Nutzungsmetriken.

Wie lange dauert es, bis Meta meine Nachrichtenvorlagen genehmigt?

Die Genehmigungszeit kann variieren. Viele Vorlagen, insbesondere transaktionale (wie Bestellbestätigungen oder Terminerinnerungen), werden innerhalb weniger Minuten automatisch genehmigt. Werbevorlagen oder solche mit komplexerem Inhalt können einige Stunden für eine manuelle Überprüfung benötigen.

Wo verwalte ich die Agenten, die Zugriff auf diesen Posteingang haben?

Nachdem Sie den Posteingang in Papo erstellt haben, können Sie im Tab „Agenten“ innerhalb der Posteingangseinstellungen festlegen, welche Mitglieder Ihres Teams die Berechtigung haben, die über diese Nummer eingehenden Gespräche anzuzeigen und zu beantworten.

Kostenlos starten →

Der erste Benutzer ist kostenlos und beinhaltet Zugang zu KI, vollständigem CRM und mehreren Kanälen.