وبهوک منشی پیامکی
اگر در تنظیمات منشی پیامکی، گزینهی وبهوک را فعال و آدرس خود را وارد کنید، هر بار که پیامی برای خط منشی برسد، سامانه آن را به آدرس شما ارسال میکند. نحوهی ساخت منشی و محرکها در منشی و پیامهای دریافتی توضیح داده شده است. این وبهوک آدرس عمومی ندارد؛ شما سروری میسازید که درخواست را دریافت کند.
ویژگیهای درخواست
| مورد | مقدار |
|---|---|
| متد | POST |
| نوع بدنه | application/json |
| نامگذاری فیلدها | camelCase؛ فیلدهای null در بدنه نمیآیند |
| احراز هویت | ندارد (بدون امضا) |
| تلاش مجدد | ندارد؛ در صورت شکست فقط ثبت (log) میشود |
چون درخواست امضا ندارد، آدرس وبهوک را غیرقابلحدس انتخاب کنید (مثلاً شامل یک توکن تصادفی) و ورودی را اعتبارسنجی کنید. پاسخ سرور شما نادیده گرفته میشود، ولی بهتر است سریع 200 برگردانید.
بدنه
| فیلد | نوع | توضیح |
|---|---|---|
toLine | رشته | خط منشی که پیام به آن رسیده است |
handledBy | رشته | آیدی پاسخدهنده |
handlerName | رشته | نام منشی یا پاسخدهنده |
sourceProvider | رشته | نام ارائهدهندهی دریافت پیام |
campaignRef | رشته | شناسهی کمپین مرتبط، اگر وجود داشته باشد |
messages | آرایه | پیامهای دریافتی |
messages[].messageId | رشته | شناسهی پیام |
messages[].messageBody | رشته | متن پیام |
messages[].from | رشته | شمارهی فرستنده |
messages[].sentAtUtc | تاریخ | زمان ارسال توسط فرستنده (UTC) |
messages[].receivedAtUtc | تاریخ | زمان دریافت در سامانه (UTC) |
messages[].repliedAtUtc | تاریخ | زمان پاسخ؛ فقط اگر پاسخی ارسال شده باشد |
نمونهی بدنه
{
"toLine": "YOUR_LINE_NUMBER",
"handledBy": "Secretary",
"handlerName": "منشی فروش",
"sourceProvider": "PROVIDER_NAME",
"campaignRef": null,
"messages": [
{
"messageId": "665f0c2e9b1d4a0012ab34e1",
"messageBody": "اطلاعات بیشتر",
"from": "989120000000",
"sentAtUtc": "2026-11-19T07:30:00.0000000Z",
"receivedAtUtc": "2026-11-19T07:30:02.0000000Z"
}
]
}
نمونهی سرور دریافتکننده
- C#
- Python
- Node.js
- PHP
- Go
- curl (تست محلی)
var app = WebApplication.Create();
app.MapPost("/payava/secretary/YOUR_RANDOM_TOKEN", async (HttpRequest req) =>
{
using var doc = await System.Text.Json.JsonDocument.ParseAsync(req.Body);
foreach (var m in doc.RootElement.GetProperty("messages").EnumerateArray())
{
var from = m.GetProperty("from").GetString();
var body = m.GetProperty("messageBody").GetString();
Console.WriteLine($"{from}: {body}");
}
return Results.Ok();
});
app.Run();
from flask import Flask, request
app = Flask(__name__)
@app.post("/payava/secretary/YOUR_RANDOM_TOKEN")
def secretary():
payload = request.get_json(force=True)
for m in payload.get("messages", []):
print(m["from"], m["messageBody"])
return "", 200
import express from "express";
const app = express();
app.use(express.json());
app.post("/payava/secretary/YOUR_RANDOM_TOKEN", (req, res) => {
for (const m of req.body.messages ?? []) {
console.log(m.from, m.messageBody);
}
res.sendStatus(200);
});
app.listen(3000);
<?php
// آدرس: /payava/secretary.php?token=YOUR_RANDOM_TOKEN
if (($_GET['token'] ?? '') !== 'YOUR_RANDOM_TOKEN') {
http_response_code(403);
exit;
}
$payload = json_decode(file_get_contents('php://input'), true);
foreach (($payload['messages'] ?? []) as $m) {
error_log($m['from'] . ': ' . $m['messageBody']);
}
http_response_code(200);
package main
import (
"encoding/json"
"log"
"net/http"
)
type payload struct {
Messages []struct {
From string `json:"from"`
MessageBody string `json:"messageBody"`
} `json:"messages"`
}
func main() {
http.HandleFunc("/payava/secretary/YOUR_RANDOM_TOKEN", func(w http.ResponseWriter, r *http.Request) {
var p payload
if err := json.NewDecoder(r.Body).Decode(&p); err != nil {
http.Error(w, "bad request", http.StatusBadRequest)
return
}
for _, m := range p.Messages {
log.Println(m.From, m.MessageBody)
}
w.WriteHeader(http.StatusOK)
})
log.Fatal(http.ListenAndServe(":3000", nil))
}
curl -X POST "http://localhost:3000/payava/secretary/YOUR_RANDOM_TOKEN" \
-H "Content-Type: application/json" \
-d '{"toLine":"YOUR_LINE_NUMBER","messages":[{"messageId":"1","messageBody":"سلام","from":"989120000000","sentAtUtc":"2026-11-19T07:30:00Z","receivedAtUtc":"2026-11-19T07:30:02Z"}]}'