# Events

> En ocasiones los usuarios envían mensajes como una imagen, un video o mensajes de ubicación especial, entre otros, para recibir e iniciar una conversación cuando llega un mensaje de este tipo podemos utilizar los...
>
> - **Canonical URL:** https://www.builderbot.app/es/events
> - **Documentation Index:** https://www.builderbot.app/llms.txt
> - **Full Corpus:** https://www.builderbot.app/llms-full.txt

En ocasiones los usuarios envían mensajes como una imagen, un video o mensajes de ubicación especial, entre otros, para recibir e iniciar una conversación cuando llega un mensaje de este tipo podemos utilizar los eventos.

```mermaid
flowchart BT
    a(User)-.->eW((Welcome))-.->b[(BOT)]
    s(User)-.->eM((Image/Video))-.->b[(BOT)]
    c(User)-.->eD((Document))-.->b[(BOT)]
    d(User)-.->eL((Location))-.->b[(BOT)]
    e(User)-.->eV((Voice Note))-.->b[(BOT)]
```

---

## Default  

Cuando un usuario envía un mensaje de "texto" que no existe en una palabra clave en otro flujo, el WELCOME el evento se activará de forma predeterminada, que es el evento predeterminado.

Imaginemos el caso en el que una persona escribe la palabra `¡Gracias!`

```ts (app.ts)
  import { addKeyword, EVENTS } from '@builderbot/bot'
  
  const welcomeFlow = addKeyword(EVENTS.WELCOME).addAnswer('Ey welcome?')
  const greetingFlow = addKeyword(['hello','hi']).addAnswer('Hi!')
```
```js (app.js)
  const { addKeyword, EVENTS } = require('@builderbot/bot')
  
  const welcomeFlow = addKeyword(EVENTS.MEDIA).addAnswer('Message hello')
```

  
  ```mermaid
flowchart TB
    A(User) --"Thank you!"--> B((BOT))
    B --> C[Flows]
    C --> G["welcomeFlow"]
    G -. Ey welcome? .-> A

  style B fill:#fff2b2,stroke:#ffee99,stroke-width:2px
  style G fill:#b2f7ef,stroke:#9ceaef,stroke-width:2px
```
  
  
```mermaid
flowchart TB
    A(User) --"hello"--> B((BOT))
    B --> C[Flows]
    C --> G["greetingFlow"]
    G -. Hi .-> A

  style B fill:#fff2b2,stroke:#ffee99,stroke-width:2px
  style G fill:#b2f7ef,stroke:#9ceaef,stroke-width:2px
```
  

Podemos ver en el diagrama anterior que el bot realiza una búsqueda en todos los flujos para obtener el mejor flujo que pueda responder a la palabra clave "Thank You" pero como no encuentra, se activa la "WELCOME".

---

## Received Image or Video 

Cuando un usuario envía una imagen o un video, el evento MEDIA, que es el evento predeterminado, se activará de forma predeterminada. Esto es ideal para cuando necesitamos que envíen información y necesitamos almacenarla.

```ts (app.ts)
  import { addKeyword, EVENTS } from '@builderbot/bot'
  
  const mediaFlow = addKeyword(EVENTS.MEDIA).addAnswer('I received a media image/video')
```
```js (app.js)
  const { addKeyword, EVENTS } = require('@builderbot/bot')
  
  const mediaFlow = addKeyword(EVENTS.MEDIA).addAnswer('I received a media image/video')
```

> **NOTE:**
> Para guardar el archivo multimedia, debe invocar la función saveFile del proveedor que está utilizando.

```ts (app.ts)
  import { addKeyword, EVENTS } from '@builderbot/bot'
  import { BaileysProvider } from '@builderbot/provider-baileys'

  const mediaFlow = addKeyword<BaileysProvider>(EVENTS.MEDIA)
  .addAnswer('I received a media image/video', async (ctx, { provider }) => {
    const localPath = await provider.saveFile(ctx, {path:'...'})
    //console.log(localPath)
  })
```
```js (app.js)
  const { addKeyword, EVENTS } = require('@builderbot/bot')
  const { BaileysProvider } = require('@builderbot/bot')
  
  const mediaFlow = addKeyword(EVENTS.MEDIA)
  .addAnswer('I received a media image/video', async (ctx, { provider }) => {
    const localPath = await provider.saveFile(ctx, {path:'...'})
    //console.log(localPath)
  })
```

