WhatsApp webhook API：任何状态变化，一手掌握。

curl -X POST "https://live-mt-server.wati.io/api/ext/v3/messageTemplates/send" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "template_name": "order_update",
    "broadcast_name": "order_update_api",
    "recipients": [
      {
        "phone_number": "14155552671",
        "custom_params": [
          { "name": "name", "value": "Maya" },
          { "name": "order_id", "value": "10482" }
        ]
      }
    ]
  }'

const res = await fetch("https://live-mt-server.wati.io/api/ext/v3/messageTemplates/send", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.WATI_API_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    template_name: "order_update",
    broadcast_name: "order_update_api",
    recipients: [
      {
        phone_number: "14155552671",
        custom_params: [
          { name: "name", value: "Maya" },
          { name: "order_id", value: "10482" },
        ],
      },
    ],
  }),
});

console.log(await res.json());

import os
import requestsresp = requests.post(
    "https://live-mt-server.wati.io/api/ext/v3/messageTemplates/send",
    headers={"Authorization": f"Bearer {os.environ['WATI_API_TOKEN']}"},
    json={
        "template_name": "order_update",
        "broadcast_name": "order_update_api",
        "recipients": [
            {
                "phone_number": "14155552671",
                "custom_params": [
                    {"name": "name", "value": "Maya"},
                    {"name": "order_id", "value": "10482"},
                ],
            }
        ],
    },
    timeout=30,
)
print(resp.json())

{
  "success": true,
  "broadcast_id": "broadcast_123456",
  "recipients": [
    {
      "local_message_id": "local-msg-123",
      "phone_number": "14155552671",
      "errors": []
    }
  ]
}

curl -X POST "https://live-mt-server.wati.io/api/ext/v3/conversations/messages/text" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "14155552671",
    "text": "Your order 10482 is out for delivery. Reply here to change the address."
  }'

const res = await fetch("https://live-mt-server.wati.io/api/ext/v3/conversations/messages/text", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.WATI_API_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    target: "14155552671",
    text: "Your order 10482 is out for delivery. Reply here to change the address.",
  }),
});

console.log(await res.json());

import os
import requests

resp = requests.post(
    "https://live-mt-server.wati.io/api/ext/v3/conversations/messages/text",
    headers={"Authorization": f"Bearer {os.environ['WATI_API_TOKEN']}"},
    json={
        "target": "14155552671",
        "text": "Your order 10482 is out for delivery. Reply here to change the address.",
    },
    timeout=30,
)
print(resp.json())

{
  "message": {
    "id": "507f1f77bcf86cd799439011",
    "type": "text",
    "text": "Your order 10482 is out for delivery. Reply here to change the address.",
    "owner": true,
    "local_message_id": "88aed3c93a050b3c53978463",
    "conversation_id": "685bd235e6119686e693a093",
    "created": "2026-07-14T16:15:38.3992421Z",
    "event_type": "message"
  }
}

# 1. Wati 将每条新消息 POST 到你的 webhook URL（事件：message）。
# 2. 你的代码获取回复并将其发送回去：
curl -X POST "https://live-mt-server.wati.io/api/ext/v3/conversations/messages/text" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "14155552671",
    "text": "Yes, we are open from 9am to 9pm."
  }'

import express from "express";

const app = express();
app.use(express.json());

app.post("/wati", async (req, res) => {
  res.sendStatus(200); // 先响应 Wati；若未收到 200，它会进行重试
  const event = req.body;
  if (event.eventType !== "message" || event.owner) return; // 仅处理客户消息

  const answer = /open|hours/i.test(event.text || "")
    ? "Yes, we are open from 9am to 9pm."
    : "Thanks! A teammate will reply shortly.";

  await fetch("https://live-mt-server.wati.io/api/ext/v3/conversations/messages/text", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.WATI_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ target: event.waId, text: answer }),
  });
});

app.listen(3000);

import os
import re
import requests
from flask import Flask, request

app = Flask(__name__)Fragment 3 of 5. Translate only the text inside this item.
@app.post("https://live-mt-server.wati.io/api/ext/v3/contacts",
    headers={"Authorization": f"Bearer {os.environ['WATI_API_TOKEN']}"},
    json={
        "whatsapp_number": "14155552671",
        "name": "Maya",
        "custom_params": [
            {"name": "city", "value": "Singapore"},
            {"name": "customer_tier", "value": "vip"},
        ],
    },
    timeout=30,
)
print(resp.json())

{
  "id": "507f1f77bcf86cd799439011",
  "wa_id": "14155552671",
  "name": "Maya",
  "phone": "+14155552671",
  "opted_in": true,
  "custom_params": [
    { "name": "city", "value": "Singapore" },
    { "name": "customer_tier", "value": "vip" }
  ],
  "channel_type": "whatsapp"
}

curl -X POST "https://live-mt-server.wati.io/api/ext/v3/comments/$COMMENT_ID/privateReply" \
  -H "Authorization: Bearer $WATI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "yourbrand",
    "userId": "17841400000000000",
    "userName": "maya",
    "type": "text",
    "text": "Hi Maya, yes we do. Chat with us on WhatsApp for shipping options."
  }'

const commentId = "17900000000000000"; // 来自 GET /posts/{post_id}/comments

const res = await fetch(`https://live-mt-server.wati.io/api/ext/v3/comments/${commentId}/privateReply`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.WATI_API_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    channel: "yourbrand",
    userId: "17841400000000000",
    userName: "maya",
    type: "text",
    text: "Hi Maya, yes we do. Chat with us on WhatsApp for shipping options.",
  }),
});

console.log(await res.json());

import os
import requests

comment_id = "17900000000000000"  # 来自 GET /posts/{post_id}/commentsresp = requests.post(
    f"https://live-mt-server.wati.io/api/ext/v3/comments/{comment_id}/privateReply",
    headers={"Authorization": f"Bearer {os.environ['WATI_API_TOKEN']}"},
    json={
        "channel": "yourbrand",
        "userId": "17841400000000000",
        "userName": "maya",
        "type": "text",
        "text": "Hi Maya, yes we do. Chat with us on WhatsApp for shipping options.",
    },
    timeout=30,
)
print(resp.json())

{
  "ok": true,
  "result": "success"
}