Ir para o conteúdo

API WhatsApp gratuita com Node.js e TypeScript

O repositório descreve uma alternativa gratuita e autossuficiente para integrar o WhatsApp em aplicações, eliminando a necessidade de planos pagos da WhatsApp Business API. Ele funciona como uma camada de serviço que permite enviar e receber mensagens diretamente pelo número próprio do desenvolvedor ou da empresa.

Principais recursos

  • Envio de texto, imagens, vídeos, documentos e outros arquivos via WhatsApp.
  • Sistema de fila inteligente que assegura que nenhuma mensagem seja perdida mesmo em picos de carga.
  • Autenticação baseada em JWT com suporte a múltiplos usuários simultâneos.
  • Login simplificado por QR code, bastante escanear o código para vincular a sessão.
  • Pronto para Docker, com instruções de implantação em serviços como Heroku.
  • Código escrito em TypeScript, com tipagem estática e documentação clara.

Como funciona

A API expõe endpoints REST que aceitam payloads JSON contendo o destinatário e o conteúdo da mensagem. Internamente, ela gerencia a conexão com o WhatsApp Web usando a sessão criada pelo login em QR code, garantindo que as mensagens sejam enviadas como se o usuário estivesse usando o aplicativo oficial, mas sem depender de infraestrutura da Meta.

Exemplo de requisição de envio de texto

curl -X POST https://seu-dominio.com/api/messages \
  -H "Authorization: Bearer <SEU_TOKEN_JWT>" \
  -H "Content-Type: application/json" \
  -d '{
        "to": "5511999999999",
        "type": "text",
        "text": {
          "body": "Olá, esta é uma mensagem de teste via API WhatsApp!"
        }
      }'

Como implantar

  1. Clone o repositório.
  2. Crie um arquivo .env com as variáveis necessárias (por exemplo, porta, segredo JWT).
  3. Execute docker compose up -d para subir o container.
  4. Acesse o endpoint de login, escaneie o QR code com o WhatsApp do número desejado e pronto – a API estará operante.

Dica

Para ambientes de produção, configure um reverse proxy (NGINX, Traefik) e habilite HTTPS para proteger os tokens JWT.

Pontos-chave

  • API REST gratuita para WhatsApp baseada em Node.js e TypeScript.
  • Suporta envio de mídia, fila inteligente, autenticação JWT e login por QR code.
  • Pronta para Docker e fácil de implantar em Heroku ou similares.
  • Ideal para notificações automáticas, chatbots, CRM e automação de marketing.
  • Código limpo, tipado e bem documentado, facilitando manutenção e extensão.

Ferramentas e Tecnologias

  • [[TypeScript]]
  • [[Docker]]
  • [[Heroku]]
  • [[JWT]]

Nota pessoal

https://x.com/i/status/2048229014536429783

Tags

whatsapp #nodejs #typescript #docker #deploy