Actualmente existen varias plataformas para hacer disponible nuestros chatbots a una gran cantidad de usuarios. Esto ofrece la ventaja de que el usuario ya acostumbrado a la plataforma no tiene que aprender habilidades nuevas habilidades para interactuar con nuestro chatbot ya que son usuarios de la plataforma. Algunas ejemplos de plataformas que permiten montar chatbots son:
En esta sesi贸n mostraremos como construir un chatbot para Facebook, pero en realidad los conceptos son similares a otras plataformas.
El modelo
La mayor铆a de las plataformas tiene un ecosistema establecido en d贸nde el look y la experiencia del usuario est谩 bien definida. Esto complica la situaci贸n porque si quieren permitir que terceros como nosotros desarrollemos chatbots para su plataforma tienen que encontrar un mecanismo para darnos acceso y permitir ejecutar nuestro c贸digo con el de ellos. El modelo preferido es el de servicios (webhooks). Este modelo tiene tres elementos:
- El usuario: que interactua con nuestro chatbot, usualmente tiene una cuenta en la plataforma. En el caso de Facebook, el usuario se trata de alguien que tiene una cuenta y que puede acceder al servicio.
- La plataforma: esta se encarga de la administraci贸n del usuario, en particular de su cuenta y su acceso la interfaz. En el caso de Facebook corresponde a su plataforma messenger y su servicio web. La plataforma es la interfaz entre usuario y chatbot, recibe mensajes del usuario y se los env铆a al chatbot, y de igual forma recibe respuestas del chatbot y se los presenta al usuario.
- El chatbot: es el programa que ejecuta la inteligencia del chatbot, y es un servicio web que tiene que estar atento a recibir mensajes y construir la respuesta a dar. En el caso de Facebook se usa una metolog铆a de webhooks que son llamadas identificadas entre Facebook y el chatbot. El chatbot s贸lamente dialoga con la plataforma.
Chatbot en flask
El chatbot lo podemos desarrollar con la misma tecnolog铆a que usamos en nuestro chatbot anterior Flask . A diferencia del chatbot anterior ahora nuestro c贸digo no tiene que generar la vista html y por lo tanto la l贸gica del programa es m谩s directa.
La l贸gica del chatbot es la siguiente
Hay tres tareas que queremos que resuelva nuestro chatbot:
- Establecer una conexi贸n segura con Facebook Para eso toda comunicaci贸n que enviemos a Facebook tiene que ir cifrada (https) y con una llave de acceso (
ACCESS_TOKEN), e igualmente todo lo que nos env铆e Facebook ir谩 cifrado (http) y cuando se conecte con nuestro servicio tendr谩 que enviarnos un c贸digo de verificaci贸n (VERIFY_TOKEN). Estos valore los deben conocer tanto Facebook como nuestro chat. El accces_token lo propone Facebook y el verify_token nosotros; pero ambos lo deben conocer. Estos valores se guardan en el archivo de config.
ACCESS_TOKEN = "OBTENER_DE_FACEBOOK"
VERIFY_TOKEN = "VALOR_SECRETO"
- Registrar la conexi贸n Esta es una llamada que tenemos que atender de Facebook a nuestro chatbot y que le pide repetir un valor especial. La llamada la hace Facebook con una acci贸n GET y un argumento: ?hub.mode=suscribe; si nuestro chatbot recibe esta url tenemos que verificar que efectivamente se trate de una llamada de Facebook con el verify_token y regresar el valor de argumento challengue con un c贸digo de 茅xito (
200). Es lo hace el siguiente c贸digo:
@app.route('/', methods=['GET'])
def verify():
if request.args.get("hub.mode") == "subscribe" and request.args.get("hub.challenge"):
if not request.args.get("hub.verify_token") == config.VERIFY_TOKEN:
return "Verification token mismatch", 403
return request.args["hub.challenge"], 200
return "Hello world", 200
En caso de no cumplir con ser una llamada de registro, se regresa un “Hello wordl” que podemos utilizar para saber que nuestro servicio est谩 arriba.
- Recibir un mensaje y contestarlo Una vez registrado, el chatbot est谩 listo para conversar. Nuestro servicio recibir谩 una llamada con la acci贸n POST que traer谩 el mensaje, y para el cual tenemos que crear una respuesta. En este sencillo utilizaremos el mismo mecanismo para controlar la inteligencia v铆a el lenguaje AIML. La funci贸n que se encarga de esto queda as铆:
@app.route('/', methods=['POST']) zOdef webhook():
data = request.get_json()
if data["object"] == "page":
for entry in data["entry"]:
for messaging_event in entry["messaging"]:
if messaging_event.get("message"):
# Se obtiene la informaci贸n del mensaje
sender_id = messaging_event["sender"]["id"]
recipient_id = messaging_event["recipient"]["id"]
message_text = messaging_event["message"]["text"]
ans=k.respond(message_text)
send_message(sender_id, ans)
return "ok", 200
La funci贸n send_message tiene la funci贸n de preparar el mensaje de la siguiente forma:
def send_message(recipient_id, message_text):
params = {
"access_token": config.ACCESS_TOKEN
}
headers = {
"Content-Type": "application/json"
}
data = json.dumps({
"recipient": {
"id": recipient_id
},
"message": {
"text": message_text}
}
)
r = requests.post("https://graph.facebook.com/v2.6/me/messages", params=params, headers=headers, data=data)
Como podemos ver prepara una estructura de tipo json y manda el menaje a una direcci贸n de Facebook con el identificador de la comunicaci贸n para que as铆 encuentre su camino a nuestro chatbot.
A este mecanismo de ligar un servicio de plataforma con nuestro c贸digo lo conocemos como webhook. Las llamadas que puede atender nuestro servidor se le conoce como webhook.
Ejecutando nuestro webhook
Un problema como desarrollador es que al estar probando ejecutamos nuestro c贸digo en nuestra computadora personal, y Facebook necesita acceder a nuestro webhook con una URL p煤blica. Para lograr hacer visible a nuestro servicio tenemos tres opciones:
- Configurar nuestro firewall para redireccionar el tr谩fico que llegu茅 a el en cierto puerto a nuestra computadora. Requerimos acceso al firewall/ruteado/punto de acceso.
- Tomar nuestro c贸digo y ponerlo en un servicio web como Amazon AWS, Heruko, etc. Muchos de estos servicios cuestan dinero, pero es la mejor opci贸n cuando ya dejamos de desarrollar y queremos que el resto del mundo disfrute de nuestro chatbot.
- Finalmente, podemos usar un servicio de tuneling que transfiera nuestra comunicaci贸n con una URL p煤blica hasta nuestra computadora. En particuclar [ngrok] es lo que hace. Como desarrolladores es nuestra mejor opci贸n.
./ngrok http 5000
Y nos entrega la siguiente informaci贸n:
|ngrok by @inconshreveable (Ctrl+C to quit)
Session Status online
Version 2.2.4
Region United States (us)
Web Interface http://127.0.0.1:4040
Forwarding http://92399a00.ngrok.io -> localhost:5000
Forwarding https://92399a00.ngrok.io -> localhost:5000
Connections ttl opn rt1 rt5 p50 p90
0 0 0.00 0.00 0.00 0.00
En particular las URLs para Forwarding son las que nos interesa, c贸mo queremos una conexi贸n segura debemos apuntar la que comienza con https. En esta vista tambi茅n podremos ver el flujo de la informaci贸n entre Facebook y nuestro chatbot
Con lo anterior cuando corramos nuestro chat con:
python app.py
Permitir谩 acceder nuestro chat desde la direcci贸n URL para todo el internet.
Alta en Facebook
Antes de poder correr nuestro chatbot tenemos que registrarlo en Facebook. El chatbot est谩 asociado a una p谩gina de Facebook:
- Entrar a Facebook
- Crear una p谩gina de Facebook en d贸nde vivir谩 nuestro chatbot, esto se puede hacer aqu铆
- Darnos de alta como desarrolladores de Facebook aqu铆
- Ya dados de alta podemos crear una aplicaci贸n de Facebook, esto se podr谩 hacer desde las opciones despu茅s de registrarnos como desarrolladores o el correo que nos da la bienvenida.
- Una vez que creamos la app, vamos a tener que seleccionar los productos, en nuestro caso es Messenger.
- Con el producto Messenger ahora tenemos que escoger los mensajes que se enviara, recomendamos escoger messeges que nos permitir谩 recibir mensajes.
- Con esto, podremos recibir el token de acceso de Facebook y nosotros podremos fijar el token de verificaci贸n. Estos los tenemos que anotar en nuestro archiv config.py y volver a ejecutar nuestra app.
- Tambi茅n nos pedir谩 el URL de nuestro webhook que para nosotros ser谩 la direcci贸n que nos regresa ngrok o la direcci贸n final en la que vivir谩 nuestro chatbot.
- Si el proceso de verificaci贸n pasa (para esto nuestro chatbot necesita est谩r levantado y funcionando), entonces podemos ir a nuestro p谩gina de facebook y buscar el 铆cono del messenger y comenzar a chatear.
Problemas comunes
- Nuestro chatbot no est谩 corriendo, ejecutarlo
- La URL de nuestro webhook cambio, hay que entrar modificar el webhook
- No hay respuesta, nuestro c贸digo de AIML est谩 fallando
Links interesantes
Existen varios tutoriales para hacer el chatbot. Adem谩s tambi茅n existen m谩s opciones de comunicaci贸n entre la plataforma Facebook y chatbot.