espchatbotapi/readme.md

Un chatbot en español

[![Logo](https://i.imgur.com/r74nCr1.png)](https://www.npmjs.com/package/espchatbotapi/)

Una API funcional gratuita y en español dedicada a responder de forma divertida y amena a los mensajes que se solicitan, una manera sencilla de hacer que su app sea interactiva con los usuarios y agregarle una entretenida funcionalidad.

  ![NPM Versión](https://raster.shields.io/badge/Versión-1.3.9-brightgreen)
  ![NPM Descargas](https://raster.shields.io/badge/Descargas-86-blue)
  ![Respuestas](https://raster.shields.io/badge/Respuestas-2083-yellow)
  ![Creador](https://raster.shields.io/static/v1?label=Creador&message=Seyron#5532&color=RED?style=flat&logo=appveyor)

## Instalación
Antes de instalarlo, debe tener instalado [Node.js](https://nodejs.org/en/download/)
La instalación se realiza mediante el [comando de instalación npm](https://docs.npmjs.com/getting-started/installing-npm-packages-locally):

```bash
$ npm install espchatbotapi --save
```


## Características
* API es gratuita sin necesidad de ninguna API Key de pago.
* Respuestas interactivas y graciosas.
* Actualizaciones constantes.

## Constructor
En el constructor debera pasar el token si quiere un token para usar la api solicitalo dando [Click Aqui](https://discord.gg/bGNgRKgWyG)
* 1:Token
* 2:identificador(esto es por si quieres hacer varios bots que no tengan las mismas respuestas si no es asi solo pon el mismo)
Si en el token se introduce "default" y en identificador "default" le dara respuestas ya predefinidas por los creadores de la api y gente de confianza


## Ejemplos

### Ejemplo 1: Petición básica
```js
let chatbot = require("espchatbotapi")
chatbot = new chatbot('token','identificador')
chatbot.obtener("hola").then(respuesta => {
    console.log(respuesta) //respuesta al texto
}).catch(err => {
  console.log(err) //Solo saltara si hay un error mandando el error a la consola
})
```

### Ejemplo 2: Comando usando Discord.js
```js
/* Recordatorio:
 - Para este comando debe tener definido lo que se muestra debajo.
 - Debe tener definido "args" y debe ser un string.
 - Debe tener definido el "prefix".
*/
const Discord = require('discord.js');
const client = new Discord.Client();
let chatbot = require("espchatbotapi")
chatbot = new chatbot('token','identificador')

//Usa el comando hablar
if (message.content.startsWith(prefix + "hablar")) {
	//Solicita una respuesta para el argumento del usuario y obtiene una respuesta de la API
    chatbot.obtener(args).then(respuesta => {
    message.channel.send(respuesta)
    //Le responde al usuario con la respuesta solicitada
    }).catch(err => {
      message.channel.send('Hubo un error')
    })
}
```

### Ejemplo 3: Enseñar al bot(usando token privado)
```js
let chatbot = require("espchatbotapi")
chatbot = new chatbot('token','identificador')

chatbot.enseñar('hola','hola que tal estas?').then(r => {
  console.log(r) //deberia decirte que se enseño correctamente
}).catch(err => {
  console.log(err) //Si ocurre un error
})
```
Si necesitas actualizar algo que se le ha enseñado tendra que borrar el texto y añadir de nuevo con el texto cambiado
### Ejemplo 4: Borrar algo enseñado al bot(usando token privado)
```js
let chatbot = require("espchatbotapi")
chatbot = new chatbot('token','identificador')

chatbot.enseñar('hola','hola que tal estas?').then(r => {
  console.log(r) //deberia decirte que se enseño correctamente
}).catch(err => {
  console.log(err) //Si ocurre un error
})

chatbot.borrar('hola','hola que tal estas?').then(r => {
  console.log(r) //deberia decirte que se borro correctamente
}).catch(err => {
  console.log(err) //Si ocurre un error
})
```
### Ejemplo 5: En caso que no te guste el texto default cuando no hay respuesta
```js
let chatbot = require("espchatbotapi")
chatbot = new chatbot('token','identificador')
chatbot.cambiardefault("No he encontrado respuesta para eso")
```
### Ejemplo 6: Quieres ver todo lo que tienes guardado en el bot?
```js
let chatbot = require("espchatbotapi")
chatbot = new chatbot('token','identificador')
chatbot.obtenertodo().then(r => {
  console.log(r)
})
```
Este metodo tambien es util si quieres encontrar algo para borrar o si pierdes el token para poder pasar todo de un token a otro