Maytapi
Maytapi/Документация/Руководство C#
Руководство C#Около 10 минутКак отправить сообщение WhatsApp на C#
Отправляйте текст и медиа из C# одним HTTP-запросом и получайте ответы на свой webhook. Обычный REST и JSON — без SDK и одобрения шаблонов.
Обновлено:
- C#
- REST + JSON
- без SDK
- ответы через 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 = "7916xxxxx67", type = "text", message = "Hello from C#!" });
Console.WriteLine(await res.Content.ReadAsStringAsync());Что понадобится
Четыре вещи — всё доступно в консоли за пару минут.
-
аккаунт
Аккаунт Maytapi
Зарегистрируйтесь и начните бесплатный пробный период — карта не нужна.
-
телефон
Подключённый номер
Отсканируйте QR-код в WhatsApp на телефоне. Номер продолжит работать как обычно.
-
токен
pid и токен
Скопируйте их на странице токена в консоли; phone_id указан рядом с номером.
-
C#
Среда C#
Достаточно актуальной версии C# и стандартного HTTP-клиента.
Отправьте текстовое сообщение на C#
Отправьте POST с JSON-телом на /sendMessage, передав токен в заголовке x-maytapi-key. Сообщение встаёт в очередь телефона, ответ приходит сразу.
- ✓to_number в международном формате, например 7916xxxxx67
- ✓type: text и текст сообщения
- ✓В ответе — id сообщения
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": "7916xxxxx67", "type": "text", "message": "Hello from C#!"}'{
"success": true,
"data": {
"chatId": "7916xxxxx67@c.us",
"msgId": "3EB065B353B9493D00C9"
}
}Отправьте изображение, видео или документ
Используйте тот же эндпоинт с type media и публичным URL файла или data URI в base64. Можно добавить подпись и имя файла.
- ✓Изображения, видео, аудио, PDF и другие документы
- ✓Подпись — в поле text
- ✓Data URI в base64 работают так же, как URL
await http.PostAsJsonAsync(
$"https://api.maytapi.com/api/{pid}/{phoneId}/sendMessage",
new
{
to_number = "7916xxxxx67",
type = "media",
message = "https://example.com/invoice-10482.pdf",
text = "Your invoice for order #10482",
filename = "invoice-10482.pdf"
});Получайте ответы через webhook на C#
Зарегистрируйте URL webhook один раз. Входящие сообщения и статусы доставки и прочтения приходят в JSON; отвечайте через reply-URL из каждого события.
- ✓Сразу возвращайте 200, затем обрабатывайте событие
- ✓Пропускайте свои сообщения по fromMe
- ✓Отвечайте в тот же чат через event.reply
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();FAQ: WhatsApp API на C#
Задайте любой вопрос поддержке в WhatsApp. Среднее время ответа — меньше 24 часов.
Центр помощи →Есть ли официальный SDK для C#?
Он не нужен. API — это REST с JSON, поэтому хватает стандартного HTTP-клиента C#, как в примерах на этой странице.
Можно ли писать в группы из C#?
Да. Укажите id группы (оканчивается на @g.us) в to_number; эндпоинты групп доступны на всех тарифах.
Почему сообщение не дошло?
Проверьте, что статус телефона активен, затем посмотрите очередь и логи в консоли. Новые номера нужно прогреть перед массовой отправкой.
Другие возможности WhatsApp API
Получите ключ и отправьте первое сообщение за десять минут
Без одобрения, без шаблонов, без карты. Все эндпоинты открыты на три дня.