So verwenden Sie den Standard-Agenten von Vonage Verify RCS

Wenn Sie bereits OTPs über die Vonage Verify API versenden, können Sie sofort mit dem Versand von RCS-Nachrichten beginnen – ohne dass zuvor eine Registrierung als Agent oder ein Genehmigungsverfahren durch den Netzbetreiber erforderlich ist. Die Vonage Verify RCS-Standardagent ist ein zentral verwalteter, vorab registrierter RCS-Agent, der von Vonage unter dem Namen Vonage Verify. Jeder Verify-API-Kunde in einem unterstützten Land kann diese Funktion nutzen, indem er einfach das from Feld in ihrer bestehenden Verify-V2-Anfrage.

Voraussetzungen

• A Vonage-Konto mit einer Vonage Anwendung konfiguriert (Anwendungs-ID und privater Schlüssel, für JWT-Authentifizierung).
• Ein bestehendes Integration mit der Verify V2-API.

Überprüfen Sie, ob Ihr Zielland unterstützt wird

Vergewissern Sie sich zunächst, dass sich Ihre Endbenutzer in einem der Länder befinden, in denen der Standard-Agent Live:

RCS in Ihren Verify-Workflow integrieren

Fügen Sie in Ihrer bestehenden Verify V2-Anfrage Folgendes hinzu: "channel": "rcs" in das Workflow-Array. Lass das from Feld da Vonage die Nachricht automatisch über den Standard-Agenten weiterleitet. Eine Agenten-ID ist nicht erforderlich.

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'"
        }
    ]
}'

Mit der Antwort umgehen

Eine erfolgreiche Anfrage gibt ein request_id:

{
  "request_id": "REQUEST_ID"
}

Sobald der Endnutzer das OTP übermittelt hat, überprüfen Sie den Code mithilfe der request_id genau so, wie Sie es bei jedem anderen Verify-Kanal tun würden – siehe Überprüfen Sie den mitgelieferten Verifizierungscode.

RCS-Erfahrung für Endnutzer

Wenn eine Bestätigungsnachricht über den Standard-Agenten zugestellt wird, erhalten Endnutzer auf unterstützten Android-Geräten eine RCS-Nachricht mit erweiterten Funktionen, die folgende Merkmale aufweist:

• Abzeichen für verifizierten Absender — die Nachricht wird vom Netzbetreiber verifiziert Vonage Verify Agent (VonageVFY (in Singapur), was das Vertrauen der Nutzer stärkt.
• Umfangreiches Kartenlayout — Das OTP wird gut sichtbar in einer gestalteten Karte angezeigt, sodass es auf einen Blick leicht zu erkennen ist.
• Schaltfläche „Code mit einem Fingertipp kopieren“ — Über eine Vorschlagsfunktion können Nutzer den Code direkt in die Zwischenablage kopieren, wodurch Eingabefehler vermieden werden.
• Automatischer OTP-Vorschlag — Auf unterstützten Android-Versionen zeigt „Google Messages“ den Code möglicherweise oberhalb der Tastatur als Vorschlag zur automatischen Vervollständigung mit einem Fingertipp an.
• Markenbezogener Textkörper — dein brand Der Wert erscheint im Nachrichtentext, sodass die Nutzer den Namen Ihres Unternehmens im Kontext sehen, auch wenn der Name des Mitarbeiters Vonage Verify.
• Es ist keine App-Installation erforderlich — RCS ist in die Standard-Nachrichten-App von Android integriert. Für den Nutzer sind keine Downloads oder zusätzlichen Schritte erforderlich.

Verhalten und Einschränkungen

• Der Absendername des RCS-Agenten lautet immer Vonage Verify (VonageVFY (in Singapur) und kann bei Verwendung des Standard-Agents nicht angepasst werden. Ihr Markenname erscheint jedoch im Nachrichtentext über die brand Parameter: Your {brand} code is: {code}.
• Opt-outs gelten nur für den jeweiligen Endnutzer und Ihren API-Schlüssel – sie haben keine Auswirkungen auf andere Kunden, die denselben Standard-Agenten verwenden.
• Es sind keine zusätzlichen Einrichtungs-, Whitelisting- oder Aktivierungsschritte erforderlich. Alle Verify-API-Kunden in den unterstützten Ländern können den Standard-Agenten sofort nutzen.
• Es gelten die üblichen Nutzungsbeschränkungen und Fair-Use-Richtlinien der Vonage Verify API.
• Die Abrechnung erfolgt gemäß den Standardpreisen für Vonage Verify RCS. Die Nutzung wird Ihrem individuellen API-Schlüssel zugeordnet.

Registrieren Sie Ihren eigenen RCS-Agenten

Der Standard-Agent dient als empfohlener Ausgangspunkt und Übergangslösung, während Ihr benutzerdefinierter Agent bereitgestellt wird. Sie können die Registrierung Ihres eigenen Agenten parallel zur Nutzung des Standard-Agents durchführen, ohne dass es zu Unterbrechungen Ihres bestehenden Datenverkehrs kommt. Um loszulegen, verwenden Sie den RCS Agent Builder im Vonage-API-Dashboard.

Siehe auch

• Verify V2 API-Referenz
• Workflow verifizieren
• RCS-Kanalkonzepte
• Integrieren Sie RCS in Ihre Authentifizierungsabläufe
• Anleitung zum RCS Agent Builder