Maskierte Anrufe

Dieser Leitfaden zeigt Ihnen, wie Sie die Idee, die in der Anwendungsfall private Sprachkommunikation. Es zeigt Ihnen, wie Sie einen Voice-Proxy mit der Vonage-Software aufbauen. Node Server SDKmit virtuellen Numbers, um die echten Telefonnummern der Teilnehmer zu verbergen. Der vollständige Quellcode ist auch in unserem Voice Proxy unter Verwendung des Voice API GitHub Repo. Alternativ können Sie sich auch an Code Hub zum Ausprobieren der Masked Calling API.

Übersicht

In einigen Fällen kann es erforderlich sein, dass zwei Nutzer miteinander kommunizieren, ohne ihre persönlichen Telefonnummern preiszugeben. Bei einem Mitfahrdienst zum Beispiel müssen die Nutzer Abholzeiten koordinieren, ohne ihre Kontaktdaten preiszugeben, was auch dazu beiträgt, direkte Absprachen zu verhindern, die Ihre Einnahmen schmälern könnten.

Mit den APIs von Vonage können Sie den Teilnehmern temporäre Numbers zur Verfügung stellen, die ihre echten Telefonnummern während des Anrufs verbergen. Nach Beendigung des Anrufs werden die temporären Numbers widerrufen, sodass der Datenschutz gewährleistet ist.

Schritte

Dieser Leitfaden enthält Anweisungen für die Erstellung der Anwendung, einschließlich:

Voraussetzungen

Um diesen Anwendungsfall bearbeiten zu können, benötigen Sie:

A Vonage-Konto
Die Vonage CLI installiert und konfiguriert

Code-Repository

Es gibt eine GitHub-Repository, das den Code enthält.

Konfiguration

Sie müssen eine .env Datei, die die Konfiguration enthält. Anweisungen dazu finden Sie im Abschnitt GitHub README. Während Sie diese Anleitung durcharbeiten, können Sie Ihre Konfigurationsdatei mit den erforderlichen Werten für Variablen wie API-Schlüssel, API-Geheimnis, Anwendungs-ID, Debug-Modus und bereitgestellte Numbers auffüllen.

Erstellen einer Voice API-Applikation

Eine Voice API Application ist ein Konstrukt von Vonage. Sie sollte nicht mit der Anwendung verwechselt werden, die Sie schreiben werden. Es handelt sich vielmehr um einen "Container" für die Authentifizierungs- und Konfigurationseinstellungen, die Sie für die Arbeit mit der API benötigen.

Sie können eine Voice API Application mit der Vonage CLI erstellen. Sie müssen einen Namen für die Anwendung und die URLs von zwei Webhook-Endpunkten angeben: Der erste ist der Endpunkt, an den die APIs von Vonage eine Anfrage stellen, wenn Sie einen eingehenden Anruf auf Ihrer virtuellen Nummer erhalten, und der zweite ist der Endpunkt, an dem die API Ereignisdaten veröffentlichen kann.

Ersetzen Sie den Domänennamen im folgenden Vonage CLI-Befehl durch Ihren ngrok-Domänennamen (Weitere Informationen hierzu finden Sie in der Wie man ngrok ausführt Anleitung) und führen Sie es im Stammverzeichnis Ihres Projekts aus:

vonage apps:create "Voice Proxy" --voice_answer_url=https://example.com/proxy-call --voice_event_url=https://example.com/event

Dieser Befehl erstellt eine Datei namens voice_proxy.key die Authentifizierungsinformationen enthält und eine eindeutige Anwendungs-ID zurückgibt. Notieren Sie sich diese ID, da Sie sie in den folgenden Schritten benötigen werden.

Erstellen Sie die Webanwendung

Diese Anwendung verwendet die Express Rahmen für das Routing und die Vonage Node Server SDK für die Arbeit mit der Voice API. dotenv wird verwendet, damit die Anwendung mit einem .env Textdatei.

Unter server.jsinitialisiert der Code die Abhängigkeiten der Anwendung und startet den Webserver. Für die Homepage der Anwendung wird ein Route-Handler implementiert (/), so dass Sie testen können, ob der Server läuft, indem Sie node server.js und Besuch http://localhost:3000 in Ihrem Browser:

Beachten Sie, dass der Code ein Objekt des Typs VoiceProxy Klasse, um die Weiterleitung von Nachrichten, die an Ihre virtuelle Nummer gesendet werden, an die reale Nummer des Empfängers zu gewährleisten. Der Proxy-Prozess wird im Abschnitt Bevollmächtigen Sie den Anruf Kapitel dieses Handbuchs. Beachten Sie, dass diese Klasse das Vonage Server SDK mit dem API-Schlüssel und dem Geheimnis initialisiert, die Sie im nächsten Schritt konfigurieren werden. Diese Einrichtung ermöglicht es Ihrer Anwendung, Sprachanrufe zu tätigen und zu empfangen:

Virtuelle Numbers bereitstellen

Virtuelle Numbers werden verwendet, um echte Telefonnummern vor den Nutzern Ihrer Anwendungen zu verbergen.

Das folgende Workflow-Diagramm zeigt den Prozess der Bereitstellung und Konfiguration einer virtuellen Nummer:

