Ausgehende Voice und SMS mit Vonage über Glitch erstellen

In diesem Tutorial zeigen wir Ihnen, wie Sie ausgehende Sprachanrufe integrieren und tätigen und ausgehende SMS mithilfe der Vonage-APIs mit Glitch und Node.js versenden können. Durch das Hinzufügen ausgehender Voice- und SMS-Funktionen kann Ihre Anwendung proaktive Interaktionen wie das Senden von Benachrichtigungen oder das Tätigen von Anrufen verarbeiten. Diese Integration verbessert die Nutzerbindung, indem sie eine automatisierte Kommunikation in Echtzeit über Ihre Anwendung ermöglicht.

Sind Sie bereit, eine noch interaktivere Anwendung zu erstellen? Los geht's!

Voraussetzungen

• Ein Vonage Entwickler-Konto

• Ein Glitch Account

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.

Sind Sie bereit, mit dem Bau zu beginnen?

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

Einrichten und Konfigurieren Ihres Projekts

Angenommen, Sie haben bereits einen Webhook für eingehende Sprachanrufe und eingehende SMS in Ihre Vonage-Anwendung integriert, dann fahren wir mit der Implementierung von ausgehenden Funktionen fort. Wenn Sie Hilfe bei der Einrichtung Ihres Webhooks und Ihrer Vonage-Anwendung benötigen, können Sie unser Tutorial unter Wie man Webhooks für eingehende SMS und Voice auf Glitch einrichtet.

Um die Anwendung zu implementieren, können Sie das Wissen aus dem Tutorial anwenden, um Folgendes einzustellen:

• private.key Datei

• Vonage-Rufnummer

• Vonage API-Schlüssel und Geheimnis

• Vonage-Anwendungs-ID

• Antwort-URL

Wir werden Sie durch die folgenden Schritte leiten:

1. Hinzufügen von Client-Code für ausgehende Voice-Anrufe und SMS

2. Abhängigkeiten installieren

3. Umgebungsvariablen festlegen

4. Testen Sie Ihre neuen Funktionen

Schritt 1: Client-Code für ausgehende Voice-Anrufe und SMS hinzufügen

Melden Sie sich bei Ihrem Glitch Account an.

Klicken Sie in Ihrem Glitch-Projekt auf das "+" neben Dateien.

Benennen Sie die Datei private.key und klicken Sie auf Diese Datei hinzufügen.

add fileÖffnen Sie in Ihrem bevorzugten Texteditor die private.key Datei, die Sie zuvor heruntergeladen haben. Kopieren Sie den Inhalt aus Ihrem Texteditor und fügen Sie ihn in die neu erstellte private.key Datei in Glitch ein.

Erstellen Sie auf ähnliche Weise eine neue Datei mit dem Namen makecall.js.

Fügen Sie den folgenden Code in die neu erstellte makecall.js Datei hinzu:

require('dotenv').config({ path: __dirname + '/../.env' });

const { Vonage } = require('@vonage/server-sdk');
const { NCCOBuilder, Talk, OutboundCallWithNCCO } = require('@vonage/voice')

const TO_NUMBER = process.env.TO_NUMBER;
const VONAGE_NUMBER = process.env.VONAGE_NUMBER;

const VONAGE_API_KEY = process.env.VONAGE_API_KEY;
const VONAGE_API_SECRET = process.env.VONAGE_API_SECRET;
const VONAGE_APPLICATION_ID = process.env.VONAGE_APPLICATION_ID;
const VONAGE_APPLICATION_PRIVATE_KEY_PATH = __dirname + "/" + process.env.VONAGE_APPLICATION_PRIVATE_KEY_PATH;

const vonage = new Vonage({
  apiKey: VONAGE_API_KEY,
  apiSecret: VONAGE_API_SECRET,
  applicationId: VONAGE_APPLICATION_ID,
  privateKey: VONAGE_APPLICATION_PRIVATE_KEY_PATH
});


async function makeCall() {
  const builder = new NCCOBuilder();
  builder.addAction(new Talk('This is a text to speech call from Vonage'));
  const resp = await vonage.voice.createOutboundCall(
    new OutboundCallWithNCCO(
      builder.build(),
      { type: 'phone', number: TO_NUMBER },
      { type: 'phone', number: VONAGE_NUMBER}
    )
  );
  console.log(resp);
}
makeCall();

