16.02.2021

La nouvelle méthode API permet aux entreprises de confirmer les numéros de téléphone des clients par un appel. Cette autorisation est beaucoup moins chère qu'un SMS et convent à plusieurs entreprises.

Comment ça marche?

  1. Le client saisit le numéro de téléphone sur votre site
  2. Vous générez le code et envoyez la demande API de vérification du numéro
  3. Le robot appelle au client et lit le code
  4. Le client saisit les chiffres sur le site et confirme le numéro

Pour qui et pourquoi

Pourquoi utiliser l'autorisaion par numéro de téléphone:

  • Identification à deux facteurs
  • Enregistrement
  • Récupération de mot de passe

La méthode d'enregistrement du client par email et deux mots de passe correctement saisis existe toujours. Mais les entreprises ont besoin d'identifier le client avec son numéro de téléphone.

Le problème d'autorisation par SMS est le fait que c'est un moyen cher et peu sûr parce que les clients parfois utilisent les numéros virtuels temporaires. C'est pourquoi l'enregistrement et l'identification à deux facteurs par un appel est le moyen optimal de confirmation d'identité.

Comment réaliser

Dans API ouvert Zadarma il y a une méthode request_checknumber.

Ses paramètres:

  • caller_id — le numéro qui effectue un appel, connecté dans notre service;
  • to — le numéro du client où le robot appelle;
  • code — le code lu. L'ensemble de chiffres que vous indiquez est lu par le robot, la longueur maximale - 20 caractères;
  • lang — la langue de lecture du code. En cas d'absence - la langue de votre espace client, les langues - russe, anglaise, espagnole, polonaise, allemande, française, ukrainienne.

Vous générez le code, envoyez la demande API et attendez que le client saisisse le code sur votre site.

Que faire pour commencer?

Quelques étapes faciles pour utiliser l'autorisation par numéro de téléphone dans votre service:

  1. Enregistrez-vous dans le service
  2. Connectez le numéro virtuel (c'est une condition obligatoire, les appels vers les numéros de vos clients passent du numéro connecté)
  3. Créez la clé d'autorisation API et commencez le travail avec la méthode

Pour faciliter le travail avec API Zadarma, nous recommandons d'utilser une officielle bibliothèque (php, python et C#).

Après l'installation des bibliothèques il faut indiquer dans les fichiers connectés vos clés API. L'exemple de demande avec l'utilisation du client en langue PHP:


<?php

use Zadarma_API\Api;

require_once __DIR__.DIRECTORY_SEPARATOR.'include.php';

define('USE_SANDBOX', false);
$api = new Api(KEY, SECRET, USE_SANDBOX);

$api->call('/v1/request/checknumber/', [
	"caller_id" => "442037691880",
	"to" => "442037691881",
	"code" => "1234567890",
	"lang" => "fr"
]);

La réponse standard à cette demande (réussie):


{
    "status":"success",
    "from":442037691880,
    "to":442037691881,
    "lang":"fr",
    "time":1612779278
}