Um eine virtuelle Nummer einzurichten, durchsuchen Sie die verfügbaren Nummern, die Ihren Kriterien entsprechen. Zum Beispiel eine Rufnummer in einem bestimmten Land mit Sprachfunktion:

Mieten Sie dann die gewünschten Numbers und verknüpfen Sie sie mit Ihrer Bewerbung.

HINWEIS: Bei einigen Numbers müssen Sie möglicherweise weitere Informationen angeben, z. B. eine Postanschrift. Wenn Sie nicht in der Lage sind, eine Nummer programmgesteuert abzurufen, können Sie die Seite Dashboard für Entwickler um solche Numbers zu beantragen. Beachten Sie, dass bei einigen Numbers Informationen abgefragt werden müssen und der Vorgang nicht vollständig automatisiert ist.

Wenn ein Ereignis in Bezug auf eine mit einer Applikation verbundene Nummer eintritt, sendet Vonage eine Anfrage an Ihren Webhook-Endpunkt mit Informationen über das Ereignis. Speichern Sie nach der Konfiguration die Telefonnummer zur späteren Verwendung:

Um virtuelle Numbers bereitzustellen, besuchen Sie http://localhost:3000/numbers/provision in Ihrem Browser.

Sie verfügen nun über die virtuellen Numbers, die Sie benötigen, um die Kommunikation zwischen Ihren Benutzern zu verschleiern.

HINWEIS: In einer Produktionsanwendung wählen Sie aus einem Pool von virtuellen Numbers. Es ist jedoch wichtig, dass Sie diese Funktion beibehalten, um bei Bedarf zusätzliche Nummern zu mieten.

Einen Anruf erstellen

Der Arbeitsablauf zur Erstellung eines Anrufs ist in der Abbildung dargestellt:

Der folgende Aufruf:

Überprüfen Sie die Telefonnummern

Wenn die Benutzer Ihrer Anwendungen ihre Telefonnummern angeben, können Sie mit Number Insight sicherstellen, dass sie gültig sind. Sie können auch sehen, in welchem Land die Telefonnummern registriert sind:

Zuordnung von Telefonnummern zu echten Numbers

Sobald Sie sich vergewissert haben, dass die Telefonnummern gültig sind, ordnen Sie jede echte Nummer einem virtuelle Nummer und speichern Sie den Anruf:

Eine Bestätigungs-SMS senden

Wenn in einem privaten Kommunikationssystem ein Nutzer einen anderen kontaktiert, ruft der Anrufer eine virtuelle Nummer von seinem Telefon aus an.

Senden Sie eine SMS, um jedem Gesprächsteilnehmer die virtuelle Nummer mitzuteilen, die er anrufen soll:

Die Benutzer können sich nicht gegenseitig SMS schicken. Um diese Funktion zu aktivieren, müssen Sie Folgendes einrichten Private SMS-Kommunikation.

In diesem Leitfaden hat jeder Nutzer die virtuelle Nummer in einer SMS erhalten. In anderen Systemen könnte dies über E-Mail, In-App-Benachrichtigungen oder eine vordefinierte Nummer erfolgen.

Eingehende Anrufe abwickeln

Wenn Vonage einen eingehenden Anruf an Ihre virtuelle Nummer empfängt, stellt es eine Anfrage an den Webhook-Endpunkt, den Sie bei der Installation von eine Voice API Anwendung erstellt:

Auszug to und from aus dem eingehenden Webhook und leiten sie an die Geschäftslogik des Sprachproxys weiter:

Umkehrung der Zuordnung von realen Telefonnummern zu virtuellen Numbers

Da Sie nun die Telefonnummer des Anrufers und die virtuelle Nummer des Empfängers kennen, können Sie die eingehende virtuelle Nummer der ausgehenden realen Telefonnummer zuordnen:

Die Rufrichtung kann wie folgt identifiziert werden:

Die from Zahl ist UserA reelle Zahl und die to Nummer ist UserB Vonage-Nummer
Die from Zahl ist eine reelle UserB-Zahl und die to Nummer ist UserA Vonage-Nummer

Nachdem die Nummernsuche durchgeführt wurde, muss nur noch die Vollmacht für den Anruf erteilt werden.

Bevollmächtigen Sie den Anruf

Vermitteln Sie den Anruf an die Telefonnummer, mit der die virtuelle Nummer verknüpft ist. Die Website from Nummer ist immer die virtuelle Nummer, und die to ist eine echte Telefonnummer.

Erstellen Sie dazu eine NCCO (Nexmo Call Control Objekt). Dieser NCCO verwendet eine talk Aktion, um einen Text vorzulesen. Wenn die talk abgeschlossen ist, eine connect Aktion leitet den Anruf an eine echte Nummer weiter.

Der NCCO wird vom Webserver an Vonage zurückgegeben.

Schlussfolgerung

Sie haben gelernt, wie man einen Voice-Proxy für die private Kommunikation einrichtet. Sie haben Telefonnummern bereitgestellt und konfiguriert, Nummerneinblicke durchgeführt, reale Nummern virtuellen Nummern zugeordnet, um Anonymität zu gewährleisten, einen eingehenden Anruf bearbeitet und den Anruf an einen anderen Benutzer weitergeleitet.