Als nächstes erstellen Sie eine neue Datei mit dem Namen sendsms.js.

Fügen Sie den folgenden Code in die neu erstellte sendsms.js Datei hinzu:

require('dotenv').config({ path: __dirname + '/../.env' });

const VONAGE_API_KEY = process.env.VONAGE_API_KEY;

const VONAGE_API_SECRET = process.env.VONAGE_API_SECRET;

const TO_NUMBER = process.env.TO_NUMBER;

const VONAGE_NUMBER = process.env.VONAGE_NUMBER;

const { Vonage } = require('@vonage/server-sdk');

const vonage = new Vonage({

  apiKey: VONAGE_API_KEY,

  apiSecret: VONAGE_API_SECRET

});

const from = VONAGE_NUMBER;

const to = TO_NUMBER;

const text = 'Test message using the Vonage SMS API';

vonage.sms.send({ to, from, text })

  .then(resp => { console.log('Message sent successfully'); console.log(resp); })

  .catch(err => { console.log('Error sending message'); console.error(err); });

Schritt 2:Abhängigkeiten installieren

Öffnen Sie ein Terminal in Ihrem Glitch-Projekt.

Führen Sie den folgenden Befehl aus, um vorhandene Pakete zu aktualisieren:

npm update

Installieren Sie die erforderlichen Abhängigkeiten mit dem folgenden Befehl:

npm i express @fastify/express body-parser dotenv @vonage/server-sdk @vonage/voice

Führen Sie den refresh um die Änderungen zu übernehmen:

refresh

Schritt 3: Umgebungsvariablen festlegen

Öffnen Sie nun die .env Datei, die Sie auf der linken Seite in Glitch finden.

Fügen Sie die folgenden Variablennamen hinzu:

TO_NUMBER
VONAGE_NUMBER
VONAGE_API_KEY
VONAGE_APPLICATION_ID
VONAGE_API_SECRET
VONAGE_APPLICATION_PRIVATE_KEY_PATH

Geben Sie anschließend die folgenden Werte für diese Variablen ein:

• TO_NUMBER: Die Nummer für den Empfang von Anrufen und SMS (z. B. 14567891234).

• VONAGE_NUMBER: Die Nummer, die Ihrer Vonage-Anwendung zugewiesen ist (z. B. 14567891234).

• VONAGE_API_KEY und VONAGE_API_SECRET: Über das Vonage Dashboard.

• VONAGE_APPLICATION_ID: In den Einstellungen der Vonage-Anwendung.

• VONAGE_APPLICATION_PRIVATE_KEY_PATH: Eingestellt als private.key.

Environment variables

Schritt 4: Testen Sie Ihre neuen Funktionen

Ausgehende Voice-Anrufe testen

Öffnen Sie ein Terminal in Ihrem Glitch-Projekt.

Führen Sie diesen Befehl aus:

node makecall.js

Prüfen Sie die Vonage Dashboard-Protokolle um zu bestätigen, dass der Anruf erfolgreich getätigt wurde, und auch die Details.

Outbound Call LogAusgehende SMS testen

Nun, da Sie den Client-Code für ausgehende SMS hinzugefügt haben, können Sie ihn testen!

Führen Sie diesen Befehl aus:

node makecall.js

Überprüfen Sie die Vonage Dashboard-Protokolle, um zu bestätigen, dass die SMS erfolgreich gesendet wurde, und auch die Details.

Text Log DeliveredSie sehen die gleichen Informationen in Ihrem Terminal.

Schlussfolgerung

Und das war's! Sie haben soeben ausgehende Sprachanrufe und SMS über Vonage APIs in Glitch integriert. Durch das Hinzufügen dieser Kommunikationsfunktionen haben Sie die Möglichkeiten Ihrer Anwendung erweitert, Benutzer durch Sprach- und Nachrichtenübertragung anzusprechen. Wenn Sie dieses Tutorial für Ihre eigenen Projekte genutzt haben, würden wir uns freuen, wenn Sie uns davon berichten! Beteiligen Sie sich an der Diskussion auf unserem Vonage Community Slack oder senden Sie uns eine Nachricht auf X.