ה־API של Phone Agent מאפשר לשלוח הודעות SMS מכל אתר, אפליקציה או מערכת עסקית באמצעות מספר שורות קוד בלבד. העמוד כולל דוגמאות מוכנות ל־curl, Python ו־Node.js, לצד דוגמאות לשילוב בשרתים, אוטומציות ו־AI Agents.
כדי להשתמש ב־API יש ליצור API Key מתוך האזור האישי. יש להעביר את המפתח בכל בקשה באמצעות כותרת Authorization.
כך נראית כותרת האימות בכל בקשה:
Authorization: Bearer YOUR_API_KEY
Phone Agent תומך בשני מסלולי שליחה.
מתאים כאשר רוצים להשתמש במספר הטלפון ובחבילת הסלולר הקיימים.
מתאים לשליחה למספרים בארצות הברית ובקנדה (+1), ללא צורך בטלפון מחובר.
שליחת הודעות דרך הטלפון המחובר שלכם. זהו המסלול הפשוט ביותר אם אתם רוצים לעבוד עם המספר שכבר יש לכם.
POST /v1/sms
Authorization: Bearer YOUR_API_KEY
{ "to": "+972500000000", "text": "שלום" }
curl -X POST "https://api.phoneagent.co.il/v1/sms" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+972500000000",
"text": "שלום, ההזמנה שלך אושרה."
}'import requests
url = "https://api.phoneagent.co.il/v1/sms"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
}
payload = {
"to": "+972500000000",
"text": "שלום, ההזמנה שלך אושרה.",
}
response = requests.post(url, headers=headers, json=payload, timeout=10)
response.raise_for_status()
print(response.json())const response = await fetch("https://api.phoneagent.co.il/v1/sms", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
to: "+972500000000",
text: "שלום, ההזמנה שלך אושרה.",
}),
});
console.log(await response.json());{
"id": "msg_8f3c12",
"status": "queued",
"to": "+972500000000"
}שליחת הודעות דרך שירות הענן של Phone Agent. מתאים לשליחה למספרים בארצות הברית ובקנדה (+1), ללא צורך בטלפון מחובר.
POST /api/v1/messages
sms_global
https://phoneagent.co.il/api/sender
curl -X POST "https://phoneagent.co.il/api/sender/api/v1/messages" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"channel": "sms_global",
"to": "+14155550123",
"text": "Hello David, your appointment is confirmed."
}'import requests
url = "https://phoneagent.co.il/api/sender/api/v1/messages"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
}
payload = {
"channel": "sms_global",
"to": "+14155550123",
"text": "Hello David, your appointment is confirmed.",
}
response = requests.post(url, headers=headers, json=payload, timeout=10)
response.raise_for_status()
print(response.json())const response = await fetch("https://phoneagent.co.il/api/sender/api/v1/messages", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
channel: "sms_global",
to: "+14155550123",
text: "Hello David, your appointment is confirmed.",
}),
});
console.log(await response.json());ניתן להשתמש באותו API מתוך backend, webhooks, cron jobs, Docker, Kubernetes, AI Agents, מערכות CRM ומערכות ERP.
ה־Agent יכול לבחור את ערוץ השליחה המתאים, לבצע בדיקות עסקיות לפני השליחה ולשלב יכולות נוספות של Phone Agent, כגון אנשי קשר, היסטוריית הודעות וניהול ערוצים.
לאחר שליחת ההודעה הראשונה תוכלו לשלב יכולות נוספות.