Maytapi
Maytapi/Documentație/Trimitere mesaje
Trimitere mesajeUn singur endpoint pentru orice tip de mesajTrimite mesaje WhatsApp prin API, de pe propriul număr
O singură cerere POST trimite un text, un fișier, un mesaj cu butoane sau o locație către orice număr, grup sau canal WhatsApp. Fără aprobare de șabloane, fără fereastră de conversație și fără taxe per mesaj.
- POST /sendMessage
- text · media · butoane
- grupuri și canale
- confirmări de livrare
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": "Your order #10482 has shipped."
}'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: "Your order #10482 has shipped." })
});
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": "Your order #10482 has shipped."},
timeout=10,
)
print(res.json())$ch = curl_init("https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["x-maytapi-key: $TOKEN", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode(["to_number" => "4072xxxxx67", "type" => "text", "message" => "Your order #10482 has shipped."]),
]);
echo curl_exec($ch);
Ce poți trimite cu API-ul WhatsApp
Schimbi câmpul type, iar același endpoint trimite altceva.
-
type: text
Text
Actualizări de comandă, mementouri, coduri OTP și răspunsuri, cu formatare WhatsApp.
-
type: media
Imagini, video, fișiere
Trimite prin URL sau base64: facturi, fotografii, mesaje vocale și documente, în limitele WhatsApp.
-
type: buttons
Butoane și liste
Răspunsuri rapide, linkuri, butoane de apel, butoane de copiere a codului, liste și carusele.
-
type: location
Locație și contacte
Trimite un pin pe hartă, un vCard sau un card de contact WhatsApp.
Trimite un mesaj WhatsApp cu o singură cerere
Pune tokenul în headerul x-maytapi-key și trimite un corp JSON cu destinatarul și mesajul. API-ul pune mesajul în coadă pe numărul tău și returnează imediat ID-ul lui.
- ✓to_number în format internațional, de ex. 4072xxxxx67
- ✓Funcționează din orice limbaj care poate face o cerere HTTP
- ✓Răspunsul include ID-ul mesajului pentru urmărire
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": "Your order #10482 has shipped."
}'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: "Your order #10482 has shipped." })
});
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": "Your order #10482 has shipped."},
timeout=10,
)
print(res.json())$ch = curl_init("https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["x-maytapi-key: $TOKEN", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode(["to_number" => "4072xxxxx67", "type" => "text", "message" => "Your order #10482 has shipped."]),
]);
echo curl_exec($ch);Trimite fișiere, imagini și mesaje vocale
Transmite un URL public sau un șir base64. Adaugă o descriere, un nume de fișier sau calitate HD pentru imagini.
- ✓Facturi PDF și documente cu nume de fișier
- ✓Imagini și video cu descriere
- ✓Stickere, mesaje vocale și audio
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@c.us",
"type": "media",
"message": "https://example.com/invoice-10482.pdf",
"text": "Your invoice for order #10482",
"filename": "invoice-10482.pdf"
}'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@c.us",
"type": "media",
"message": "https://example.com/product.jpg",
"text": "New arrival",
"isHd": true
}'Trimite butoane pe care oamenii le pot apăsa
Clienții răspund cu o singură atingere, iar răspunsul ajunge pe webhook împreună cu ID-ul butonului, așa că aplicația ta știe exact ce s-a ales.
- ✓Butoane de răspuns rapid, URL, apel și copiere a codului
- ✓Liste cu secțiuni pentru meniuri
- ✓Fără aprobare de șabloane pentru niciunul dintre ele
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@c.us",
"type": "buttons",
"message": "Your order #10482 has shipped. Want to follow it?",
"buttons": [
{
"id": "track",
"text": "Track order"
},
{
"id": "address",
"text": "Change address"
}
]
}'Trimite mesaje în grupuri și pe canale
Folosește ID-ul unui grup sau al unui canal ca destinatar. Cloud API oficial nu oferă deloc canale.
- ✓ID-urile de grup se termină cu @g.us
- ✓ID-urile de canal se termină cu @newsletter
- ✓Menționează participanți, trimite sondaje și evenimente
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": "120363012345678901@g.us",
"type": "text",
"message": "Weekly update: all orders shipped."
}'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": "120363204759413821@newsletter",
"type": "text",
"message": "New collection is live."
}'Ce trimit companiile prin API
-
Actualizări despre comenzi și livrări
Mesaje de confirmare, expediere și livrare direct din magazinul online sau din ERP.
-
Mementouri și confirmări
Mementouri pentru programări, cu butoane de confirmare și anulare.
-
Răspunsuri de suport
Răspunde din CRM sau lasă echipa să răspundă din inboxul partajat.
Întrebări frecvente despre trimiterea mesajelor
Întreabă echipa de suport orice pe WhatsApp. Timpul mediu de răspuns este sub 24 de ore.
Centru de ajutor →Pot trimite mesaje WhatsApp fără șabloane?
Da. Maytapi trimite mesaje libere de pe propriul tău număr, deci nu există aprobare de șabloane și nici fereastra de 24 de ore.
Pot trimite mesaje în masă?
Poți trimite câte mesaje ai nevoie, fără taxe per mesaj. Pentru a proteja numărul, scrie persoanelor care îți așteaptă mesajele, variază conținutul și păstrează un ritm natural; Safe Mode încălzește numerele noi.
De pe ce număr pleacă mesajele?
De pe propriul tău număr WhatsApp, cel pe care îl asociezi cu un cod QR. Clienții îți văd numele și poza ca de obicei.
Cum știu că un mesaj a fost livrat?
Setezi un webhook și primești evenimentele trimis, livrat și citit pentru fiecare mesaj. Poți verifica și coada și starea telefonului prin API.
Ce limbaje de programare pot folosi?
Cât costă trimiterea?
Nimic per mesaj. Plătești un preț fix per număr conectat: de la $24 pe lună cu facturare anuală sau $29 cu facturare lunară.
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.