Рассылки и боты по API WhatsApp от PushOn

Что это такое

Сессионные сообщения — обычные текстовые сообщения WhatsApp, разрешённые только в пределах 24-часового окна после последнего входящего сообщения пользователя (customer care window). Не требуют шаблонов и обычно не тарифицируются как шаблонные.

Примеры запросов

Copycurl -X POST "https://api.pushon365.ru/api/v1/send-session-message" \
  -H "x-api-key: {{YOUR_API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "toPhone": "+79991234567",
    "text": "this is a test message",
    "channelId": "aaaaaaaaaa"
  }'

Copycurl.exe -X POST "https://api.pushon365.ru/api/v1/send-session-message" ^
  -H "x-api-key: {{YOUR_API_KEY}}" ^
  -H "Content-Type: application/json" ^
  --data-raw "{\"toPhone\":\"+79991234567\",\"text\":\"this is a test message\",\"channelId\":\"aaaaaaaaaa\"}"

Copycurl -Method POST "https://api.pushon365.ru/api/v1/send-session-message" `
  -Headers @{ "x-api-key" = "{{YOUR_API_KEY}}"; "Content-Type" = "application/json" } `
  -Body (@{ toPhone = "+79991234567"; text = "this is a test message"; channelId = "aaaaaaaaaa" } | ConvertTo-Json)

Что это такое

Шаблонные сообщения (HSM) — заранее утверждённые WhatsApp Business шаблоны для рассылок и инициирования диалога вне 24-часового окна. Имя и язык шаблона должны совпадать с одобренной версией.

Примеры запросов

Copycurl -X POST "https://api.pushon365.ru/api/v1/send-template-message" \
  -H "x-api-key: {{YOUR_API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "toPhone": "+79991234567",
    "channelId": "aaaaaaaaaa",
    "templateName": "your_template_name",
    "templateLanguage": "ru"
  }'

Copycurl.exe -X POST "https://api.pushon365.ru/api/v1/send-template-message" ^
  -H "x-api-key: {{YOUR_API_KEY}}" ^
  -H "Content-Type: application/json" ^
  --data-raw "{\"toPhone\":\"+79991234567\",\"channelId\":\"aaaaaaaaaa\",\"templateName\":\"your_template_name\",\"templateLanguage\":\"ru\"}"

Copycurl -Method POST "https://api.pushon365.ru/api/v1/send-template-message" `
  -Headers @{ "x-api-key" = "{{YOUR_API_KEY}}"; "Content-Type" = "application/json" } `
  -Body (@{ toPhone = "+79991234567"; channelId = "aaaaaaaaaa"; templateName = "your_template_name"; templateLanguage = "ru" } | ConvertTo-Json)

Назначение

PushOn отправляет HTTP POST на ваш Webhook URL при входящих сообщениях от пользователей, а также при изменении статусов исходящих сообщений (queued, sent, delivered, read, failed).

Быстрый тест вебхука

Copycurl -X POST "https://your-server.example.com/webhook" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "status",
    "timestamp": "2025-09-11T11:59:03.001Z",
    "messageId": "wamid.test",
    "to": "+79991234567",
    "channelId": "aaaaaaaaaa",
    "status": "delivered"
  }'

Обработчик должен вернуть 200 OK и пустое тело (\n допустим). Любой другой ответ считается неуспешным и может привести к повтору.

Мини-серверы (возврат 200 и пустое тело)

Copyimport express from "express";
const app = express();
app.use(express.json());

app.post("/webhook", (req, res) => {
  // 1) Быстро логируем/кладём в очередь
  // console.log(req.body);
  // queue.push(req.body);

  // 2) Немедленно возвращаем 200 с ПУСТЫМ телом
  return res.status(200).end();
});

app.listen(3000, () => console.log("Webhook on :3000"));

Copyfrom flask import Flask, request, Response
app = Flask(__name__)

@app.route("/webhook", methods=["POST"])
def webhook():
    # 1) Быстро логируем/кладём в очередь
    # print(request.json)
    # queue.put(request.json)

    # 2) Возвращаем 200 с ПУСТЫМ телом
    return Response(status=200)

if __name__ == "__main__":
    app.run(port=3000)

Безопасность

• Используйте только HTTPS.
• Рекомендуется верификация источника: секретный заголовок/подпись (если включено) или IP-allowlist.
• Делайте обработку идемпотентной (учёт messageId, защита от повторов).