Guias

Tutoriais práticos que mostram como realizar tarefas comuns de automação no WhatsApp com whatsmeow-node.

Primeiros Passos

Usar whatsmeow no Node.js

Instale o pacote npm, conecte ao WhatsApp e comece a usar whatsmeow no TypeScript — sem configurar Go.

Criar um Bot

Crie um bot de WhatsApp do zero — receba mensagens, trate comandos, envie respostas.

Parear WhatsApp

Vincule uma conta WhatsApp via QR code ou código por número de telefone.

JIDs, LIDs e IDs de Dispositivo

Entenda JIDs, remetentes @lid e sufixos de dispositivo — normalize, compare e monte JIDs com segurança.

Deploy em Produção

Rode seu bot 24/7 com Docker, systemd ou PM2 — sessões persistentes, encerramento gracioso, health checks e alertas.

Mensagens

Enviar Mensagens pelo TypeScript

Texto, respostas, menções, mídia, enquetes e reações — tudo com tipagem segura.

Automatizar Mensagens em Grupos

Envie para grupos, mencione membros, transmita para vários grupos e gerencie participantes.

Enviar Stickers

Faça upload e envie stickers WebP, baixe stickers recebidos.

Indicadores de Digitação

Mostre indicadores 'digitando...' e 'gravando áudio...', inscreva-se na presença de outros.

Mídia

Baixar Mídias

Salve imagens, vídeos, áudios e documentos recebidos no disco.

Migração

Migrar do Baileys

Comparação lado a lado de APIs e guia passo a passo para migrar do Baileys para whatsmeow-node.

Migrar do whatsapp-web.js

Remova o Puppeteer, reduza a memória de 500 MB para 20 MB e ganhe uma API async tipada.

Integrações de IA

Conectar ao Claude AI

Crie um chatbot de WhatsApp com IA usando Claude e o SDK da Anthropic.

Conectar ao ChatGPT (OpenAI)

Crie um chatbot de WhatsApp com GPT-6 Astra usando o SDK da OpenAI.

Conectar ao Google Gemini

Crie um chatbot de WhatsApp com Gemini usando o SDK do Google GenAI.

Conectar ao DeepSeek

Crie um chatbot de WhatsApp com DeepSeek usando a API compatível com OpenAI.

Conectar ao Ollama (IA Local)

Execute um modelo de IA local — sem API key, sem custos, privacidade total.

Transcrever Áudios

Transcreva áudios recebidos com o speech-to-text da OpenAI e responda com a transcrição.

Triagem com Jev

Encaminhe, priorize e modere mensagens do WhatsApp com o Jev — chame um LLM só quando precisar responder.

Automação

Enviar Notificações

Envie alertas, lembretes e atualizações pelo WhatsApp a partir de qualquer app Node.js ou endpoint HTTP.

Agendar Mensagens

Envios atrasados, lembretes recorrentes e agendamento baseado em cron.

Criar um Bot de Enquetes

Crie enquetes, decifre votos, contabilize resultados e anuncie vencedores.

Encaminhar Mensagens

Encaminhe mensagens entre chats — texto, mídia e qualquer tipo de mensagem.

Arquivar Histórico de Conversas

Salve o histórico de conversas e as novas mensagens no SQLite com history sync, upserts e backfill sob demanda.

Integrações com Ferramentas

Integração com Whaticket

Substitua o whatsapp-web.js no Whaticket — sem Puppeteer, menos memória, mais estabilidade.

Integração com n8n

Conecte whatsmeow-node ao n8n para automação de workflows no WhatsApp.

Integração com Chatwoot

Use whatsmeow-node como canal WhatsApp no Chatwoot — sem Cloud API.

Integração com Typebot

Conecte fluxos do Typebot ao WhatsApp via whatsmeow-node — substitua a Evolution API.

Procurando trechos de código?

A seção de Exemplos tem código focado e pronto para copiar para funcionalidades específicas — mídia, grupos, enquetes, reações e mais.