Konfigurieren Sie Ihre Voraussetzungen

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.

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:

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

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

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

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

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.