Uau! Emoji of happy man Mediu sandbox complet pentru dezvoltatori — gratuit pentru totdeauna! Înregistrați-vă acum
Documentație pentru dezvoltatori · HTTP API

Documentație WhatsApp API

Tot ce ai nevoie pentru a trimite și primi mesaje WhatsApp, a automatiza grupuri și a construi integrări folosind cereri HTTP simple.
API-ul suportă mesaje, media, fișiere, statusuri, grupuri, comunități și canale. Poți primi conversații de intrare, trimite produse, procesa comenzi, valida numere și construi automatizări personalizate.

Obține token API și începe Răsfoiește referința API
Începe să trimiți mesaje WhatsApp în câteva minute

Pornește în 3 pași simpli

Icon

Creează un cont și conectează un număr

Creează un cont Whapi.Cloud și conectează-ți numărul WhatsApp prin cod QR.

Icon

Obține token-ul API

Copiază token-ul API din panoul de control și autorizează cererile tale.

Icon

Trimite primul mesaj

Fă primul apel API și primește mesaje prin webhooks.

Creează cont și obține token API Citește ghidul de pornire
Experiență orientată către dezvoltatori

Testează API-ul cu instrumentele tale preferate

După ce ai un token API, poți explora și testa toate endpoint-urile folosind Swagger sau Postman. Folosește token-ul API ca antet de autorizare Bearer.

Testează în Swagger

/

Testează API-ul cu <span>instrumentele tale preferate</span>
Testează API-ul cu <span>instrumentele tale preferate</span>
Decorartive bubble
Pornește <span>mai rapid</span> cu proiecte gata făcute <span>pe GitHub</span>
Exemple open-source

Pornește mai rapid cu proiecte gata făcute pe GitHub

Explorează exemple reale și proiecte de pornire construite pe baza API-ului Whapi.Cloud. Repository-urile noastre GitHub includ boți funcționali, utilitare și scripturi de automatizare în mai multe limbaje — concepute pentru a te ajuta să înțelegi API-ul mai rapid și să lansezi cu încredere.

  • Bot WhatsApp Node.js: Un exemplu pregătit pentru producție pentru construirea de boți și automatizări folosind JavaScript.
  • Boți PHP (2 niveluri): Exemplu pentru începători (configurare minimă, structură clară) și bot avansat — logică mai complexă, gestionarea mesajelor, grupuri și webhooks.
  • Boți Python (2 niveluri): Bot simplu pentru experimente rapide și implementare avansată cu funcționalități extinse și gestionarea evenimentelor.
  • Bot Java: Implementare simplă și directă de chatbot pentru un start rapid în dezvoltare.
  • WhatsApp Number Checker: Un exemplu practic de verificare a disponibilității numerelor WhatsApp, cu ritmare sigură și procesare pe loturi.
Vezi repository-urile GitHub
Decorartive bubble
Întrebări operaționale uzuale

Întrebări frecvente

Whapi.Cloud se conectează la WhatsApp folosind o sesiune de tip linked-device. Contul tău WhatsApp este asociat unui canal prin cod QR sau cod de asociere, similar cu WhatsApp Web, însă conexiunea este menținută prin socket-uri backend. API-ul acționează apoi ca un gateway securizat care trimite și primește evenimente (mesaje, statusuri, actualizări de grupuri) în timp real și le expune prin endpoint-uri HTTP și webhook-uri.
Nu. După ce numărul este conectat, telefonul nu trebuie să rămână permanent online. Totuși, WhatsApp poate solicita activitate ocazională pe dispozitivul principal pentru a menține sesiunea activă. În practică, deschiderea WhatsApp pe telefon o dată la câteva săptămâni este, de regulă, suficientă.
Da. Poți continua să folosești WhatsApp în mod normal pe telefon și în WhatsApp Web în timp ce API-ul este conectat. API-ul rulează în paralel ca un dispozitiv suplimentar asociat și nu blochează sau înlocuiește utilizarea obișnuită.
În anumite cazuri, WhatsApp poate invalida automat sesiunile linked-device. Dacă se întâmplă acest lucru, canalul va necesita reautorizare prin scanarea unui nou cod QR sau folosirea unui cod de asociere. Nu se pierde niciun fel de date, iar după reconectare API-ul își reia imediat funcționarea normală.
Da. Deși API-ul în sine nu impune limite stricte de trimitere pe planurile plătite, WhatsApp monitorizează activ comportamentul conturilor. Utilizarea sigură depinde mai mult de modul de trimitere a mesajelor decât de API în sine. Încălzirea graduală, ritmul rezonabil, conținutul relevant și interacțiunea destinatarilor joacă un rol esențial. Modelele agresive sau nefirești de trimitere pot declanșa restricții indiferent de instrumentul utilizat, motiv pentru care fluxurile de producție trebuie să includă întotdeauna întârzieri, trimitere în loturi și un control de bază al ratei.
Webhook-urile sunt callback-uri HTTP în timp real trimise de Whapi.Cloud către serverul tău ori de câte ori apar evenimente relevante. Ele sunt declanșate la primirea mesajelor, la schimbarea statusurilor de livrare sau citire, la evenimente din grupuri sau canale ori la alte actualizări legate de WhatsApp. Acest mecanism permite sistemului tău să reacționeze instantaneu fără a interoga constant API-ul, webhook-urile fiind principalul mod de a construi automatizări și boți orientați pe evenimente.
Da. API-ul este conceput pentru a susține funcționare continuă și fluxuri de lungă durată, precum chatboți, servicii de notificare, integrări CRM și sisteme de monitorizare. Odată ce un număr este conectat și autorizat corect, API-ul poate funcționa pe termen nelimitat, atâta timp cât WhatsApp nu resetează sesiunea linked-device. Pentru utilizare stabilă și neîntreruptă în medii de producție, este recomandat un plan plătit.
Utilizarea API-ului în sine nu crește automat riscul de blocare. Restricțiile sunt cauzate în principal de modul în care este utilizat contul WhatsApp. Comportamentele care par spam, reputația slabă a numărului, interacțiunea scăzută a destinatarilor sau feedback-ul negativ pot duce la limitări, cu sau fără API. Respectarea bunelor practici, precum încălzirea graduală, viteza controlată de trimitere și conținutul relevant, reduce semnificativ riscurile.
Whapi.Cloud nu stochează permanent conținutul mesajelor tale. Mesajele sunt procesate în timp real pentru livrare, declanșarea webhook-urilor și generarea evenimentelor de livrare. Atât timp cât un canal este activ, datele mesajelor pot fi păstrate temporar în cache-uri tehnice de scurtă durată, strict pentru procesare, rutare și gestionarea evenimentelor. Odată ce un canal este deconectat sau devine inactiv, niciun conținut de mesaje nu este păstrat de partea Whapi.Cloud. API-ul nu este conceput ca un sistem de stocare sau arhivare a mesajelor. Orice stocare pe termen lung, analiză sau istoric al mesajelor trebuie implementate în propria infrastructură, folosind webhook-uri și răspunsurile API.

Endpoint-uri WhatsApp REST API

Parametrii în cererile GET sunt transmiși prin query string. Parametrii din cererile POST sunt trimiși prin corpul cererii codificat JSON. Folosește token-ul ca antet de autorizare Bearer. Obține un token pentru WhatsApp API!