Flexible Arbeitsabläufe für Verify API

Nexmos Verify API ermöglicht es Ihnen zu bestätigen, dass ein Nutzer eine korrekte und gültige Telefonnummer angegeben hat, indem Sie ihm einen PIN-Code senden und ihn auffordern, diesen einzugeben.

Standardmäßig wird dazu zunächst eine SMS mit dem PIN-Code verschickt, gefolgt von einem Telefonanruf mit einer gesprochenen Nachricht, die den PIN enthält. Schließlich wird mit einem zweiten Telefonanruf versucht, den Benutzer zu erreichen.

Durch diesen mehrstufigen Prozess werden die Erfolgsquoten bei der Verifizierung der Telefonnummer des Nutzers deutlich verbessert. Wir wissen jedoch, dass dies nicht für jeden Benutzer der bestmögliche Arbeitsablauf ist, daher hat Verify API jetzt eine neue Funktion: Konfigurierbare Arbeitsabläufe.

Steuerung des Verify-Workflows

Für jeden Benutzer, an den Sie einen PIN-Code senden müssen, kann der "richtige" Arbeitsablauf anders aussehen. Aus diesem Grund können Sie bei Verify API jetzt einen workflow_id anzugeben, wenn Sie den API-Aufruf tätigen, so dass Sie aus fünf möglichen Workflow-Mustern wählen können.

Der zusätzliche Parameter wird neben den vorhandenen Parametern hinzugefügt, sodass Ihr API-Aufruf etwa so aussieht (in Node.js):

nexmo.verify.request({
  number: RECIPIENT_NUMBER,
  brand: BRAND_NAME,
  workflow_id: WORKFLOW_ID
}, (err, result) => {
  if (err) {
    console.error(err);
  } else {
    const verifyRequestId = result.request_id;
    console.log('request_id', verifyRequestId);
  }
});

Sie finden diesen Codeschnipsel in anderen Sprachen auf dem Nexmo-Entwicklerportal

Die workflow_id kann eine beliebige ganze Zahl zwischen 1 und 5 sein, und hier sind die Arbeitsabläufe, die diese Numbers darstellen:

Workflow 1 (Standard-Workflow): SMS -> TTS -> TTS

Senden Sie einen PIN-Code per Textnachricht und rufen Sie anschließend zweimal an, wenn die Anfrage nicht bereits verifiziert wurde. Dies ist das Standardverhalten und wahrscheinlich eine gute Wahl, wenn Sie sich nicht sicher sind, was Sie wählen sollen.

Arbeitsablauf 2: SMS -> SMS -> TTS

Senden Sie einen PIN-Code per SMS, folgen Sie mit einer zweiten SMS und schließlich einem Voice-Anruf, wenn die Anfrage nicht verifiziert wurde. Für Regionen und/oder Nutzer, in denen eine SMS einem Voice-Anruf vorzuziehen ist.

Arbeitsablauf 3: TTS -> TTS

Rufen Sie den Benutzer an und geben Sie einen PIN-Code ein. Rufen Sie ihn ein zweites Mal an, wenn die Anfrage noch nicht überprüft wurde. Wenn Sie bereits wissen, dass ein Telefonanruf für die Situation des Nutzers am besten geeignet ist, ist ein Telefonanruf mit Wiederholungsversuch eine gute Möglichkeit, ihn zu erreichen.

Arbeitsablauf 4: SMS -> SMS

Senden Sie einen PIN-Code per Textnachricht und senden Sie eine zweite Textnachricht, wenn der Code nicht verifiziert wurde. Ideal für Benutzer, die nicht gerne telefonieren. Einschließlich, aber nicht beschränkt auf, Millenials.

Arbeitsablauf 5: SMS -> TTS

Senden Sie einen PIN-Code per Textnachricht und rufen Sie anschließend an, wenn der Code nicht verifiziert wurde. Das Angebot, sowohl Text als auch Sprache zu verwenden, aber jeweils nur einen Versuch zu unternehmen, schließt viele Menschen ein, ohne zu aufdringlich zu sein.

Machen Sie das Beste aus Ihrer Reichweite

Wenn Sie Ihre Anwendung so anpassen, dass sie den besten Arbeitsablauf für Ihren Anwendungsfall nutzt (oder sogar verschiedene Optionen für verschiedene Kunden verwendet), können Sie die Überprüfungsraten Ihrer Kunden wirklich verbessern.

Wir freuen uns sehr, dass diese Funktion nun öffentlich verfügbar ist - lassen Sie uns wissen, wie Sie Ihre Arbeitsabläufe geändert haben und warum! Sie können uns immer auf Twitter finden @NexmoDevoder mailen Sie uns devrel@nexmo.com oder stellen Sie eine Frage im #verify-api Kanal auf dem Nexmo Gemeinschaft Slack.