# Telegram

> O Telegram é um provedor amigável, neste artigo você aprenderá como integrar seus bots do Telegram à biblioteca.
>
> - **Canonical URL:** https://www.builderbot.app/pt/plugins/telegram
> - **Documentation Index:** https://www.builderbot.app/llms.txt
> - **Full Corpus:** https://www.builderbot.app/llms-full.txt

> **NOTE:**
> Crie seu primeiro bot do Telegram se ainda não tiver um [create your firts Telegram bot](https://core.telegram.org/bots/tutorial "Create your firts Telegra bot")

Para implementar um chatbot no Telegram, você precisa instalar a biblioteca `@builderbot-plugins/telegram`

## Install

```bash (npm)
    npm install @builderbot-plugins/telegram
```

```typescript
    import { createBot, MemoryDB, createProvider, addKeyword, createFlow, EVENTS } from '@builderbot/bot'
    import { createShopifyFlow } from '@builderbot-plugins/shopify'
    import { TelegramProvider } from '@builderbot-plugins/telegram'

    const main = async () => {
        const provider = createProvider(TelegramProvider, {
            token: 'YOUR_TOKEN_HERE'
        })

        const { flow } = await createShopifyFlow()

        await createBot({
            database: new MemoryDB(),
            provider,
            flow: createFlow(flow)
        })

    }
    main()
```
Ao executar o Provedor de telegramas, você deve ver algo assim:

![loaded](https://imgur.com/38pH9Ad.png)

## Flows
Crie seu primeiro fluxo com o Telegram.

```ts
    /* code stuff */

    const provider = createProvider(TelegramProvider, {
            token: 'YOUR_TOKEN_HERE'
    })
    const welcome = addKeyword(EVENTS.WELCOME).addAnswer('Hi, Welcome to Telegram!');

    await createBot({
        database: new MemoryDB(),
        provider,
        flow: createFlow([welcome])
    })

    /* code stuff */
```
![flow](https://imgur.com/VC3NvtD.png)

It seems like magic, right!

## Webhook

Tudo bem, vamos continuar. Se você precisar expor uma porta ou uma API para ouvir o envio de mensagens, faça o seguinte.

```typescript
    import 'dotenv/config'
    import { createBot, MemoryDB, createProvider, addKeyword, createFlow, EVENTS } from '@builderbot/bot'
    import { createShopifyFlow } from '@builderbot-plugins/shopify'
    import { TelegramProvider, handleCtx } from '@builderbot-plugins/telegram'

    const main = async () => {

        const provider = createProvider(TelegramProvider, {
            token: "YOUR_TELEGRAM_TOKEN_HERE"
        })

        provider.initHttpServer(9000)
            .server.post('/webhook', handleCtx((null, req, res) => {
                    console.log('I am function what doing someting')
                    res.end('ok')
            }))
        
        const welcomeFlow = addKeyword('Hi!!').addAnswer('Hi!, friend.')

        await createBot({
            database: new MemoryDB(),
            provider,
            flow: createFlow([welcomeFlow])
        })

    }

    main()
```

aqui algumas telas do exemplo acima

![Imgur](https://imgur.com/JgXOUZw.png)
![Imgur](https://imgur.com/4uRkIrg.png)
![Imgur](https://imgur.com/7XFKtUc.png)
![Imgur](https://imgur.com/2zOp2GR.png)
