API ← Webhooks ואירועים

Webhooks ואירועים
בזמן אמת

קבל HTTP POST מיידי לכל שיחה נכנסת, שיחה יוצאת ו-SMS — בלי polling, בלי עיכוב.

התחל בחינם

כיצד Webhooks עובדים

1

מגיעה שיחה/SMS

שיחה נכנסת או SMS נכנס למספר שלך.

2

IsraelNumber שולח POST

HTTP POST נשלח מיידית ל-URL שהגדרת.

3

האפליקציה שלך מגיבה

עבד את האירוע — ניתוב, AI agent, לוג וכו'.

סוגי אירועים

סוג אירועמתי מופעל
call_inboundשיחה נכנסת למספר שלך
call_answeredהשיחה נענתה
call_endedהשיחה הסתיימה (כולל משך ומצב)
sms_inboundSMS נכנס התקבל
sms_deliveredSMS יוצא שנשלח אושר כנמסר

מבנה ה-Payload

{
  "event":      "call_inbound",
  "call_id":    "abc123xyz",
  "from":       "+972501234567",
  "to":         "+97234567890",
  "timestamp":  "2025-01-01T12:00:00Z",
  "direction":  "inbound"
}

הגדרת Webhook — קוד

import requests

BASE = "https://newsip.pbxme.com/api"
token = requests.post(f"{BASE}/user/login", json={
    "username": "your_email@example.com",
    "password": "your_password"
}).json()["account_token"]
headers = {"account_token": token}

# הגדרת Webhook לשיחות
requests.post(f"{BASE}/dids/webhook", headers=headers, json={
    "did":         "+97234567890",
    "webhook_url": "https://your-app.com/call-events"
})

# הגדרת Webhook ל-SMS
requests.post(f"{BASE}/sms/webhook", headers=headers, json={
    "did":         "+97234567890",
    "webhook_url": "https://your-app.com/sms-events"
})
print("Webhooks הוגדרו בהצלחה")

שאלות נפוצות

מה הפורמט של ה-Webhook?

HTTP POST עם JSON body. כולל סוג האירוע, מספרי מקור ויעד, ותמיד timestamp.

האם יש retry אם ה-Webhook שלי נכשל?

כן. IsraelNumber מנסה שוב אם ה-endpoint לא מחזיר HTTP 200 תוך timeout.

האם ניתן להשתמש ב-Webhooks לחיבור AI Voice Agent?

בהחלט. זה בדיוק התרחיש העיקרי — ה-AI Agent מקבל call_inbound ומגיב מיידית.

האם ניתן להגדיר Webhook שונה לכל מספר?

כן. כל מספר DID מקבל Webhook URL נפרד.

מוכן לקבל אירועים בזמן אמת?

הגדר Webhook תוך דקות.

התחל בחינם ← חזור ל-API Hub