Maytapi
Maytapi/Documentație/Ghid PHP
Ghid PHPAproximativ 10 minuteCum trimiți un mesaj WhatsApp cu PHP
Trimiteți mesaje text și media din PHP cu o singură cerere HTTP, apoi primiți răspunsurile pe propriul webhook. REST și JSON simplu — fără SDK, fără aprobare de șabloane.
Ultima actualizare:
- PHP
- REST + JSON
- fără SDK
- răspunsuri prin webhook
<?php
$pid = "your-pid";
$phoneId = "your-phone-id";
$token = "your-token";
$ch = curl_init("https://api.maytapi.com/api/$pid/$phoneId/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" => "Hello from PHP!",
]),
]);
echo curl_exec($ch);De ce aveți nevoie
Patru lucruri, toate disponibile în consolă în câteva minute.
-
cont
Un cont Maytapi
Înregistrați-vă și porniți perioada de probă gratuită — fără card.
-
telefon
Un număr asociat
Scanați codul QR cu WhatsApp de pe telefon. Numărul funcționează în continuare ca de obicei.
-
token
pid și token
Copiați-le din pagina de token a consolei; phone_id apare lângă numărul dumneavoastră.
-
PHP
Un mediu PHP
Este suficientă o versiune recentă de PHP cu clientul HTTP standard.
Trimiteți un mesaj text cu PHP
Trimiteți prin POST un corp JSON la /sendMessage, cu tokenul în antetul x-maytapi-key. Mesajul intră în coada telefonului, iar răspunsul vine imediat.
- ✓to_number în format internațional, de ex. 4072xxxxx67
- ✓type: text și textul mesajului
- ✓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 PHP!"}'{
"success": true,
"data": {
"chatId": "4072xxxxx67@c.us",
"msgId": "3EB065B353B9493D00C9"
}
}Trimiteți o imagine, un video sau un document
Folosiți același endpoint cu type media și un URL public sau un data URI base64. Adăugați opțional o descriere și un nume de fișier.
- ✓Imagini, video, audio, PDF și alte documente
- ✓Descrierea în câmpul text
- ✓Data URI base64 funcționează la fel ca URL-urile
$ch = curl_init("https://api.maytapi.com/api/$pid/$phoneId/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" => "media",
"message" => "https://example.com/invoice-10482.pdf",
"text" => "Your invoice for order #10482",
"filename" => "invoice-10482.pdf",
]),
]);
echo curl_exec($ch);Primiți răspunsuri cu un webhook PHP
Înregistrați o singură dată URL-ul webhook. Mesajele primite și confirmările de livrare și citire sosesc în JSON; răspundeți prin URL-ul reply din fiecare eveniment.
- ✓Returnați rapid 200, apoi procesați evenimentul
- ✓Ignorați propriile mesaje cu fromMe
- ✓Folosiți event.reply pentru a răspunde în același chat
$ch = curl_init("https://api.maytapi.com/api/$pid/setWebhook");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["x-maytapi-key: $token", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode(["webhook" => "https://example.com/maytapi/webhook"]),
]);
echo curl_exec($ch);<?php
// webhook.php
$event = json_decode(file_get_contents("php://input"), true);
http_response_code(200);
if (($event["type"] ?? "") === "message" && !$event["message"]["fromMe"]) {
$ch = curl_init($event["reply"]);
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" => $event["conversation"],
"type" => "text",
"message" => "Thanks! We received your message.",
]),
]);
curl_exec($ch);
}Întrebări WhatsApp API cu PHP
Întreabă echipa de suport orice pe WhatsApp. Timpul mediu de răspuns este sub 24 de ore.
Centru de ajutor →Există un SDK oficial pentru PHP?
Nu este nevoie. API-ul este REST cu JSON, deci clientul HTTP standard din PHP este suficient, așa cum arată exemplele de pe această pagină.
Pot trimite mesaje în grupuri din PHP?
Da. Folosiți id-ul grupului (se termină în @g.us) ca to_number; endpoint-urile pentru grupuri sunt disponibile în toate planurile.
De ce nu a ajuns mesajul meu?
Verificați că starea telefonului este activă, apoi coada și jurnalele din consolă. Numerele noi trebuie încălzite înainte de trimiteri în volum.
Alte funcționalități WhatsApp API
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.