Cum trimiți mesaje WhatsApp din aplicațiile tale cu OpenWA

OpenWA este un gateway API pentru WhatsApp: îl legi de un număr și apoi trimiți sau primești mesaje din propriile aplicații printr-un API REST. Util pentru notificări, confirmări de comandă sau un bot de suport. Important din start: este automatizare neoficială, cu risc de restricționare a numărului, deci folosește un număr dedicat, nu numărul tău personal sau al firmei.

1. Instalează OpenWA

Alege OpenWA din catalogul de aplicații. Interfața și API-ul rulează pe portul 2785, legate de localhost, deci nu sunt expuse public. Baza de date implicită este SQLite, suficientă pentru început.

2. Accesează-l printr-un tunel SSH

Fiindcă interfața este legată de localhost, o accesezi printr-un tunel SSH de pe calculatorul tău:

ssh -L 2785:127.0.0.1:2785 root@IP_SERVER

Apoi deschizi http://localhost:2785 în browser. Vezi și autentificarea SSH cu chei.

3. Conectează un număr de WhatsApp

Din interfață creezi o sesiune și scanezi codul QR cu aplicația WhatsApp de pe telefonul cu numărul dedicat (Setări, Dispozitive conectate). Sesiunea rămâne activă pe server.

4. Ia cheia de administrator

OpenWA folosește chei API, nu parolă. La prima pornire generează o cheie de administrator, salvată în /opt/openwa/data/.api-key și afișată în loguri:

cd /opt/openwa && docker compose logs | grep -i "api key"

5. Trimite primul mesaj

Cu sesiunea conectată și cheia în mână, trimiți un mesaj printr-o cerere HTTP. Schema exactă a rutelor o vezi în documentația interactivă de la http://localhost:2785/api/docs. Un exemplu orientativ:

curl -X POST http://localhost:2785/api/messages/send \
  -H "Authorization: Bearer CHEIA_TA_API" \
  -H "Content-Type: application/json" \
  -d '{"session":"default","to":"40712345678","text":"Salut de la aplicatia mea"}'

Din codul aplicației tale faci exact aceeași cerere, cu cheia păstrată ca secret, nu în cod.

6. Primește mesaje prin webhook

Pentru mesaje primite sau confirmări de livrare, configurezi un webhook: OpenWA trimite un POST către URL-ul tău la fiecare eveniment, semnat HMAC ca să verifici autenticitatea. Așa construiești un bot care răspunde automat.

Reguli de folosire responsabilă

• Număr dedicat: nu lega numărul personal sau principal al firmei.
• Fără mesaje în masă la reci: trimite doar către persoane care se așteaptă la mesaj, altfel riști blocarea numărului.
• Ritm rezonabil: respectă limitele și pauzele, nu trimite sute de mesaje pe minut.
• Secretele în variabile de mediu: cheia API nu se pune niciodată în cod public.

Pentru fluxuri mai complexe, poți lega OpenWA de un motor de automatizare precum n8n.