CÓMO FUNCIONA: Bot
Telegram Bot
El bot que BBVA ha creado sirve como ejemplo de las múltiples posibilidades que las APIs
de API_Market ofrecen a los usuarios.
Video
Hemos grabado un pequeño video que sirve de inspiración para futuras ideas y sintetiza el
funcionamiento del bot que explicamos después.
Introducción
Este bot se ha integrado en Telegram y es accesible desde
cualquier dispositivo que tenga instalada esta aplicación. Lo
único que hay que hacer es buscar el canal
@sbx_bbvaapimarket_bot en Telegram y mantener una
conversación con este bot.
Al abrir el canal, el Telegram muestra un mensaje anunciando
que el bot ha sido creado por API_Market, respaldado por el
BBVA.
Pulsamos en el botón 'iniciar' para entrar en el chat con el bot.
Una vez dentro de la conversación, el bot nos envía un breve
resumen de las principales funciones que ofrece. En este
entorno de test, el usuario que nos ofrece utilizar es el siguiente:
Username: 00000034B
Password: 123456
En el entorno real, estos datos serán el DNI del usuario y su
contraseña en BBVA.
BBVA API_Market
A continuación, el bot nos lista los diferentes mensajes que se
pueden enviar. Estos mensajes también se pueden consultar en
todo momento presionando el botón “/” que se encuentra en el
campo de introducción de texto del usuario. Al presionar el botón,
se despliega un menú en el que están todos los posibles mensajes:
/me - Devuelve información básica del usuario
/me_full - Devuelve información ampliada del usuario
/accounts - Muestra las cuentas del usuario
/transfer - Da comienzo al proceso de realizar una transferencia
desde Telegram
/help - Devuelve el mensaje de presentación del bot
/cancel - Cancela el proceso activo
/purchase - Da comienzo a la compra de un producto dentro del
catálogo disponible
Servicios
/me
Este mensaje devuelve la información básica del usuario. Al enviar este mensaje, Telegram
nos pide abrir una nueva ventana para conectarnos con BBVA. Esta página de BBVA se llama
BBVA Connect y es donde introducimos los datos de acceso para autorizar a Telegram para
recuperar nuestros datos de BBVA.
En un caso real, estos datos son el DNI del usuario y su password de BBVA. En esta prueba,
los datos que se pueden utilizar son los siguientes:
Username: 00000034B
Password: 123456
La respuesta del mensaje /me muestra nuestros datos guardados
en BBVA:
Firstname - Nombre
Surname - Apellido
Second surname - Segundo apellido
Sex - Sexo
Birthdate - Fecha de nacimiento
Email - Correo electrónico
Identity document 1 - Número de DNI
Zipcode 1 - Código postal
BBVA API_Market
/me_full
Este mensaje devuelve más datos nuestros guardados en BBVA. Para
poder ver el resultado de este mensaje, el bot necesita de nuestra
autorización por OTP. Telegram abre una ventana de BBVA Connect
en la que introducimos el código que se nos envía por SMS al móvil.
Como estamos en un entorno de pruebas, cualquier valor que
introduzcamos será aceptado.
El bot nos contesta con un mensaje que contiene la siguiente
información:
Firstname
Surname
Second surname
Sex
Birthdate
Email
Identity document 1
Street
Zipcode 1
Phone
El mensaje /me_full añade la calle y el número teléfono al mensaje
/me.
/accounts
El mensaje /accounts nos informa de nuestras cuentas en BBVA. Por motivos de seguridad
solo muestra los últimos 4 números de la cuenta y su saldo.
/transfer
El mensaje /accounts El mensaje /transfer inicia el proceso de realizar una transferencia de una
de nuestras cuentas a cualquier otra cuenta.
Lo primero que nos pregunta el bot es la cuenta origen desde la que queremos realizar la
transferencia.
BBVA API_Market
Una vez seleccionada la cuenta, el bot nos solicita el IBAN de la
cuenta destino. En este ejemplo introducimos el valor “1234”,
sabiendo que es un código de IBAN incorrecto. Este código será
validado a posteriori por el bot.
En el siguiente paso, el bot nos pide el nombre del propietario de la
cuenta destino. Introducimos como nombre el texto “Test Name”.
Ahora el bot nos pregunta la cantidad de dinero que queremos
transferir en euros. Contestamos que la transferencia a realizar
debe ser de 1€. No hace falta poner la moneda, se usa el euro por
defecto.
Por último, el bot nos pregunta cual es el concepto de la
transferencia. A modo de ejemplo, introducimos el texto “Concept
of transfer”.
Tras haber informado todos los campos requeridos para realizar
la transferencia, el bot de API_Market nos presenta una
recapitulación de la transferencia. El bot nos indica todos los
campos que hemos ido rellenando y nos pregunta si estamos
seguros de querer realizar la transferencia. Al confirmar la
transferencia, el bot nos dice que no se ha podido completar
debido a que el IBAN no es un código correcto.
Si todos los datos hubieran sido correctos, el bot nos hubiese
informado de que la transferencia se habría realizado
correctamente.
BBVA API_Market
/purchase
El mensaje /purchase sirve para realizar compras dentro del
chat. En este bot, se ha cargado un catálogo de productos de
una tienda ficticia para poder mostrar el funcionamiento de las
compras integradas en el chat.
Hemos introducido productos en tres categorías distintas:
- Detalles de cocina
- Maquetas
- Accesorios
Seleccionamos la primera opción, “Detalles de Cocina”.
Dentro de “Detalles de Cocina”, se han creado dos
subcategorías:
- Tazas
- Packs de platos
Seleccionamos la subcategoría “Tazas”.
BBVA API_Market
El bot muestra al usuario una foto del producto y una descripción
del mismo en la que se incluye el precio del producto. Nos
pregunta si quiere comprar este producto o quiere ver el siguiente
producto de la lista.
En el caso de seleccionar el producto, el bot nos pide
confirmación de que queremos comprar el producto seleccionado.
Si confirmamos que queremos comprar el producto, el bot nos
pregunta a qué cuenta debe realizar el cargo del producto. En este
caso, seleccionamos la cuenta que dispone de saldo.
Al igual que en el caso de la transferencia, el bot recapitula toda la
información introducida antes de realizar la compra. Nos pregunta
si estamos seguros de que querer realizar la compra del producto
con la cuenta que hemos seleccionado.
BBVA API_Market
En caso de confirmar la compra, el bot nos indica que es necesario un
segundo factor de autenticación y que accedamos a la URL que nos
proporciona para validar la compra.
Telegram abre una ventana de BBVA Connect en la que se debe
introducir el código que se envía por SMS a nuestro móvil.
Como estamos en un entorno de pruebas, no se envía ningún SMS y
cualquier valor que introduzcamos será aceptado.
BBVA API_Market
Cuando hemos introducido el código, somos redirigidos al chat de
Telegram en el que el bot nos informa de que la compra se ha
realizado correctamente.
BBVA API_Market
