Maytapi
Maytapi/Документация/Руководство Node.js
Руководство Node.jsОколо 10 минутКак отправить сообщение WhatsApp на Node.js
Отправляйте текст и медиа из Node.js одним HTTP-запросом и получайте ответы на свой webhook. Обычный REST и JSON — без SDK и одобрения шаблонов.
Обновлено:
- Node.js
- REST + JSON
- без SDK
- ответы через webhook
// Node.js 18+ (built-in fetch)
const PID = "your-pid";
const PHONE_ID = "your-phone-id";
const TOKEN = "your-token";
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: "7916xxxxx67",
type: "text",
message: "Hello from Node.js!"
})
}
);
console.log(await res.json());Что понадобится
Четыре вещи — всё доступно в консоли за пару минут.
-
аккаунт
Аккаунт Maytapi
Зарегистрируйтесь и начните бесплатный пробный период — карта не нужна.
-
телефон
Подключённый номер
Отсканируйте QR-код в WhatsApp на телефоне. Номер продолжит работать как обычно.
-
токен
pid и токен
Скопируйте их на странице токена в консоли; phone_id указан рядом с номером.
-
Node.js
Среда Node.js
Достаточно актуальной версии Node.js и стандартного HTTP-клиента.
Отправьте текстовое сообщение на Node.js
Отправьте 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 Node.js!"}'{
"success": true,
"data": {
"chatId": "7916xxxxx67@c.us",
"msgId": "3EB065B353B9493D00C9"
}
}Отправьте изображение, видео или документ
Используйте тот же эндпоинт с type media и публичным URL файла или data URI в base64. Можно добавить подпись и имя файла.
- ✓Изображения, видео, аудио, PDF и другие документы
- ✓Подпись — в поле text
- ✓Data URI в base64 работают так же, как URL
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: "7916xxxxx67",
type: "media",
message: "https://example.com/invoice-10482.pdf",
text: "Your invoice for order #10482",
filename: "invoice-10482.pdf"
})
});Получайте ответы через webhook на Node.js
Зарегистрируйте URL webhook один раз. Входящие сообщения и статусы доставки и прочтения приходят в JSON; отвечайте через reply-URL из каждого события.
- ✓Сразу возвращайте 200, затем обрабатывайте событие
- ✓Пропускайте свои сообщения по fromMe
- ✓Отвечайте в тот же чат через event.reply
await fetch(`https://api.maytapi.com/api/${PID}/setWebhook`, {
method: "POST",
headers: { "x-maytapi-key": TOKEN, "Content-Type": "application/json" },
body: JSON.stringify({ webhook: "https://example.com/maytapi/webhook" })
});import express from "express";
const app = express();
app.post("/maytapi/webhook", express.json(), async (req, res) => {
res.sendStatus(200); // acknowledge first
const event = req.body;
if (event.type !== "message" || event.message.fromMe) return;
await fetch(event.reply, {
method: "POST",
headers: { "x-maytapi-key": TOKEN, "Content-Type": "application/json" },
body: JSON.stringify({
to_number: event.conversation,
type: "text",
message: "Thanks! We received your message."
})
});
});
app.listen(3000);FAQ: WhatsApp API на Node.js
Задайте любой вопрос поддержке в WhatsApp. Среднее время ответа — меньше 24 часов.
Центр помощи →Есть ли официальный SDK для Node.js?
Он не нужен. API — это REST с JSON, поэтому хватает стандартного HTTP-клиента Node.js, как в примерах на этой странице.
Можно ли писать в группы из Node.js?
Да. Укажите id группы (оканчивается на @g.us) в to_number; эндпоинты групп доступны на всех тарифах.
Почему сообщение не дошло?
Проверьте, что статус телефона активен, затем посмотрите очередь и логи в консоли. Новые номера нужно прогреть перед массовой отправкой.
Другие возможности WhatsApp API
Получите ключ и отправьте первое сообщение за десять минут
Без одобрения, без шаблонов, без карты. Все эндпоинты открыты на три дня.