Webhooks ואירועים בזמן אמת
קבלו callbacks מיידיים של HTTP כאשר שיחות מגיעות או הודעות SMS נוחתות על המספרים הווירטואליים שלכם. בנו אוטומציות, הפעילו סוכני AI, והשתלבו עם כל backend בזמן אמת.
כך פועלים ה-Webhooks של Israelnumber
כאשר מתרחש אירוע במספר הווירטואלי שלכם — שיחה נכנסת מגיעה, שיחה נענית, או SMS מתקבל — Israelnumber שולחת בקשת HTTP POST לכתובת URL שציינתם. השרת שלכם מקבל את מטען האירוע, מעבד אותו, ומגיב עם HTTP 200. ללא polling, ללא עיכוב.
זהו המנגנון שמפעיל אינטגרציות של סוכני קול מבוססי AI: ה-webhook מספק את השיחה לנקודת הקצה של מערכת ה-AI שלכם ברגע שמתקשר מחייג למספר שלכם.
הפניית אירועים
Israelnumber מפעילה את אירועי ה-webhook הבאים. הגדירו את כתובת ה-URL היעד לכל מספר דרך לוח הבקרה או נקודת הקצה DID Forward Setting (/customer/did_management/).
| אירוע | הפעלה | שדות מפתח במטען |
|---|---|---|
| incoming_call | שיחה נכנסת מגיעה למספר הווירטואלי שלכם | did_number, caller_id, timestamp |
| call_answered | השיחה נענית ביעד ההעברה | did_number, caller_id, destination, timestamp |
| call_ended | שיחה במספר זה מסתיימת | did_number, caller_id, duration_sec, timestamp |
| sms_received | SMS נכנס מגיע למספר התומך ב-SMS | from, to, message, timestamp |
דוגמאות מטען ומטפל Webhook
דוגמאות מטען הנשלחות על ידי Israelnumber ומטפל Express.js המעבד גם אירועי שיחה וגם אירועי SMS.
מטען שיחה נכנסת (גוף HTTP POST):
{
"event": "incoming_call",
"did_number": "+447911123456",
"caller_id": "+19175550100",
"timestamp": "2024-11-15T14:32:00Z"
}מטען SMS נכנס (גוף HTTP POST):
{
"event": "sms_received",
"from": "+19175550100",
"to": "+447911123456",
"message": "Hello, is this line active?",
"timestamp": "2024-11-15T14:33:12Z"
}מטפל Webhook ב-Express.js — מטפל גם בשיחות וגם ב-SMS:
// npm install express
const express = require("express");
const app = express();
app.use(express.json());
app.use(express.urlencoded({ extended: true }));
app.post("/israelnumber/webhook", (req, res) => {
const payload = req.body;
switch (payload.event) {
case "incoming_call":
console.log(`Inbound call on ${payload.did_number} from ${payload.caller_id}`);
// → Route to AI agent, trigger IVR, log to CRM, etc.
break;
case "call_ended":
console.log(`Call ended. Duration: ${payload.duration_sec}s`);
// → Update billing records, trigger follow-up automation
break;
case "sms_received":
console.log(`SMS from ${payload.from}: "${payload.message}"`);
// → Forward to support desk, trigger auto-reply, log to CRM
break;
default:
console.log("Unknown event:", payload.event);
}
// Always respond 200 to acknowledge receipt
res.status(200).send("OK");
});
app.listen(3000, () => console.log("Webhook listening on port 3000"));עוד מדריכי API
|
| ||||
|
|
שאלות נפוצות — Webhooks
כיצד מגדירים כתובת URL של webhook עבור המספר שלי?
ניתן להגדיר כתובת URL של webhook דרך לוח הבקרה של Israelnumber בעת הגדרת הגדרות ההעברה של המספר שלכם, או באופן פרוגרמטי באמצעות נקודת הקצה DID Forward Setting (/customer/did_management/) על ידי ציון כתובת ה-URL שלכם כיעד call_type_value. אשרו את הערך המדויק של call_type עבור ניתוב webhook מול מדריך ה-API שלכם או צוות הפיתוח לפני הסתמכות עליו בקוד ייצור.
באיזו שיטת HTTP משתמשת Israelnumber עבור webhooks?
Israelnumber שולחת אירועי webhook כבקשות HTTP POST עם גוף בפורמט JSON או form-encoded המכיל את סוג האירוע והנתונים הרלוונטיים. נקודת הקצה שלכם צריכה להגיב עם HTTP 200 כדי לאשר קבלה.
האם אני יכול להשתמש ב-webhooks כדי לחבר סוכן קול מבוסס AI?
כן. זהו אחד ממקרי השימוש המרכזיים. כאשר שיחה נכנסת מגיעה, ה-webhook מופעל ונקודת הקצה של סוכן ה-AI שלכם מקבלת את פרטי השיחה באופן מיידי. בשילוב עם העברת SIP, זה מאפשר לסוכני AI לענות לשיחות ברגע שהן מגיעות.
התחילו לבנות עם Webhooks כבר היום
קבלו את מפתח ה-API החינמי שלכם והתחילו לקבל אירועי שיחה ו-SMS בזמן אמת.