Erstellen einer Anwendung für Vonage-Nachrichten und -Versand

In diesem Thema erfahren Sie, wie Sie eine Vonage API-Anwendung erstellen können.

Erstellen einer Vonage API-Applikation

Es gibt drei alternative Methoden zur Erstellung einer Nachrichten-Anwendung:

  1. Verwenden der Vonage CLI
  2. Verwendung des Dashboards
  3. Verwendung der Application API

Jede dieser Methoden wird in den folgenden Abschnitten beschrieben.

So erstellen Sie eine Messages-Applikation mit der Vonage CLI

Um Ihre Anwendung mit der Vonage CLI zu erstellen, geben Sie den folgenden Befehl in die Shell ein:

vonage apps:create "My Messages App" --messages_inbound_url=https://example.com/webhooks/inbound-message --messages_status_url=https://example.com/webhooks/message-status

Mit diesem Befehl wird eine Vonage API-Anwendung mit einer Nachrichten Fähigkeitund die Webhook-URLs werden wie angegeben konfiguriert. Es wird auch eine private Schlüsseldatei erzeugt my_messages_app.key und erstellt oder aktualisiert die vonage_app.json Datei.

Bewahren Sie den generierten privaten Schlüssel nach Abschluss des Befehls sicher auf. Die JWT-Authentifizierung für die Messages API hängt von diesem Schlüssel ab. Sollten Sie ihn verlieren, können Sie den ursprünglichen privaten Schlüssel nicht erneut herunterladen.

So erstellen Sie eine Nachrichten-Applikation mit dem Dashboard

Sie können eine Anwendung "Nachrichten" in der Dashboard.

So erstellen Sie Ihre Anwendung über das Dashboard:

  1. Unter Applications im Dashboard, klicken Sie auf die Schaltfläche Erstellen Sie eine neue Anwendung Taste.

  2. Unter Namegeben Sie den Namen der Applikation ein. Wählen Sie einen Namen, damit Sie ihn in Zukunft leichter finden.

  3. Klicken Sie auf die Schaltfläche Öffentlichen und privaten Schlüssel generieren. Dadurch wird ein öffentliches/privates Schlüsselpaar erstellt und der private Schlüssel wird von Ihrem Browser heruntergeladen.

    Bewahren Sie den heruntergeladenen privaten Schlüssel sicher auf. Die JWT-Authentifizierung für die Messages API hängt von diesem Schlüssel ab. Sollten Sie ihn verlieren, können Sie den ursprünglichen privaten Schlüssel nicht erneut herunterladen.

  4. Unter Fähigkeiten wählen Sie die Nachrichten Taste.

  5. In der Eingehende URL geben Sie die URL für Ihren Webhook für eingehende Nachrichten ein, zum Beispiel, https://example.com/webhooks/inbound-message.

  6. In der Status-URL geben Sie die URL für Ihren Nachrichtenstatus-Webhook ein, zum Beispiel, https://example.com/webhooks/message-status.

  7. Klicken Sie auf die Neue Anwendung generieren Schaltfläche. Sie gelangen nun zum nächsten Schritt des Verfahrens "Anwendung erstellen", wo Sie eine Vonage API-Nummer mit der Anwendung verknüpfen und externe Accounts wie Facebook mit dieser Anwendung verknüpfen können.

  8. Wenn es ein externes Konto gibt, mit dem Sie diese Anwendung verknüpfen möchten, klicken Sie auf die Schaltfläche Verknüpfte externe Konten und klicken Sie dann auf die entsprechende Registerkarte Link für den Account, den Sie verknüpfen möchten.

Sie haben nun Ihre Anwendung erstellt.

HINWEIS: Stellen Sie vor dem Testen Ihrer Anwendung sicher, dass Ihre Webhooks konfiguriert sind und Ihr Webhook-Server läuft.

Erstellen einer Messages-Applikation mit Hilfe der Application API

Mit der Application API können Sie eine Vonage Application programmatisch erstellen und konfigurieren - ohne das Dashboard oder die CLI zu verwenden. Eine über die Application API erstellte Vonage Application funktioniert genauso wie eine über das Dashboard erstellte.

Einen vollständigen Überblick über die Erstellung einer Vonage Application finden Sie unter Erstellen einer Vonage-Applikation.