RCS-Bestätigungen mit dem Standard-Agenten „Vonage Verify RCS“ versenden

Einführung

Vonage Verify RCS (Rich Communication Services) ist ein zentral verwalteter, vorab registrierter RCS-Agent, den jeder Verify API-Kunde nutzen kann, um sofort mit dem Versand von RCS-Nachrichten zu beginnen, ohne den üblichen, oft langwierigen Registrierungsprozess für Agenten durchlaufen zu müssen.

In diesem Beitrag erfahren Sie, wie Sie den Vonage Verify RCS-Standard-Agent nutzen können, um noch am Tag der Integration mit dem Versand vertrauenswürdiger RCS-Authentifizierungsnachrichten zu beginnen.

Wann sollte der Standard-Agent verwendet werden?

Wenn Ihr Unternehmen RCS in seine Authentifizierungsabläufe integrieren möchte, aber nicht wochenlang auf die Genehmigung durch den Netzbetreiber warten will, oder wenn Sie bereits Vonage Verify für SMS oder WhatsApp nutzen und mit minimalem Aufwand einen Rich-Messaging-Kanal hinzufügen möchten, ist dieser Beitrag genau das Richtige für Sie. Das Gleiche gilt, wenn Sie derzeit ausschließlich SMS nutzen und RCS als zusätzlichen Kanal testen möchten.

Falls Sie bereits versucht haben, mit RCS zu beginnen, und dabei am Registrierungsprozess gescheitert sind, geben Sie noch nicht auf. Bleiben Sie dran, um mehr über den „Vonage Verify RCS Default Agent“ zu erfahren.

Integration in der Praxis

Voraussetzungen

• Eine bestehende Integration mit der Verify V2-API in einem oder mehreren der unterstützten Länder.

Hinweis: Um den Vonage Verify RCS-Standard-Agenten zu verwenden, lassen Sie den Parameter „from“ in Ihren Verify API-Anfragen weg. Sie können sofort mit dem Versand von RCS-Verifizierungsnachrichten beginnen, während die Registrierung Ihres markenspezifischen Agenten parallel dazu weiterläuft.

So führen Sie die API-Anfrage durch

Wenn Sie bereits in die Vonage Verify v2-API integriert sind, können Sie mit nur einer Änderung damit beginnen, RCS-Nachrichten über den Standard-Agenten zu versenden: Lassen Sie das from Feld weg, da Vonage die Nachricht automatisch über den Standard-Agenten weiterleitet und keine Agenten-ID erforderlich ist.

Überprüfung starten

curl -X POST "https://api.nexmo.com/v2/verify" \

    -H "Authorization: Bearer $JWT" \

    -H 'Content-Type: application/json' \

    -d $'{

        "brand": "TestVerify",

        "code_length": 5,

        "channel_timeout": 30,

        "workflow": [

        {

            "channel": "rcs",

            "to": "+447700900000"

        }

    ]

}'

• JWT (JSON Web Token) – Sie können ein neues JWT mithilfe des JWT-Online-Generator oder das Vonage-CLI-Tool.

• Marke – Der Name Ihres Unternehmens, wie er im Textkörper der Nachricht erscheinen soll.

• Kanal – Muss „rcs“ lauten, damit die Weiterleitung über den RCS-Standard-Agent erfolgt.

• an – Telefonnummer des Endnutzers im E.164-Format.

Erfolgreiche Antwort

Eine 202-Accepted-Antwort bestätigt, dass die Verifizierungsanfrage gesendet wurde. Eine 200-OK-Antwort bestätigt, dass der Code übereinstimmt und der Nutzer Verified wurde. Überprüfen Sie den Code mithilfe des request_id genau so, wie Sie es bei jedem anderen Verify-Kanal tun würden, überprüfen Sie den angegebenen Verifizierungscode.

{
  "request_id": "c11236f4-00bf-4b89-84ba-88b25df97315"
}

Speichern Sie die request_id, du brauchst es, um den vom Endnutzer übermittelten Code zu überprüfen.

Ausführliche Informationen zu den Parametern finden Sie in der Verify V2-API-Referenz.

Überprüfen Sie den OTP (Einmal-Passcode)

Sobald der Endnutzer den OTP-Code erhalten hat, müssen Sie eine POST-Anfrage an den /v2/verify/{request_id} Endpunkt senden. Ersetzen Sie die {request_id} durch die ID, die Sie im vorherigen Aufruf erhalten haben:

curl -X POST "https://api.nexmo.com/v2/verify/$VERIFY_REQUEST_ID" \

  -H "Authorization: Bearer $JWT"\

  -H 'Content-Type: application/json' \

  -d $'{

    "code": "'$VERIFY_CODE'"

  }'

Multi-Channel-Fallback

Für Produktivumgebungen empfehlen wir, einen Fallback-Kanal hinzuzufügen, falls RCS auf dem Gerät des Empfängers nicht verfügbar ist. Der unten beschriebene Workflow versucht zunächst, RCS zu nutzen, und greift dann auf SMS zurück. Es ist keine zusätzliche Konfiguration erforderlich, da Vonage die Kanalauswahl automatisch übernimmt. In den meisten Ländern wird die Nachricht vom „Vonage Verify“-Agenten versendet.

