MMS-Nachrichten mit Node.js versenden

Mit der Vonage Messages API können Sie jetzt MMS (Multimedia Messaging Service) aus den USA versenden 10DLC, TFN und Shortcode Numbers, die Sie in Ihrem Dashboard haben, an andere Numbers innerhalb der Vereinigten Staaten zu senden.

In diesem Artikel erfahren Sie, wie Sie eine MMS mit Node.js unter Verwendung der offiziellen vonage-node-sdk Client-Bibliothek.

Voraussetzungen

Bevor Sie beginnen, vergewissern Sie sich, dass Sie die folgenden Informationen haben:

• Ein grundlegendes Verständnis von JavaScript und Node.js.

• Node.js ist auf Ihrem Rechner installiert.

• Eine neue SMS- und MMS-fähige US-Nummer. Sie können sich auf unseren Numbers-Leitfaden erfahren Sie, wie Sie eine Numbers kaufen können, wenn Sie noch keine haben.

Hinweis: MMS-Nachrichten können nur für A2P-Anwendungen (Application to Person) verwendet werden. Die Vonage Messages API kann nicht verwendet werden, um MMS-Nachrichten von einer virtuellen Nummer zu einer anderen virtuellen Nummer zu senden.

Vonage API-Konto

Um dieses Tutorial durchzuführen, benötigen Sie ein Vonage API-Konto. Wenn Sie noch keines haben, können Sie sich noch heute anmelden und mit einem kostenlosen Guthaben beginnen. Sobald Sie ein Konto haben, finden Sie Ihren API-Schlüssel und Ihr API-Geheimnis oben auf dem Vonage-API-Dashboard.

In diesem Lernprogramm wird auch eine virtuelle Telefonnummer verwendet. Um eine zu erwerben, gehen Sie zu Rufnummern > Rufnummern kaufen und suchen Sie nach einer Nummer, die Ihren Anforderungen entspricht.

Sind Sie bereit, mit dem Bau zu beginnen?

Erleben Sie nahtlose Konnektivität, Echtzeit-Messaging und kristallklare Sprach- und Videoanrufe - alles auf Knopfdruck.

Erste Schritte

Bevor wir beginnen, sollten wir einige Dinge im Vonage Dashboard erledigen, um erfolgreich zu sein.

Beginnen wir mit der Erstellung einer neuen Nachrichtenanwendung. Gehen Sie dazu in Ihrem Admin-Dashboard in den Abschnitt Anwendung Ihrer Verwaltungskonsole und klicken Sie auf Eine neue Anwendung erstellen.

Your applications page

Als nächstes müssen Sie das Formular mit dem Namen Ihrer Anwendung und den erforderlichen Webhook-URLs ausfüllen.

Für jede Anwendung von Messages müssen Sie eine Status URL und eine Inbound URL. In größeren, produktionsreifen Applications würden diese auf eine URL auf Ihrem eigenen Server verweisen.

Das ist in diesem Tutorial nicht nötig; Sie brauchen eine URL, die mit einem 200 OK Status antworten kann. Sie können einen Dienst wie MockBin oder verwenden. ngrok verwenden, um das bereitzustellen, was Sie brauchen.

Um MockBin in diesem Beispiel zu verwenden, können Sie:

1. Gehen Sie zum MockBin Website und klicken Sie auf die grüne Schaltfläche mit der Aufschrift "Create Bin".

2. Belassen Sie im Bin Builder die voreingestellten Informationen, die den Statuscode 200 OK enthalten, und klicken Sie unten auf Bin erstellen.

3. Dadurch wird eine URL erzeugt, die wie https://mockbin.org/bin/2f27d0d5-6f2e-4a39-8dd5-918c4848a4c7/view aussieht. Kopieren Sie die URL bis vor /view und fügen Sie sie im Vonage Dashboard unter der Nachrichtenfunktion sowohl in der Eingangs- als auch in der Status-URL ein, wie in der Abbildung unten dargestellt.

Message capability with added URLs

Um API-Anfragen neben Ihrem API-Schlüssel und API-Geheimnis zu authentifizieren, benötigen Sie auch ein öffentliches/privates Schlüsselpaar, das automatisch für Sie generiert werden kann, indem Sie auf die Schaltfläche öffentliches/privates Schlüsselpaar generieren wie in der Abbildung unten dargestellt.

