אפליקציית ACloud SMS ל־Make

ACloud SMS היא אפליקציית Custom App ב־Make. קישור ההזמנה הישיר שלה עדיין לא הוגדר. בינתיים אפשר להשתמש בשלבי החיבור באמצעות HTTP שבהמשך.

פתיחת Make

חיבור ACloud SMS ל־Make

באמצעות מודול HTTP של Make ניתן לקרוא הודעות נכנסות, לשלוח SMS, לבדוק קרדיטים ולנהל שולחים דרך ה־REST API הציבורי.

אבטחה: יש לשמור את מפתח ה־server בחיבור או במשתנה סודי של Make. אין לחשוף אותו בקוד דפדפן או ב־Webhook ציבורי.

הגדרות החיבור

Base URL	`https://app.aharon.cloud/api/v1`
Authorization	`Bearer YOUR_SERVER_ACCESS_KEY`
Accept	`application/json`
Content-Type	`application/json` בבקשות POST

במודול האוניברסלי של ה־Custom App יש למזג את הכותרות שהמשתמש סיפק עם כותרות ה־Base, כדי שכותרת ה־Authorization תישמר.

{
  "headers": {
    "{{...}}": "{{parameters.headers}}"
  }
}

תרחיש Make מומלץ

צרו תרחיש מתוזמן.
הוסיפו HTTP → Make a request.
קראו הודעות באמצעות after_id שנשמר מהריצה הקודמת.
עבדו כל bundle ושמרו את pagination.next_after_id לריצה הבאה.

הגדרה ידנית של Webhook להודעות נכנסות

ב־Make צרו Custom webhook והעתיקו את כתובת ה־HTTPS הציבורית שלו.
ב־ACloud פתחו מספרים, בחרו את המספר המקבל ופתחו Webhook.
הדביקו את כתובת Make בשדה כתובת Webhook ושמרו.

לא מוצג בורר אירועים. ACloud שולח רק sms.received עבור SMS נכנס. ACloud אינו חושף נקודות API לרישום או למחיקה של Webhook, ולכן טריגר מיידי ב־Make חייב להשתמש ברישום ידני וקובצי attach ו־detach שלו צריכים להישאר ריקים.

{
  "event": "sms.received",
  "message_id": "msg_991",
  "number_id": "num_12",
  "to": "0500000000",
  "from": "Google",
  "from_type": "text",
  "body": "Your code is 123456",
  "received_at": "2026-07-05 13:45:00"
}

השדות provider_received_at, first_seen_at ו־received_at נשלחים בפורמט YYYY-MM-DD HH:mm:ss ללא היסט מספרי ומייצגים את אזור הזמן Asia/Jerusalem. ב־Make יש לפרש אותם באמצעות parseDate(value; "YYYY-MM-DD HH:mm:ss"; "Asia/Jerusalem").

קריאת הודעות חדשות

GET https://app.aharon.cloud/api/v1/messages?after_id={{last_message_id}}&limit=100
Authorization: Bearer YOUR_SERVER_ACCESS_KEY
Accept: application/json

{
  "ok": true,
  "messages": [],
  "pagination": {
    "limit": 100,
    "count": 0,
    "after_id": 1250,
    "next_after_id": 1250,
    "has_more": false
  }
}

מסננים אופציונליים: after_id, virtual_number_id ו־limit. הערך limit יכול להיות בין 1 ל־250 וברירת המחדל היא 100. התוצאות מוחזרות בסדר מזהה עולה.

שליחת SMS

POST https://app.aharon.cloud/api/v1/sms/send
Authorization: Bearer YOUR_SERVER_ACCESS_KEY
Content-Type: application/json

{
  "from": "0500000000",
  "to": "0520000000",
  "message": "Hello from Make"
}

ה־API מקבל גם phones במקום to. ניתן להפריד מספר נמענים בפסיקים, נקודתיים או שורות חדשות.

בדיקת קרדיטים

GET https://app.aharon.cloud/api/v1/sms/credits
Authorization: Bearer YOUR_SERVER_ACCESS_KEY

סימון שולח כספאם או כחסום

POST https://app.aharon.cloud/api/v1/senders/state
Authorization: Bearer YOUR_SERVER_ACCESS_KEY
Content-Type: application/json

{
  "sender": "0520000000",
  "virtual_number_id": 12,
  "state": "blocked"
}

הערך state חייב להיות spam או blocked. אם הוא חסר, ייעשה שימוש ב־spam לשמירת תאימות לאחור.

טיפול בשגיאות

{
  "ok": false,
  "error": "invalid_token",
  "message": "Bad request"
}

ב־Make הפעילו Evaluate all states as errors רק כאשר תשובת HTTP שאינה 2xx צריכה לעצור את התרחיש. אחרת הוסיפו Router לפי סטטוס HTTP והשדה error.

לרפרנס ה־API המלא