curl -X POST "https://api.nexmo.com/v2/verify" \

    -H "Authorization: Bearer $JWT" \

    -H 'Content-Type: application/json' \

    -d $'{

        "brand": "YOUR_BRAND",

        "workflow": [

        {

            "channel": "rcs",

            "to": "'$PHONE_NUMBER'"

        },

        {

            "channel": "sms",

            "to": "'$PHONE_NUMBER'"

        }

    ]

}'

Vorteile von RCS

RCS ConversationRCS ist in die Standard-App „Nachrichten“ von Android integriert und steht auch auf den neuesten iOS-Versionen zur Verfügung. Auf unterstützten Android-Versionen zeigt „Google Messages“ den Code möglicherweise oberhalb der Tastatur als Autovervollständigungsvorschlag an, sodass Nutzer ihn mit einem Fingertipp Verify können, ohne die App wechseln zu müssen.

Wenn Sie das „Rich Card“-Layout verwenden, wird das OTP gut sichtbar in einer gestalteten Karte angezeigt, und Sie können sogar eine Schaltfläche „Code mit einem Fingertipp kopieren“ hinzufügen. Dabei handelt es sich um einen Vorschlags-Chip unterhalb der Nachricht, mit dem Benutzer den Code direkt in ihre Zwischenablage kopieren können, was den Aufwand verringert und Eingabefehler in Anmeldeformularen reduziert.

Der Marken-Nachrichtentext ist der Wert, den Sie im API-Aufruf festlegen; er wird im Nachrichtentext angezeigt, sodass Endnutzer Ihren Firmennamen im Kontext sehen.

Vergleichstabelle zwischen dem RCS-Standard-Agenten und einfachen SMS

Häufig gestellte Fragen

F: Kann jeder Verify V2-Kunde diese Funktion nutzen?

A: Ja, alle Verify API-Kunden in unterstützten Ländern können den Standard-Agenten ohne zusätzliche Aktivierungsschritte nutzen.

F: Wird dem Endnutzer „Vonage Verify“ anstelle der Marke des Kunden angezeigt?

A: Ja, es werden Nachrichten vom „Vonage Verify“-Agenten angezeigt. Dies ist das beabsichtigte Verhalten des Standard-Agenten. Wenn Sie möchten, dass Ihr eigener Markenname als Absender angezeigt wird, registrieren Sie einen benutzerdefinierten Agenten. Die Freigabe Ihres markenspezifischen Agenten kann parallel zur Nutzung des Standard-Agenten erfolgen. Dennoch können Sie den Parameter „brand“ verwenden, um Ihren Markennamen in den Textkörper der RCS-Nachricht einzufügen.

F: Gibt es eine Größenbeschränkung?

A: Für die Nutzung des Standard-Agents gelten keine spezifischen Volumenbeschränkungen. Es gelten die üblichen Nutzungsbeschränkungen und Fair-Use-Richtlinien der Vonage Verify API. Die Abrechnung für RCS-Nachrichten, die über den Standard-Agent versendet werden, entspricht den üblichen RCS-Preisen von Vonage Verify. Für die Nutzung des Standard-Agents fallen keine Aufschläge oder Zusatzgebühren an. Die gesamte Nutzung wird dem individuellen API-Schlüssel des Kunden zugeordnet, sodass kein Risiko einer gemeinsamen Abrechnung besteht. Die Abrechnung erfolgt einheitlich, unabhängig davon, ob der Kunde den Standard-Agenten oder seine eigene registrierte Agent-ID verwendet.

F: Was ist mit Ländern, die nicht auf der Liste der zugelassenen Länder stehen?

A: In Ländern, die noch nicht unterstützt werden, sollten Kunden die Registrierung ihres RCS-Agenten selbst vornehmen. Das Verify-Team erweitert die Abdeckung durch Standard-Agenten kontinuierlich. Prüfen Sie, ob das Zielland unterstützt wird.

Schlussfolgerung

Der Mit dem Vonage Verify RCS-Standard-Agent können Sie noch am selben Tag mit der Nutzung von RCS beginnen und jederzeit auf einen Agenten mit Ihrem eigenen Branding umsteigen. Sie müssen weder Brand-Unterlagen und Details zu Anwendungsfällen einreichen, noch müssen Sie sich mit den von Land zu Land unterschiedlichen Genehmigungsverfahren der Netzbetreiber auseinandersetzen oder langwierige Abklärungen mit Aggregatoren durchlaufen, bevor eine Nachricht versendet werden kann.

Ressourcen

• RCS Agent Builder | Messages API

• So verwenden Sie den Standard-Agenten von Vonage Verify RCS

  Haben Sie eine Frage oder möchten Sie uns mitteilen, was Sie gerade bauen?

  • Abonnieren Sie den Entwickler-Newsletter

  • Folgen Sie uns auf X (früher Twitter) für Updates

  • Lieber ein Video? Schau dir Tutorials auf unserem YouTube-Kanal an

  • Verbinden Sie sich mit uns auf der Vonage Entwickler-Seite auf LinkedIn

  • Helfen Sie uns, unsere Entwicklererfahrung zu verbessern, indem Sie unser Feedback-Formular „Voice of the Developer“ aus.

  Bleiben Sie auf dem Laufenden und halten Sie sich über die neuesten Nachrichten, Tipps und Veranstaltungen für Entwickler auf dem Laufenden.