Generate Public and Private Key

Dadurch wird ein öffentlicher Schlüssel in das Formularfeld eingetragen und außerdem eine private.key Datei auf Ihren Rechner herunter. Sie müssen diese Datei in dem Verzeichnis ablegen, das wir in Kürze erstellen werden.

Klicken Sie abschließend auf Erstellen Sie eine neue Anwendung. Sie werden dann aufgefordert, eine Nummer für diese Anwendung auszuwählen, indem Sie auf die Schaltfläche Link neben der Nummer Ihrer Wahl klicken. Wenn Sie keine Numbers auf Ihrem Dashboard haben, können Sie diese dort oder über die Kommandozeile mit der Vonage CLI.

Notieren Sie sich die Anwendungs-ID. Sie wird Ihren API-Schlüssel, das API-Geheimnis und den privaten Schlüssel in dem Code verbinden, an dem wir als nächstes arbeiten werden.

MMS-Versand mit Node.js

Jetzt, wo die Administration abgeschlossen ist, können wir ein Node.js-Skript erstellen, das das Vonage Server SDK für Node.js verwendet, um bei der Ausführung eine MMS an eine voreingestellte Nummer zu senden.

Erstellen Sie zunächst einen neuen Ordner (und legen Sie, falls noch nicht geschehen, die private.key Datei in diesen Ordner.

Führen Sie im Terminal die folgenden Befehle aus, um eine neue Node.js-Anwendung einzurichten und die vonage-node Client-Bibliothek in einem neuen Ordner für Ihr Projekt zu installieren.

npm init -y
npm install -g @vonage/cli

Erstellen Sie dann eine neue Datei mit dem Namen send-mms.jsund öffnen Sie sie in Ihrem Editor.

Initialisieren Sie eine neue Vonage-Instanz:

const { Messages, MMSImage } = require("@vonage/messages");

const messageClient = new Messages({
  apiKey: VONAGE_API_KEY, // Found in your Vonage Dashboard
  apiSecret: VONAGE_API_SECRET, // Found in your Vonage Dashboard
  applicationId: VONAGE_APPLICATION_ID, // Generated earlier
  privateKey: VONAGE_APPLICATION_PRIVATE_KEY_PATH // Generated earlier it could be e.g. ./private.key
});

Fügen Sie schließlich den Code zum Senden der MMS-Nachricht mithilfe der Messages API hinzu:

const image = new MMSImage({
  image: {
    url: "https://placekitten.com/200/30",
    caption: "placeholder image"
  },
  to: "TO_NUMBER", // Add the phone number sending the message
  from: "FROM_NUMBER", // Add the phone number receiving the nmessage
});

messageClient
  .send(image)
  .then((resp) => console.log(resp))
  .catch((err) => console.error(error));

Der obige Code sendet eine einzige Nachricht (ein Bild einer Katze) an eine beliebige Nummer, die Sie dem ersten Objekt hinzufügen. Wenn das Senden der Nachricht aus irgendeinem Grund fehlschlägt, werden die Probleme in der Konsole protokolliert; wenn alles funktioniert, wird stattdessen die messageUUID stattdessen protokolliert werden.

Anmerkungen:

1. https://placekitten.com/200/300' ist ein Platzhalterbild, das Sie verwenden können.

2. Der Wert für url muss eine öffentlich zugängliche URL sein, die zu einer Datei auflöst.

3. Die unterstützten Dateitypen sind.jpg, .jpeg, und .png.

Gehen Sie dann zum Terminal Ihrer Wahl und starten Sie:

node send-mms.js

Wie geht es jetzt weiter?

Manchmal kann es vorkommen, dass eine MMS-Nachricht aus den unterschiedlichsten Gründen nicht an den Empfänger zugestellt werden kann. Dispatch API experimentieren und einen Failover-Mechanismus entwickeln, der prüft, ob die MMS zugestellt wurde, und falls nicht, würde Ihre Anwendung stattdessen eine Standard-SMS mit einem Link zu dem gewünschten Bild senden.

Teilen Sie uns mit, was Sie mit MMS bauen

Beteiligen Sie sich am Gespräch auf unserem Vonage Community Slack oder senden Sie uns eine Nachricht auf X, früher bekannt als Twitter.