מסר גו · מרכז תיעוד API

חיבור והזדהות — ווטסאפ

מערכת הווטסאפ פועלת בכתובת נפרדת. כל קריאה מופנית לכתובת הבסיס עם מזהה ה-Endpoint שלכם בנתיב, והאימות מתבצע באמצעות טוקן ב-query string.

GETשליחת הודעת תבנית (Template)

שליחת הודעה מבוססת תבנית מאושרת לנמען בודד. משתני גוף התבנית נשלחים ב-params[] לפי סדר, ומדיה לכותרת ב-header[][].

curl -G "https://wa.message.co.il/api/360/YOUR_ENDPOINT/send" \
  --data-urlencode "phone=972585050000" \
  --data-urlencode "template=your_template" \
  --data-urlencode "token=YOUR_TOKEN" \
  --data-urlencode "language=he" \
  --data-urlencode "params[0]=Donation" \
  --data-urlencode "params[1]=100" \
  --data-urlencode "header[0][0][link]=https://example.com/image.jpg" \
  --data-urlencode "header[0][1]=image"

const url = 'https://wa.message.co.il/api/360/YOUR_ENDPOINT/send';

const params = new URLSearchParams({
  phone: '972585050000',
  template: 'your_template',
  token: 'YOUR_TOKEN',
  language: 'he',
  'params[0]': 'Donation',
  'params[1]': '100',
  'header[0][0][link]': 'https://example.com/image.jpg',
  'header[0][1]': 'image'
});

fetch(`${url}?${params.toString()}`)
  .then(res => res.json())
  .then(data => console.log('Response:', data))
  .catch(err => console.error('Error:', err));

import requests

url = "https://wa.message.co.il/api/360/YOUR_ENDPOINT/send"

payload = {
    "phone": "972585050000",
    "template": "your_template",
    "token": "YOUR_TOKEN",
    "language": "he",
    "params[0]": "Donation",
    "params[1]": "100",
    "header[0][0][link]": "https://example.com/image.jpg",
    "header[0][1]": "image",
}

print(requests.get(url, params=payload).json())

{
  "messaging_product": "whatsapp",
  "contacts": [
    { "input": "972585050000", "wa_id": "972585050000" }
  ],
  "messages": [
    { "id": "wamid.XXXX==", "message_status": "accepted" }
  ]
}

Unauthorized

{
  "error": {
    "message": "(#132000) Number of parameters does not match the expected number of params",
    "code": 132000,
    "type": "OAuthException",
    "error_data": {
      "messaging_product": "whatsapp",
      "details": "body: number of localizable_params (1) does not match the expected number of params (0)"
    },
    "fbtrace_id": "..."
  }
}

תגובההזרקת פרמטרים לבוט

כאשר הבוט פונה ל-endpoint שלכם (Webhook שמוגדר בצומת בבוט), השרת שלכם מחזיר JSON עם רשימת actions המבוצעות לפי הסדר — בעיקר הזרקת פרמטרים חזרה לבוט (טקסטים וקישורי מדיה), ובסוף Return שממשיך את זרימת הבוט.

{
  "actions": [
    { "type": "SetParameter", "name": "content1", "value": "טקסט ההודעה הראשונה" },
    { "type": "SetParameter", "name": "media1",   "value": "https://example.com/image1.jpg" },
    { "type": "SetParameter", "name": "content2", "value": "טקסט ההודעה השנייה" },
    { "type": "SetParameter", "name": "media2",   "value": "https://example.com/image2.jpg" },
    { "type": "Return", "value": 1 }
  ]
}