Maytapi
Maytapi/Documentație/Getting started
Getting startedAproximativ 10 minuteCum trimiți primul mesaj WhatsApp prin API
De la un cont nou la un mesaj livrat în patru pași: asociezi numărul, copiezi datele de acces, trimiți o cerere și primești confirmarea de livrare. Fără proces de aprobare și fără șabloane.
- asociere prin QR
- pid și token
- o cerere POST
- livrare pe webhook
Patru pași până la primul mesaj
Totul se face din consolă și dintr-un terminal — fără SDK.
-
step 1
Creează un cont
Înregistrează-te în consolă și pornește perioada de probă gratuită — fără card.
-
step 2
Asociază numărul
Adaugă un telefon și scanează codul QR cu WhatsApp de pe telefon (Dispozitive asociate). Numărul rămâne neschimbat.
-
step 3
Copiază datele de acces
pid și token-ul API sunt pe pagina de token din consolă; phone_id apare lângă număr.
-
step 4
Trimite cererea
Fă un POST la /sendMessage cu headerul x-maytapi-key și un corp JSON.
Găsește pid, phone_id și token
Fiecare cerere folosește aceeași adresă de bază cu pid și phone_id, iar token-ul în headerul x-maytapi-key. Poți lista telefoanele și prin API.
- ✓Token și pid: consolă → Settings → Token
- ✓phone_id: lângă fiecare număr sau prin /listPhones
- ✓Păstrează token-ul secret — oferă acces complet la cont
curl "https://api.maytapi.com/api/$PID/listPhones" \ -H "x-maytapi-key: $TOKEN"
Trimite primul mesaj
Trimite un mesaj text către orice număr WhatsApp în format internațional. Cererea adaugă mesajul în coada telefonului și răspunde imediat.
- ✓to_number în format internațional, ex. 4072xxxxx67
- ✓type: text cu un message
- ✓Răspunsul conține id-ul mesajului
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "4072xxxxx67",
"type": "text",
"message": "Hello from the Maytapi WhatsApp API!"
}'const res = await fetch(`https://api.maytapi.com/api/${PID}/${PHONE_ID}/sendMessage`, {
method: "POST",
headers: { "x-maytapi-key": TOKEN, "Content-Type": "application/json" },
body: JSON.stringify({ to_number: "4072xxxxx67", type: "text", message: "Hello from the Maytapi WhatsApp API!" })
});
console.log(await res.json());import requests
res = requests.post(
f"https://api.maytapi.com/api/{PID}/{PHONE_ID}/sendMessage",
headers={"x-maytapi-key": TOKEN},
json={"to_number": "4072xxxxx67", "type": "text", "message": "Hello from the Maytapi WhatsApp API!"},
timeout=10,
)
print(res.json())Verifică dacă a ajuns
Setează un webhook pentru confirmările de livrare și citire sau verifică starea telefonului dacă un mesaj nu pleacă.
- ✓/setWebhook pentru confirmări și mesaje primite
- ✓/{phone_id}/status și /screen pentru sesiune
- ✓/{phone_id}/queue pentru mesajele în așteptare
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/status" \ -H "x-maytapi-key: $TOKEN"
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/queue" \ -H "x-maytapi-key: $TOKEN"
curl -X POST "https://api.maytapi.com/api/$PID/setWebhook" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"webhook": "https://example.com/maytapi/webhook"
}'Ce urmează
-
Primește mesaje
Configurează webhookul pentru mesaje primite și confirmări.
-
Adaugă butoane
Trimite butoane, liste și caruseluri din același endpoint.
-
Evită blocarea
Încălzește numerele noi și află ce declanșează restricțiile.
Întrebări frecvente pentru început
Întreabă echipa de suport orice pe WhatsApp. Timpul mediu de răspuns este sub 24 de ore.
Centru de ajutor →Am nevoie de un număr nou?
Nu. Îți asociezi numărul WhatsApp existent cu un cod QR și continuă să funcționeze pe telefon ca de obicei.
De ce nu a ajuns mesajul?
Verifică întâi starea telefonului — sesiunea trebuie să fie activă. Apoi uită-te la coadă și la loguri în consolă. WhatsApp poate limita și primele mesaje către numere noi; vezi ghidul despre blocare.
Pot testa fără să plătesc?
Da. Perioada de probă deschide toate endpointurile timp de trei zile, fără card.
Alte funcționalități ale API-ului WhatsApp
Obține cheia și trimite primul mesaj în zece minute
Fără aprobare, fără șabloane, fără card. Toate endpointurile sunt deschise timp de trei zile.