Node.js

Konfigurieren Sie Ihre Voraussetzungen

Es gibt einige Voraussetzungen, die Sie erfüllen müssen, bevor Sie dieses Lernprogramm durcharbeiten können. Wenn Sie eine dieser Voraussetzungen bereits erfüllt haben, können Sie diesen Schritt überspringen.

Sie können einen Vonage Account über den Dashboard.

Über das Dashboard können Sie Applications erstellen und Vonage Numbers erwerben. Sie können diese Aufgaben auch über die Vonage CLI.

Folgen Sie den Schritten auf der Seite Erste Schritte mit Vonage CLI Seite zur Installation und Konfiguration der Befehlszeile.

Es gibt zwei Methoden zur Erstellung einer Sprachanwendung:

  1. Verwenden der Vonage CLI
  2. Verwendung des Dashboards

Jede dieser Methoden wird in den folgenden Abschnitten beschrieben.

So erstellen Sie eine Sprachanwendung mit der Vonage CLI

Um Ihre Anwendung mit der Vonage CLI zu erstellen, geben Sie den folgenden Befehl in die Shell ein und ersetzen ihn durch NGROK_HOST_NAME mit dem ngrok-Host, den Sie beim Einrichten von ngrok erhalten haben:

Um Ihre Anwendung zu erstellen, verwenden Sie die Vonage CLIgeben Sie den folgenden Befehl ein:

vonage apps create 'Your application'

✅ Creating Application
Saving private key ... Done!
Application created

Name: Your application
Application ID: 00000000-0000-0000-0000-000000000000
Improve AI: Off
Private/Public Key: Set

Capabilities:
  None Enabled

Fügen Sie dann Sprachfunktionen zu Ihrer Anwendung hinzu (verwenden Sie den Hostnamen aus ngrok anstelle von example.com)

