Maytapi
Maytapi/Documentație/Ghid C#
Ghid C#Aproximativ 10 minuteCum trimiți un mesaj WhatsApp cu C#
Trimiteți mesaje text și media din C# 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:
- C#
- REST + JSON
- fără SDK
- răspunsuri prin webhook
// .NET 6+ (System.Net.Http.Json)
using System.Net.Http.Json;
var pid = "your-pid";
var phoneId = "your-phone-id";
var token = "your-token";
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-maytapi-key", token);
var res = await http.PostAsJsonAsync(
$"https://api.maytapi.com/api/{pid}/{phoneId}/sendMessage",
new { to_number = "4072xxxxx67", type = "text", message = "Hello from C#!" });
Console.WriteLine(await res.Content.ReadAsStringAsync());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ă.
-
C#
Un mediu C#
Este suficientă o versiune recentă de C# cu clientul HTTP standard.
Trimiteți un mesaj text cu C#
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 C#!"}'{
"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
await http.PostAsJsonAsync(
$"https://api.maytapi.com/api/{pid}/{phoneId}/sendMessage",
new
{
to_number = "4072xxxxx67",
type = "media",
message = "https://example.com/invoice-10482.pdf",
text = "Your invoice for order #10482",
filename = "invoice-10482.pdf"
});Primiți răspunsuri cu un webhook C#
Î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
await http.PostAsJsonAsync(
$"https://api.maytapi.com/api/{pid}/setWebhook",
new { webhook = "https://example.com/maytapi/webhook" });var app = WebApplication.CreateBuilder(args).Build();
var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-maytapi-key", token);
app.MapPost("/maytapi/webhook", async (JsonElement evt) =>
{
if (evt.GetProperty("type").GetString() == "message" &&
!evt.GetProperty("message").GetProperty("fromMe").GetBoolean())
{
await http.PostAsJsonAsync(evt.GetProperty("reply").GetString(), new
{
to_number = evt.GetProperty("conversation").GetString(),
type = "text",
message = "Thanks! We received your message."
});
}
return Results.Ok();
});
app.Run();Întrebări WhatsApp API cu C#
Î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 C#?
Nu este nevoie. API-ul este REST cu JSON, deci clientul HTTP standard din C# este suficient, așa cum arată exemplele de pe această pagină.
Pot trimite mesaje în grupuri din C#?
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.