Vonage Voice API mit ASP.NET: Bevor Sie beginnen

Dies ist Teil einer Serie über die Verwendung der Vonage Voice API mit ASP.NET-Projekten. Er setzt die Reihe "Erste Schritte mit Vonage und ASP.NET" fort, die auf unsere Reihe "Erste Schritte" über SMS APIs.

In diesem Tutorial werden wir ein ASP.NET-Projekt in Visual Studio einrichten, das alle notwendigen Konfigurationen für die Verbindung mit der Vonage Voice API enthält. Dies ermöglicht es, einer ASP.NET-Anwendung Telefonanrufe hinzuzufügen. In künftigen Blogbeiträgen wird gezeigt, wie Sie die Voice API in Ihre Anwendung integrieren können.

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.

Konfigurieren einer Vonage-Anwendung

Um Folgendes nutzen zu können Die Vonage Voice APIverwenden zu können, müssen Sie eine Vonage-Applikation. Eine Vonage Anwendung enthält die Sicherheits- und Konfigurationsinformationen, die Sie für die Interaktion mit der Vonage Voice REST API und die einfache Nutzung der Voice API benötigen.

Alle Anfragen an die Voice API erfordern eine Authentifizierung. Sie müssen mit der Application API einen privaten Schlüssel generieren, mit dem Sie JSON Web Tokens (JWT) erstellen können, um die Anfragen zu stellen. Ein anwendungsbezogener öffentlicher/privater Schlüssel kann auf zwei Arten erstellt werden.

Das Dashboard der Vonage-Anwendung

Wenn Sie Ihr Vonage Dashboard aufrufen, finden Sie unter dem Abschnitt Abschnitt Anwendungkönnen Sie eine neue Anwendung erstellen.

Füllen Sie die erforderlichen Felder aus und klicken Sie dann auf "Öffentliches/privates Schlüsselpaar generieren". (bewahren Sie diesen sicher auf!) sowie den öffentlichen Schlüssel für Sie zu erzeugen.

Sie können mehr lesen über unser Applikations-Dashboard und wie es die Verwaltung von Vonage Voice-Applikationen erleichtert, lesen Sie in unserem Blogbeitrag.

Die Vonage CLI

Installieren wir zunächst CLI von Vonage von npm

npm install @vonage/cli -g

und richten Sie ihn dann mit Ihrem Vonage-API-Schlüssel und -Geheimnis ein.

vonage config:set --apiKey=API_KEY --apiSecret=API_SECRET

Nachdem die Konfiguration abgeschlossen ist, wird im nächsten Schritt die Voice Application mit dem Befehl app:create.

Bei beiden Optionen müssen Sie einen Anwendungsnamen, z. B. "Meine erste Voice-App", und zwei Webhook-Endpunkte registrieren, um die Antwort- und Ereignis-URLs anzugeben. Der app:create Befehl führt Sie durch diesen Vorgang.

vonage apps:create 

√ Application Name ... My first voice app
√ Select App Capabilities » Voice
√ Create voice webhooks? ... yes
√ Answer Webhook - URL ... http://example.com/webhook_name/answer
√ Answer Webhook - Method » POST
√ Event Webhook - URL ... http://example.com/webhook_name/event
√ Event Webhook - Method » POST
√ Allow use of data for AI training? Read data collection disclosure - https://help.nexmo.com/hc/en-us/articles/4401914566036 ... no
Creating Application... done

Wenn die Anwendung erfolgreich erstellt wurde, gibt die CLI die Anwendungs-ID und den privaten Schlüssel zurück, die beide für die Interaktion mit der Voice API von Vonage erforderlich sind. Diese Informationen werden auch in zwei Dateien gespeichert, die sich in Ihrem Benutzerverzeichnis befinden, z. B. c:\users\bob\ und sind vonage_app.json und <app_name>.key

ASP.NET-Projekt einrichten

Nachdem wir nun unser öffentliches/privates Schlüsselpaar und unsere Vonage-Anwendung generiert haben, wollen wir uns ansehen, wie wir unser ASP.NET-Projekt konfigurieren sollten. Sie haben vielleicht bemerkt, dass es jetzt mehr als eine ASP.Net-Plattform gibt: ASP.Net wurde speziell für Windows entwickelt, während ASP.Net Core das neue, plattformübergreifende Open-Source-Framework ist.

Wir werden versuchen, beide abzudecken, wenn es einen Unterschied im Code gibt, ansonsten werden wir das eine oder das andere verwenden, wobei der Schwerpunkt auf ASP.Net Core liegt, da dies der Weg in die Zukunft ist.

ASP.Net Web-Projekt einrichten

Öffnen Sie zunächst Visual Studio und erstellen Sie eine neue ASP.NET-Webanwendung (.NET Framework) Projekt.

Wählen Sie die MVC-Vorlage und stellen Sie sicher, dass der Authentifizierungstyp auf Keine Authentifizierung. Klicken Sie auf . OK um das Projekt zu erstellen.

ASP.Net Core & .Net 5 aufwärts Projekteinrichtung

Erstellen Sie in Visual Studio ein neues Projekt und wählen Sie ASP.NET Core Web Application.

Wählen Sie dann die Vorlage Webanwendung.

Installieren des Vonage .Net SDK

Unabhängig davon, ob Sie sich für ein ASP.Net Web- oder Core-Projekt entscheiden, sind die folgenden Schritte die gleichen.

Installieren Sie das Vonage .Net SDK über die NuGet Package Manager Console.

Install-Package Vonage

Fügen Sie eine JSON-Datei (appsettings.json) zu Ihrem Projekt hinzu. Darin fügen Sie Ihre Vonage-Anmeldedaten hinzu.

{
  "appSettings": {
    "Vonage_key": "VONAGE-API-KEY",
    "Vonage_secret": "VONAGE-API-SECRET",
    "VONAGE_FROM_NUMBER": "VONAGE-VIRTUAL-NUMBER"
  }
}

Jetzt sind Sie bereit, in den Code einzutauchen. Sehen wir uns an, wie Sie in Ihrem ASP.NET-Projekt mit der Voice API einen Text-to-Speech-Anruf tätigen können.

Erfahren Sie mehr über die APIs von Vonage und ASP.NET

Dieser Beitrag war nur eine kurze Einführung in das Einrichten Ihrer ersten Vonage Anwendung mit ASP.NET. Jetzt sind Sie bereit, in den Code einzutauchen und zu lernen Wie man einen Text-to-Speech-Anruf in ASP.NET mit der Vonage Voice API tätigt

Warum nicht auch versuchen Versenden einer SMS mit ASP.NET MVC? Oder lernen Sie, wie man SMS mit ASP.NET MVC empfangen? Beide Beiträge sind auf unserem Entwickler-Blog. Vielleicht interessieren Sie sich auch für unser Open Source .NET SDK, das auf Github verfügbar ist.