vonage apps capabilities update 00000000-0000-0000-0000-000000000000 voice `
  --voice-answer-url='https://example.com/webhooks/voice/answer' `
  --voice-event-url='https://example.com/webhooks/voice/event' `
  --voice-fallback-url='https://example.com/webhooks/voice/fallback'
  
✅ Fetching Application
✅ Adding voice capability to application 00000000-0000-0000-0000-000000000000

Name: Your application
Application ID: 00000000-0000-0000-0000-000000000000
Improve AI: Off
Private/Public Key: Set

Capabilities:
 VOICE:
    Uses Signed callbacks: On
    Conversation TTL: 41 hours
    Leg Persistence Time: 6 days
    Event URL: [POST] https://example.com/webhooks/voice/event
    Answer URL: [POST] https://example.com/webhooks/voice/answer
    Fallback URL: [POST] https://example.com/webhooks/voice/fallback

Dieser Befehl erstellt eine Vonage Application mit Voice Fähigkeit. Sie
konfiguriert die Applications mit Ihren Antwort- und Ereignis-Webhook-URLs und erzeugt eine private Schlüsseldatei private.key, die Sie in Ihrem Projektverzeichnis speichern sollten.

Der Befehl gibt eine eindeutige Application ID zurück. Verwenden Sie diese Anwendungs-ID, um Ihre virtuelle Vonage-Nummer mit Ihrer Anwendung zu verknüpfen, indem Sie Folgendes ausführen:

vonage apps numbers link 00000000-0000-0000-0000-000000000000 16127779311

✅ Fetching Application
Fetching Owned numbers [===============================================] 1/1 100%

Number linked

Number: 16127779311
Country: 🇺🇸 United States
Type: Toll-free
Features: MMS, SMS, VOICE
Monthly Cost: Not Set
Setup Cost: Not Set
Linked Application ID: 00000000-0000-0000-0000-000000000000
Voice Callback: app
Voice Callback Value: 00000000-0000-0000-0000-000000000000
Voice Status Callback: Not Set

Dadurch wird die virtuelle Vonage Numbers mit Ihrer Anwendung verknüpft, was dazu führt, dass alle Sprachereignisse, die für diese Nummer auftreten, an die von Ihnen festgelegten URLs weitergeleitet werden.

So erstellen Sie eine Sprachanwendung mit dem Dashboard

Sie können Sprachanwendungen 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. Speichern Sie den erzeugten privaten Schlüssel.

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

  5. In der Antwort-URL geben Sie die URL für den Webhook für eingehende Anrufe ein, zum Beispiel, http://example.com/webhooks/answer.

  6. In der Ereignis-URL geben Sie die URL für Ihren Webhook für den Anrufstatus ein, zum Beispiel, http://example.com/webhooks/events.

  7. Klicken Sie auf die Neue Anwendung generieren Taste.

  8. Sie werden nun zum nächsten Schritt des Verfahrens "Create Application" weitergeleitet, wo Sie Ihre Vonage-Nummer mit der Anwendung verknüpfen müssen. der Anwendung verknüpfen.

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.

Verwendung des Dashboards

Zunächst können Sie sich Ihre vorhandenen Numbers.

Wenn Sie keine Nummern übrig haben, können Sie einen kaufen.

Verwenden der Vonage CLI

Wenn Sie eine Nummer gefunden haben, mit der Sie zufrieden sind, können Sie diese über die vonage numbers buy Befehl:

vonage numbers buy US 16127779311 
✅ Searching for numbers
Are you sure you want to purchase the number 16127779311 for €0.90? [y/n] y

✅ Purchasing number
Number 16127779311 purchased

Number: 16127779311 
Country: 🇺🇸 United States
Type: Mobile
Features: MMS, SMS, VOICE
Monthly Cost: €0.90
Setup Cost: €0.00
Linked Application ID: Not linked to any application
Voice Callback: Not Set
Voice Callback Value: Not Set
Voice Status Callback: Not Set

Verwendung des Dashboards

  1. Ihre Bewerbung finden Sie in der Dashboard.
  2. Klicken Sie auf die Anwendung in der Liste "Ihre Applications". Klicken Sie dann auf die Registerkarte Numbers.
  3. Klicken Sie auf die Schaltfläche Link, um eine Vonage-Nummer mit dieser Anwendung zu verknüpfen.

Verwenden der Vonage CLI

Sobald Sie eine geeignete Nummer haben, können Sie diese mit Ihrer Vonage-Anwendung verknüpfen. Führen Sie dazu folgenden Befehl aus

vonage apps numbers link 00000000-0000-0000-0000-000000000000 16127779311

✅ Fetching Application
Fetching Owned numbers [===============================================] 1/1 100%

Number linked

Number: 16127779311
Country: 🇺🇸 United States
Type: Toll-free
Features: MMS, SMS, VOICE
Monthly Cost: Not Set
Setup Cost: Not Set
Linked Application ID: 00000000-0000-0000-0000-000000000000
Voice Callback: app
Voice Callback Value: 00000000-0000-0000-0000-000000000000
Voice Status Callback: Not Set

Sie müssen Ihren Webhook über das öffentliche Internet für die APIs von Vonage zugänglich machen. Eine einfache Möglichkeit, dies während der Entwicklung zu erreichen, ohne einen eigenen Server einzurichten, ist die Verwendung von Ngrok. Um mehr zu erfahren, Lesen Sie unsere Dokumentation über Ngrok.

Laden Sie ngrok herunter und installieren Sie es. Führen Sie dann den folgenden Befehl aus, um Ihre Anwendung auf Port 3000 für das öffentliche Internet freizugeben:

./ngrok http 3000

Wenn Sie ein kostenpflichtiges Abonnement haben, können Sie das eingeben:

./ngrok http 3000 -subdomain=your_domain

HINWEIS: In diesem Beispiel leitet Ngrok die Vonage-Webhooks, die Sie beim Erstellen Ihrer Vonage-Anwendung angegeben haben, an localhost:3000. Obwohl hier der Port 3000 gezeigt wird, können Sie jeden freien Port verwenden, der für Sie geeignet ist.

Erstellen eines Anrufmenüs

Erstellen Sie ein interaktives Sprachdialogmenü (IVR) zur Bearbeitung von Kundenanrufen

Verfügbar am:
Node.js
Schritte
1
Einführung
2
Prerequisites
3
Was Sie bauen werden
4
Installieren Sie die Abhängigkeiten
5
Den Server erstellen
6
Erstellen Sie den Antwort-Webhook
7
Erstellen Sie den DTMF-Webhook
8
Erstellen Sie den Ereignis-Webhook
9
Konfigurieren Sie Ihre Sprachanwendung
10
Lauft es!
11
Schlussfolgerung
12
Was kommt als Nächstes?