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_inbound | SMS נכנס התקבל |
| sms_delivered | SMS יוצא שנשלח אושר כנמסר |
מבנה ה-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 נפרד.