Erste Schritte mit der Messages API

Auf dieser Seite werden Sie durch alle notwendigen Schritte geführt, um die Vonage Messages API in Betrieb zu nehmen. Die Messages API bietet eine einfache Möglichkeit, Nachrichten an Ihre Kunden über mehrere beliebte Kanäle zu senden - SMS, MMS, RCS, WhatsApp, Facebook und Viber. Anstatt jede Plattform einzeln zu integrieren, können Sie sich einmal verbinden und alle Konversationen an einem Ort verwalten.

Folgen Sie zunächst dieser Anleitung, um Ihren Account und Ihre Anwendung zu erstellen. Navigieren Sie dann zum Leitfaden für die ersten Schritte für Ihr ausgewählte Kanäle um Ihr Onboarding abzuschließen.

Voraussetzungen

Bevor Sie Ihre erste Nachricht versenden, müssen Sie einen Account und eine Anwendung bei Vonage erstellen:

Vonage Account erstellen

So erstellen Sie Ihren kostenlosen Vonage Account:

  1. Navigieren Sie in Ihrem Browser zu Dashboard.
  2. Fügen Sie Ihre Unternehmensinformationen hinzu und klicken Sie auf Registrieren Sie sich. Vonage sendet eine PIN in Form einer Textnachricht oder eines automatischen Anrufs an Ihr Telefon. Die Zeitspanne für jeden Verifizierungsversuch beträgt 5 Minuten.
    Hinweis: Sie können eine Rufnummer nur mit einem Account verknüpfen. Wenn Ihre Telefonnummer bereits mit einem Vonage Account verbunden ist, sollten Sie diese Rufnummer entfernen aus dem bestehenden Account.
  3. Unter Überprüfung von Telefonnummerngeben Sie die PIN ein, die Sie von Vonage erhalten haben, und klicken Sie auf Verify. Sie werden im Dashboard angemeldet und erfahren, wie Sie mit der Entwicklung mit Vonage beginnen können. Diese Seite wird jedes Mal angezeigt, wenn Sie sich anmelden, bis Sie Ihren ersten erfolgreichen Anruf mit Vonage APIs getätigt haben.

Wenn Sie Ihren Vonage Account erstellen, erhalten Sie 2 € kostenloses Testguthaben und Ihr Account wird in den DEMO-Modus versetzt. Sie können unsere Produkte nutzen, um Nachrichten an bis zu 10 Zielnummern zu senden. Alle von Ihnen gesendeten SMS werden mit dem Hinweis versehen, dass sich Ihr Account im Demo-Modus befindet. So verlassen Sie den Demomodus Guthaben auf Ihr Konto aufladen.

Für einige wenige Länder kann Vonage nicht automatisch einen Account für Sie einrichten. Dies liegt an Zahlungsbeschränkungen oder gesetzlichen Handelsbeschränkungen für ein in den USA registriertes Unternehmen.

Erstellen einer Vonage API-Applikation

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

  1. Verwenden der Vonage CLI
  2. Verwendung des Dashboards

Jede dieser Methoden wird in den folgenden Abschnitten beschrieben.

So erstellen Sie eine Messages-Anwendung 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

Dadurch wird eine Vonage-API-Anwendung mit einer Nachrichten Fähigkeitmit den wie angegeben konfigurierten Webhook-URLs und erzeugen eine private Schlüsseldatei my_messages_app.key und erstellt oder aktualisiert die vonage_app.json Datei.

So erstellen Sie eine Nachrichten-Anwendung mit dem Dashboard

Sie können die Anwendung "Nachrichten" im Menü 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.

  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.

Kanalspezifische Abschnitte zu den ersten Schritten