bot-figurinhas is a Node.js project that lets users send custom animated stickers in WhatsApp's Lottie (.was) format. WhatsApp's official mobile app blocks direct imports of modified .was files, a restriction this bot circumvents. It works by generating the sticker package through code and injecting it straight into Meta's servers, using the Baileys library for WhatsApp connectivity. Hosted on GitHub under voi1d/bot-figurinhas, the repository has 21 stars and is written in JavaScript.

The project targets a specific pain point for WhatsApp users who create custom animations. Native sticker tools handle standard formats, but Lottie files—often used for smooth, vector-based animations—get rejected if altered. This bot acts as a workaround, automating the packaging and sending process without needing app modifications.

Core features

bot-figurinhas focuses on a narrow but effective set of capabilities:

  • Bypasses .was import limits: Converts an input image into a Lottie sticker package, then sends it via WhatsApp's backend, avoiding mobile app checks.
  • Baileys integration: Relies on the open-source Baileys library for multi-device WhatsApp sessions, supporting pairing codes over QR scans.
  • Simple image-to-sticker flow: Processes a single image file (minha_foto.jpg) placed in the project root; triggers via !testar command.
  • Cross-platform compatibility: Adapts a Lottie packaging script from Pedrozz13755/Lottie-Whatsapp using the adm-zip library, working on Windows, Mac, and Linux.
  • Pairing code login: Generates an 8-digit code for easy device linking through WhatsApp's "Link with phone number" option.

These features keep the bot lightweight, with no database or web interface—just a console script.

Getting it running

Setup follows standard Node.js steps and takes under five minutes for most users. The process assumes Node.js is installed (version not

View on GitHub →