---

## Received Document 

Cuando un usuario envía un documento, el evento del DOCUMENT se activará de forma predeterminada, que es el evento predeterminado.

```ts (app.ts)
  import { addKeyword, EVENTS } from '@builderbot/bot'
  
  const documentFlow = addKeyword(EVENTS.DOCUMENT)
  .addAnswer("Wow! I'm sorry I can't read this document right now", async (ctx, { provider }) => {
    const localPath = await provider.saveFile(ctx, {path:'...'})
    //console.log(localPath)
  })
```
```js (app.js)
  const { addKeyword, EVENTS } = require('@builderbot/bot')
  
  const documentFlow = addKeyword(EVENTS.DOCUMENT)
  .addAnswer("Wow! I'm sorry I can't read this document right now", async (ctx, { provider }) => {
    const localPath = await provider.saveFile(ctx, {path:'...'})
    //console.log(localPath)
  })
```

---

## Received Location 

> **NOTE:**
> LOCATION debe enviarse a través de WhatsApp, aún no permite enlaces de ubicación desde aplicaciones externas

Cuando su chatbot necesita acceder a la ubicación de un usuario, es importante asegurarse de que la ubicación se envíe directamente desde la aplicación WhatsApp para obtener resultados. Una vez recibida la ubicación, puede realizar un registro de consola de ctx para ver los detalles de la ubicación recibida.

El contexto de ubicación recibido se verá así en la consola:

```bash
ctx:  {
  ...
  message: Message {
    locationMessage: LocationMessage {
      degreesLatitude: -2.1462137699127197,
      degreesLongitude: -79.88981628417969,
      name: 'Doctor Miguel Angel Jijón Teran',
      address: 'Doctor Miguel Angel Jijón Teran, Guayaquil, Ecuador',
    },
  },
  body: '_event_location__0d5c9f57-0909-44a1-995f-902f9df3b21f',
  name: 'yeyodev 👨🏾‍💻',
  from: '593000000000'
}
```

Esto generará la latitud y longitud del usuario en la consola, lo que le permitirá utilizar de manera efectiva los datos de ubicación para la funcionalidad de su chatbot.

Para acceder a los datos de ubicación, puede utilizar el siguiente enfoque:

```ts (location.flow.ts)
import { EVENTS, addKeyword } from "@builderbot/bot";

export default addKeyword(EVENTS.LOCATION)
.addAnswer("I have received your location!", null, async (ctx) => {
  const userLatitude = ctx.message.locationMessage.degreesLatitude;
  const userLongitude = ctx.message.locationMessage.degreesLongitude;
})
```
```js (location.flow.js)
const { EVENTS, addKeyword } = require("@builderbot/bot");

export default addKeyword(EVENTS.LOCATION)
.addAnswer("I have received your location!", null, async (ctx) => {
  const userLatitude = ctx.message.locationMessage.degreesLatitude;
  const userLongitude = ctx.message.locationMessage.degreesLongitude;
})
```

---

## Received Voice Note 

Cuando un usuario envía una nota de voz, el evento VOICE_NOTE se activará de forma predeterminada, que es el evento previsto para este comportamiento, es importante comprender que una nota de voz es diferente de un archivo de imagen o video.

```ts (app.ts)
  import { addKeyword, EVENTS } from '@builderbot/bot'
  
  const voiceNoteFlow = addKeyword(EVENTS.VOICE_NOTE)
  .addAnswer('Give me a second to hear you!', async (ctx, { provider }) => {
    const localPath = await provider.saveFile(ctx, {path:'...'})
    //console.log(localPath)
  })
  
```
```js (app.js)
  const { addKeyword, EVENTS } = require('@builderbot/bot')
  
  const voiceNoteFlow = addKeyword(EVENTS.VOICE_NOTE)
  .addAnswer('Give me a second to hear you!', async (ctx, { provider }) => {
    const localPath = await provider.saveFile(ctx, {path:'...'})
    //console.log(localPath)
  })
```

---
