16.02.2021
Autenticación por número de teléfono

El nuevo método API permite a las empresas confirmar números de teléfonos de clientes a través de llamadas. Esta autenticación es más económica que a través de SMS y sirve para la mayoría de empresas.

¿Cómo funciona?

  1. El cliente introduce el número de teléfono en la web
  2. Se genera el código y se envía la solicitud API para la comprobación del número
  3. El robot llama al cliente y reproduce el código
  4. El cliente inserta los dígitos en la web y confirma el número

Para qué y para quién

Para qué sirve la autenticación por número de teléfono:

  • Autenticación de doble factor
  • Registro
  • Restablecimiento de contraseña

El método de registro por email y repetición de contraseña "a la antigua usanza" no ha desaparecido. Sin embargo hoy en día las empresas necesitan cada vez más verificar a los clientes con la ayuda del número de teléfono.

Los problemas con la autenticación por SMS son dos: es un método caro y no siempre seguro para las empresas ya que los clientes pueden usar números virtuales temporales. Es por ello que el registro y su posterior autenticación por factor doble mediante la llamada al número de teléfono es la herramienta idónea para la verificación de identidad.

Cómo implementarlo

En la interfaz abierta de API Zadarma hay un método request_checknumber.

Sus parámetros:

  • caller_id — número desde el que se realiza la llamada, tiene que ser un número conectado en nuestra plataforma;
  • to — número de teléfono del cliente al que llama el robot;
  • code — código que se reproducirá. Combinación de dígitos que es determinado por ti y reproducido por el robot de voz, extensión máxima de 20 dígitos;
  • lang — idioma de reproducción. Al no predeterminar será seleccionado el idioma del área personal: español, inglés, francés, alemán, ruso, polaco, ucraniano.

Se genera el código, se envía la solicitud API y a esperar a que el cliente introduzca el código en la web.

¿Qué necesitas para empezar?

Unos cuantos pasos muy sencillos para usar la autenticación por número de teléfono en tu propio servicio:

  1. Registrarte en la plataforma
  2. Conectar el número virtual (obligatorio ya que las llamadas se han de emitir desde el número conectado)
  3. Generar la clave API y empezar a usar el método

Para simplificar y facilitar el uso de API Zadarma recomendamos usar la biblioteca oficial (php, python y C# ).

Una vez configurada la biblioteca oficial se requiere generar en los archivos conectados tus claves API. Ejemplo de solicitud con el uso del cliente en 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"
]);

Respuesta típica a esta consulta (exitosa):


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