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()){
"success": true,
"data": {
"chatId": "4072xxxxx67@c.us",
"msgId": "3EB065B353B9493D00C9"
}
}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 prin e-mail sau din centrul de ajutor. 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.