Venom Provider

npm install @builderbot/bot @builderbot/provider-venom

import { createBot, createProvider, createFlow } from '@builderbot/bot'
import { VenomProvider } from '@builderbot/provider-venom'
import { MemoryDB } from '@builderbot/bot'

const provider = createProvider(VenomProvider, {
  name: 'my-bot',
  gifPlayback: false
})

const { handleCtx, httpServer } = await createBot({
  flow: adapterFlow,
  provider: provider,
  database: new MemoryDB(),
})

httpServer(3000)

const provider = createProvider(VenomProvider, {
  name: 'my-bot',      // Session name
  gifPlayback: false,  // Send videos as GIF
  port: 3000,          // HTTP server port
  headless: 'new',     // Browser headless mode
  autoClose: 45000,    // Auto-close browser timeout (ms)
  folderNameToken: undefined // Custom session folder
})

{name}_sessions/

import { addKeyword } from '@builderbot/bot'

const welcomeFlow = addKeyword(['hi', 'hello'])
  .addAnswer('Hello! Welcome to our service')
  .addAnswer('How can I assist you?')

import { join } from 'path'

const mediaFlow = addKeyword('media')
  // Send image
  .addAnswer('Here is an image:', {
    media: join(process.cwd(), 'assets', 'image.jpg')
  })
  // Send video
  .addAnswer('Check this video:', {
    media: './assets/video.mp4'
  })
  // Send audio
  .addAnswer('Listen to this:', {
    media: './assets/audio.mp3'
  })
  // Send document
  .addAnswer('Here is a PDF:', {
    media: './assets/document.pdf'
  })

const imageFlow = addKeyword('image')
  .addAction(async (ctx, { provider }) => {
    await provider.sendImage(
      ctx.from,
      './path/to/image.jpg',
      'Check out this image!'
    )
  })

const videoFlow = addKeyword('video')
  .addAction(async (ctx, { provider }) => {
    await provider.sendVideo(
      ctx.from,
      './path/to/video.mp4',
      'Watch this'
    )
  })

const voiceFlow = addKeyword('voice')
  .addAction(async (ctx, { provider }) => {
    await provider.sendAudio(
      ctx.from,
      './path/to/audio.ogg'
    )
  })

const documentFlow = addKeyword('document')
  .addAction(async (ctx, { provider }) => {
    await provider.sendFile(
      ctx.from,
      './path/to/document.pdf',
      'Here is the requested file'
    )
  })

// Note: Buttons are deprecated in WhatsApp
// This will send text with button labels
const buttonFlow = addKeyword('options')
  .addAnswer(
    'Choose an option:',
    {
      buttons: [
        { body: 'Option 1' },
        { body: 'Option 2' }
      ]
    }
  )
// Sends: "Choose an option:\nOption 1\nOption 2"

import { join } from 'path'

const receiveMediaFlow = addKeyword('MEDIA')
  .addAction(async (ctx, { provider, flowDynamic }) => {
    const filePath = await provider.saveFile(ctx, {
      path: join(process.cwd(), 'downloads')
    })
    
    await flowDynamic(`File saved: ${filePath}`)
  })

const autoMediaFlow = addKeyword('send')
  .addAnswer('Sending file...', {
    media: './file.jpg'  // Auto-detected as image
  })

provider.on('message', (payload) => {
  if (payload.type === 'image' || payload.type === 'video') {
    console.log('Received media')
  } else if (payload.type === 'ptt') {
    console.log('Received voice note')
  } else if (payload.type === 'document') {
    console.log('Received document')
  }
})

provider.on('ready', () => {
  console.log('Venom is ready!')
})

provider.on('host', (host) => {
  console.log('Connected as:', host.name)
  console.log('Phone:', host.phone)
})

provider.on('require_action', ({ title, instructions, payload }) => {
  console.log(title)
  console.log(instructions.join('\n'))
  // QR available at http://localhost:3000/
})

// This is handled internally by the provider
// Calls are logged but not auto-rejected

{name}_sessions/

rm -rf {name}_sessions

const provider = createProvider(VenomProvider, {
  name: 'bot',
  headless: 'new'  // 'new', true, false
})

const provider = createProvider(VenomProvider, {
  name: 'bot',
  // Venom will pass these to Puppeteer
  browserArgs: ['--no-sandbox', '--disable-setuid-sandbox']
})

GET http://localhost:3000/

import { createBot, createProvider, createFlow, addKeyword } from '@builderbot/bot'
import { VenomProvider } from '@builderbot/provider-venom'
import { MemoryDB } from '@builderbot/bot'
import { join } from 'path'

const welcomeFlow = addKeyword(['hi', 'hello', 'start'])
  .addAnswer('👋 Welcome to our WhatsApp service!')
  .addAnswer('How can we help you today?')

const mediaFlow = addKeyword('files')
  .addAnswer('Sending media files...')
  .addAnswer('Image:', {
    media: join(process.cwd(), 'assets', 'image.png')
  })
  .addAnswer('Document:', {
    media: join(process.cwd(), 'assets', 'document.pdf')
  })

const voiceFlow = addKeyword('voice')
  .addAction(async (ctx, { provider }) => {
    await provider.sendAudio(
      ctx.from,
      './assets/audio.mp3'
    )
  })

const main = async () => {
  const adapterFlow = createFlow([welcomeFlow, mediaFlow, voiceFlow])
  
  const adapterProvider = createProvider(VenomProvider, {
    name: 'my-venom-bot',
    gifPlayback: false,
    headless: 'new'
  })
  
  const adapterDB = new MemoryDB()

  const { handleCtx, httpServer } = await createBot({
    flow: adapterFlow,
    provider: adapterProvider,
    database: adapterDB,
  })

  httpServer(3000)
}

main()