Bereitstellung des WhatsApp-Einsatzes

Bevor Sie beginnen

Bevor Sie den WhatsApp-Cluster einrichten, müssen Sie einige Informationen aus dem Einstellungen Seite auf der WhatsApp Business Dashboard, einschließlich:

WhatsApp Business Account ID

  1. Navigieren Sie zu Ihrem geschäftliche Einstellungen Seite und wählen Sie Accounts > WhatsApp Accounts.
  2. Wählen Sie den WhatsApp Business Account, den Sie einrichten möchten.
  3. Die ID Ihres WhatsApp Business Accounts befindet sich oben auf der Seite, unterhalb des WhatsApp Business Account-Namens.

Telefon-Nummer

  1. Navigieren Sie zu Ihrem geschäftliche Einstellungen Seite und wählen Sie Accounts > WhatsApp Accounts.
  2. Wählen Sie den WhatsApp Business Account, den Sie einrichten möchten.
  3. Im Rahmen der Einstellungen Registerkarte, öffnen WhatsApp Manager > Telefonnummern.
  4. Suchen Sie die gewünschte Rufnummer in der Liste.

Zertifikat (in Verbindung mit Ihrer Telefonnummer)

  1. Navigieren Sie zu Ihrem geschäftliche Einstellungen Seite und wählen Sie Accounts > WhatsApp Accounts.
  2. Wählen Sie den WhatsApp Business Account, den Sie einrichten möchten.
  3. Im Rahmen der Einstellungen Registerkarte, öffnen WhatsApp Manager > Telefonnummern.
  4. Suchen Sie die gewünschte Rufnummer in der Liste.
  5. Klicken Sie auf die Siehe Taste (im Menü Zertifikat Spalte).
  6. Kopieren Sie das zugehörige Zertifikat in Ihre Zwischenablage und fügen Sie es in ein separates Dokument ein. Sie werden es in einem späteren Schritt benötigen.

Erstellen einer Vonage-Applikation

Eine Vonage API-Anwendung enthält die Sicherheits- und Konfigurationsinformationen, die Sie benötigen, um sich mit Vonage Endpunkten zu verbinden und die Vonage APIs zu nutzen. In diesem Fall müssen Sie eine Anwendung erstellen, die die Vonage Messages API verwendet.

Hinweis: Ihr WhatsApp Account muss mit Ihrem Vonage Account verbunden sein, bevor Sie ihn mit einer Vonage Anwendung verknüpfen können. Sie können Ihr WhatsApp-Konto mit Ihrem Vonage-Konto verbinden über die Vonage API Dashboard.

  • Sowohl CLI- als auch Dashboard-Beispiele sind hier

Erzeugen Sie Ihr JWT

TIPP: Sie müssen diesen Schritt nur durchführen, wenn Sie mit Curl testen, da die Client- und Server-SDKs JWTs nach Bedarf für Sie generieren.

Sobald Sie eine Vonage API Application erstellt haben, können Sie die Application ID und die private Schlüsseldatei verwenden, private.key, um ein JWT zu erzeugen.

Um ein JWT-Token zu erstellen, verwenden Sie die Vonage CLIverwenden Sie diesen Befehl

# A command with parameters
vonage jwt create `
--app-id='00000000-0000-0000-0000-000000000000' `
--private-key=./private.key

# Will produce a token
eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3MzYyODE5NDYsImp0aSI6IjBmZjcwZDNmLTAzN2EtNGY4MC04ODZjLWI3MmM3MmQyMWNmMiIsImlhdCI6MTczNjI4MTA0NiwiYXBwbGljYXRpb25faWQiOiIwMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDAifQ.gA7jClpqaZ2OoS0iri-zGCbda4jO7C0M8mka0EnSyjlds1EeY8fNoBEx3FTXHfkkzzrj0TskrWc_dcs1wuM8Kx55c5rLQ7taVpDAYopKSc_CeeOaad8S6aWnRkTUTNeduO4aIn-0CbyRTluBYsH1RBqYBQvobuQIDEwbFw8xBgx0UfREMMN6DAWknR57eiVXN9x_oD6CGQJ1yV3025nGboeMsP9YgX4Nwc-rE2r8c1ZGwCLO81x8i19Qil3Nwu5q1nzouyavQjIw00B_TZkushnI1ufdi_GNqk-h5q2HvGkg7Pj9bVkZHFdVTO8im03JYNyJmcV83vnpjOLuCFRzxQ

Alternativ können Sie auch unser JWT-Webanwendung um ein JWT zu erzeugen.

TIPP: Sie können Ihr generiertes JWT testen unter jwt.io

Bereitstellung WhatsApp-Einsatz

Schlüssel Beschreibung
country_code Die internationale Vorwahl der bereitzustellenden Nummer.
number Die bereitzustellende WhatsApp-Nummer.
vname_certificate Das Zertifikat können Sie über Ihr WhatsApp Business Dashboard abrufen. > HINWEIS: Jedes Mal, wenn Sie auf die Schaltfläche Siehe wird das Zertifikat geändert. Laden Sie Ihr Zertifikat entweder herunter oder kopieren Sie es, damit Sie es in einem späteren Schritt verwenden können.
method Die Methode zur Übermittlung des Einmalpassworts (OTP). Muss entweder sein sms oder voice.
waba_id Die WhatsApp Business Account ID der WhatsApp Nummer.
curl -X POST https://api.nexmo.com/v0.1/whatsapp-manager/deployments\
  -H "Authorization: Bearer "$JWT\
  -H "Content-Type: application/json"\
  -d '{
        "country_code": "44",
        "number": "7877001122",
        "vname_certificate": "CnQKMAj669nb79e",
        "method": "sms",
        "waba_id": "345676589250625"
      }'

Nach der Bereitstellung durchläuft der WhatsApp-Cluster die folgenden Bereitstellungsphasen: INITIALIZING, CREATING_CLUSTER und CLUSTER_CREATED. Wenn die CLUSTER_CREATED erreicht ist, wird ein OTP-Anruf oder eine SMS an die angegebene Nummer gesendet, und der Einsatzstatus wird CODE_SENT. Wenn das OTP empfangen wurde, rufen Sie die Verify-API auf, um den Vorgang abzuschließen.

OTP verifizieren

Schlüssel Beschreibung
code Das einmalige Passwort, das zur Überprüfung vorgelegt wird.
curl -X POST https://api.nexmo.com/v0.1/whatsapp-manager/$DEPLOYMENT_ID/verify\
  -H "Authorization: Bearer "$JWT\
  -H "Content-Type: application/json"\
  -d '{ "code": "$CODE" }'

Nachdem der WhatsApp-Cluster nun erfolgreich eingerichtet wurde, können Sie Ihre WhatsApp Business-Profil.

Referenz