# Concepts

> A biblioteca baseia-se em três componentes fundamentais para o seu correcto funcionamento: o fluxo, encarregado de construir o contexto da conversa e de oferecer uma interface amigável ao programador; o fornecedor, que...
>
> - **Canonical URL:** https://www.builderbot.app/pt/concepts
> - **Documentation Index:** https://www.builderbot.app/llms.txt
> - **Full Corpus:** https://www.builderbot.app/llms-full.txt

A biblioteca baseia-se em três componentes fundamentais para o seu correcto funcionamento: o fluxo, encarregado de construir o contexto da conversa e de oferecer uma interface amigável ao programador; o fornecedor, que actua como um conector que permite alternar facilmente entre os fornecedores do WhatsApp sem o risco de afectar outras partes do bot; e a base de dados, que em consonância com esta filosofia do conector, facilita a alteração da camada de persistência de dados sem a necessidade de reescrever o fluxo de trabalho.

```mermaid
flowchart LR
    a{Flow}-->b[(Database)]-->c(((Provider)))
```

---

## Flow

Refere-se à criação de sequências estruturadas de interações, como na construção de fluxos de conversação. Dois métodos principais são addKeyword e addAnswer, que permitem que palavras-chave sejam associadas a respostas específicas, fornecendo opções para personalizar o fluxo da conversa.

```ts (app.ts)
import { addKeyword } from '@builderbot/bot'

addKeyword(['hello','hi']).addAnswer('Ey! welcome')
```

```js (app.js)
const { addKeyword } = require('@builderbot/bot') 

addKeyword(['hello','hi']).addAnswer('Ey! welcome')
```

Alguns exemplos de como usar a palavra-chave add na qual você pode colocar a __keyword__ou uma lista de __keywords__ que será usada para iniciar um fluxo de conversação

```ts
// Example with single keyword
addKeyword('hello').addAnswer('Ey! welcome')

// Example with multi keywords
addKeyword(['hello','hi']).addAnswer('Ey! welcome')
```

Para uma rápida compreensão da operação, preparamos um exemplo básico de como implementar

  [View more examples](/uses-cases)

---

## Provider

É uma peça-chave usada para entregar a mensagem ao fornecedor escolhido. No caso de você estar construindo um bot para o whatsapp, você deve usar um adaptador como __Meta__, __Twilio__, __Baileys__, etc ou mesmo se quiser se conectar ao __Telegram__.

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

// ...stuff code...

const main = async () => {
    
    await createBot({
        database: new MemoryDB(),
        provider: createProvider(BaileysProvider),
        flow: createFlow([flowDemo])
    })
}

main()
```

```ts (provider.wppconnect.ts)
import { addKeyword, MemoryDB, createProvider, createFlow } from '@builderbot/bot'
import { WPPConnectProviderClass } from '@builderbot/provider-wppconnect'

// ...stuff code...

const main = async () => {
    
    await createBot({
        database: new MemoryDB(),
        provider: createProvider(WPPConnectProviderClass),
        flow: createFlow([flowDemo])
    })
}

main()
```

```ts (provider.meta.ts)
import { addKeyword, MemoryDB, createProvider, createFlow } from '@builderbot/bot'
import { MetaProvider } from '@builderbot/provider-meta'

// ...stuff code...

const main = async () => {
    
    await createBot({
        database: new MemoryDB(),
        provider: createProvider(MetaProvider, {
              jwtToken: 'jwtToken',
              numberId: 'numberId',
              verifyToken: 'verifyToken',
              version: 'v16.0',
        }),
        flow: createFlow([flowDemo])
    })
}

main()
```

  [More information about the providers ](/providers)

---

## Database

Assim como os fornecedores podem ser facilmente trocados entre adaptadores, podemos fazer o mesmo com a base de dados. Agora, o importante a entender é como funciona. O principal objetivo do banco de dados dentro da inicialização é fornecer ao bot um registro dos diferentes eventos que ocorreram entre diferentes conversas.

Está pronto para implementar adaptadores de [Mongo](/databases#mongo), [MySQL](/databases#my-sql), [Postgres](/databases#postgres), entre outros.

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

// ...stuff code...

const main = async () => {
    
    await createBot({
        database: new MemoryDB(),
        provider: createProvider(BaileysProvider),
        flow: createFlow([flowDemo])
    })
}

main()
```

```ts (provider.wppconnect.ts)
import { addKeyword, MemoryDB, createProvider, createFlow } from '@builderbot/bot'
import { WPPConnectProviderClass } from '@builderbot/provider-wppconnect'

// ...stuff code...

const main = async () => {
    
    await createBot({
        database: new MemoryDB(),
        provider: createProvider(WPPConnectProviderClass),
        flow: createFlow([flowDemo])
    })
}

main()
```

```ts (provider.meta.ts)
import { addKeyword, MemoryDB, createProvider, createFlow } from '@builderbot/bot'
import { MetaProvider } from '@builderbot/provider-meta'

// ...stuff code...

const main = async () => {
    
    await createBot({
        database: new MemoryDB(),
        provider: createProvider(MetaProvider, {
              jwtToken: 'jwtToken',
              numberId: 'numberId',
              verifyToken: 'verifyToken',
              version: 'v16.0',
        }),
        flow: createFlow([flowDemo])
    })
}

main()
```

  [More information about the databases ](/databases)

----
