Maytapi
Maytapi/Документация/Руководство Python
Руководство PythonОколо 10 минутКак отправить сообщение WhatsApp на Python
Отправляйте текст и медиа из Python одним HTTP-запросом и получайте ответы на свой webhook. Обычный REST и JSON — без SDK и одобрения шаблонов.
Обновлено:
- Python
- REST + JSON
- без SDK
- ответы через webhook
import requests
PID = "your-pid"
PHONE_ID = "your-phone-id"
TOKEN = "your-token"
res = requests.post(
f"https://api.maytapi.com/api/{PID}/{PHONE_ID}/sendMessage",
headers={"x-maytapi-key": TOKEN},
json={
"to_number": "7916xxxxx67",
"type": "text",
"message": "Hello from Python!",
},
timeout=10,
)
print(res.json())Что понадобится
Четыре вещи — всё доступно в консоли за пару минут.
-
аккаунт
Аккаунт Maytapi
Зарегистрируйтесь и начните бесплатный пробный период — карта не нужна.
-
телефон
Подключённый номер
Отсканируйте QR-код в WhatsApp на телефоне. Номер продолжит работать как обычно.
-
токен
pid и токен
Скопируйте их на странице токена в консоли; phone_id указан рядом с номером.
-
Python
Среда Python
Достаточно актуальной версии Python и стандартного HTTP-клиента.
Отправьте текстовое сообщение на Python
Отправьте 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 Python!"}'{
"success": true,
"data": {
"chatId": "7916xxxxx67@c.us",
"msgId": "3EB065B353B9493D00C9"
}
}Отправьте изображение, видео или документ
Используйте тот же эндпоинт с type media и публичным URL файла или data URI в base64. Можно добавить подпись и имя файла.
- ✓Изображения, видео, аудио, PDF и другие документы
- ✓Подпись — в поле text
- ✓Data URI в base64 работают так же, как URL
res = requests.post(
f"https://api.maytapi.com/api/{PID}/{PHONE_ID}/sendMessage",
headers={"x-maytapi-key": TOKEN},
json={
"to_number": "7916xxxxx67",
"type": "media",
"message": "https://example.com/invoice-10482.pdf",
"text": "Your invoice for order #10482",
"filename": "invoice-10482.pdf",
},
timeout=10,
)Получайте ответы через webhook на Python
Зарегистрируйте URL webhook один раз. Входящие сообщения и статусы доставки и прочтения приходят в JSON; отвечайте через reply-URL из каждого события.
- ✓Сразу возвращайте 200, затем обрабатывайте событие
- ✓Пропускайте свои сообщения по fromMe
- ✓Отвечайте в тот же чат через event.reply
requests.post(
f"https://api.maytapi.com/api/{PID}/setWebhook",
headers={"x-maytapi-key": TOKEN},
json={"webhook": "https://example.com/maytapi/webhook"},
timeout=10,
)from flask import Flask, request
import requests
app = Flask(__name__)
@app.post("/maytapi/webhook")
def webhook():
event = request.get_json()
if event.get("type") == "message" and not event["message"]["fromMe"]:
requests.post(
event["reply"],
headers={"x-maytapi-key": TOKEN},
json={
"to_number": event["conversation"],
"type": "text",
"message": "Thanks! We received your message.",
},
timeout=10,
)
return "", 200FAQ: WhatsApp API на Python
Задайте любой вопрос поддержке в WhatsApp. Среднее время ответа — меньше 24 часов.
Центр помощи →Есть ли официальный SDK для Python?
Он не нужен. API — это REST с JSON, поэтому хватает стандартного HTTP-клиента Python, как в примерах на этой странице.
Можно ли писать в группы из Python?
Да. Укажите id группы (оканчивается на @g.us) в to_number; эндпоинты групп доступны на всех тарифах.
Почему сообщение не дошло?
Проверьте, что статус телефона активен, затем посмотрите очередь и логи в консоли. Новые номера нужно прогреть перед массовой отправкой.
Другие возможности WhatsApp API
Получите ключ и отправьте первое сообщение за десять минут
Без одобрения, без шаблонов, без карты. Все эндпоинты открыты на три дня.