ابدأ هنا

طلبك الأول في أربع خطوات

Create at least one workflow in Workflow Studio from the dashboard or mobile app.

Call the list endpoint with your account API key and keep the public workflow_uuid.

Use the state or favorite endpoint to update that exact workflow.

Retrieve its execution logs to follow conditions, actions, errors and credit status.

ONE WORKFLOW, EVERY INTERFACE

Control the same automations everywhere.

الحساب الموسَّع

The API reads and updates the exact workflows used by the dashboard, the SMSMobileAPI mobile app and the asynchronous Workflow Studio worker. A state or favorite change is therefore visible everywhere without copying a definition.

LIST

Discover workflows

Retrieve identifiers, triggers, schedules, conditions, actions and execution counters.

CONTROL

Activate or pause

Build safe operational switches while keeping every workflow definition intact.

FAVORITE

Manage mobile modes

Choose which workflows appear as quick controls on the mobile app home screen.

LOGS

Follow each execution

Inspect decisions, action attempts, errors, completion and credit consumption.

المصادقة

حافظ على أوراق اعتمادك على خادمك

Send your account API key in the apikey parameter or as Authorization: Bearer YOUR_API_KEY. Every workflow lookup is scoped to that authenticated account. Keep the key on your server and never publish it in browser code, repositories, screenshots or public URLs.

قبل أن تدمج

State and favorite changes are immediately shared with the dashboard and SMSMobileAPI mobile app.
Internal MySQL row identifiers are never exposed. Use the public workflow_uuid for every workflow operation.
Pausing a workflow prevents it from matching future events. It does not cancel actions that were already queued.
All dates returned by these endpoints use UTC.

يحصل

List Workflow Studio workflows

نهاية الفقرةhttps://api.smsmobileapi.com/workflow/list/

Returns the workflows owned by the authenticated account, including their state, favorite flag, trigger, schedule, conditions, actions and execution counters.

متى تستخدمه

Use it to build a workflow selector, synchronize another management interface or retrieve identifiers before calling another Workflow Studio endpoint.

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	Your account API key. You may instead use an Authorization: Bearer header.
`page`	ثلاجة	الاختياري	Page number. Default 1.
`per_page`	ثلاجة	الاختياري	Rows per page. Default 25, maximum 100.
`search`	خيط	الاختياري	Search the workflow name, description or UUID.
`event_type`	خيط	الاختياري	Return only workflows using this exact event, for example sms.received.
`active`	boolean	الاختياري	Use 1 or 0 to filter active or paused workflows.
`favorite`	boolean	الاختياري	Use 1 or 0 to filter mobile favorites.
`include_definition`	boolean	الاختياري	Default 1. Set to 0 to omit conditions, actions and schedule details.

مثال

حليقة

curl "https://api.smsmobileapi.com/workflow/list/?apikey=YOUR_API_KEY&active=1&per_page=25"

مثال على الإجابة

JSON

{
  "success": true,
  "data": [
    {
      "workflow_uuid": "wf_0123456789abcdef0123456789abcdef",
      "name": "Reply after a missed call",
      "event_type": "call.missed",
      "active": true,
      "favorite": true,
      "conditions": [],
      "actions": [{"type":"send_sms","config":{"recipient":"{{data.number}}","message":"We will call you back shortly."}}],
      "run_count": 18,
      "success_count": 18,
      "failed_count": 0
    }
  ],
  "pagination": {"page":1,"per_page":25,"total":1,"pages":1,"has_more":false},
  "request_id": "wfreq_4d9b7d7b2b8b384b2ad6f237"
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

بريد

Activate or pause a workflow

نهاية الفقرةhttps://api.smsmobileapi.com/workflow/state/

Changes whether one account-owned workflow listens for future events.

متى تستخدمه

Use it to expose a controlled on/off switch in your own application or activate operational modes from another system.

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	Your account API key. You may instead use an Authorization: Bearer header.
`workflow_uuid`	خيط	مطلوب	Public, stable workflow identifier returned by the list endpoint.
`active`	boolean	مطلوب	1 activates the workflow; 0 pauses it.

مثال

حليقة

curl -X POST "https://api.smsmobileapi.com/workflow/state/" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workflow_uuid":"wf_0123456789abcdef0123456789abcdef","active":true}'

مثال على الإجابة

JSON

{
  "success": true,
  "message": "Workflow activated.",
  "workflow": {"workflow_uuid":"wf_0123456789abcdef0123456789abcdef","active":true,"favorite":true},
  "applies_to": "future_events",
  "request_id": "wfreq_250c732826cc1833e28cf1cc"
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

من الجيد معرفة

This operation never changes the workflow definition.
Already queued actions are not cancelled when a workflow is paused.

بريد

Add or remove a mobile favorite

نهاية الفقرةhttps://api.smsmobileapi.com/workflow/favorite/

Controls whether a workflow is displayed among the favorites available from the SMSMobileAPI mobile app home screen.

متى تستخدمه

Use it to create quick-access modes such as Driving, Work, Family or On-call.

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	Your account API key. You may instead use an Authorization: Bearer header.
`workflow_uuid`	خيط	مطلوب	Public, stable workflow identifier returned by the list endpoint.
`favorite`	boolean	مطلوب	1 adds the workflow to favorites; 0 removes it.

مثال

حليقة

curl -X POST "https://api.smsmobileapi.com/workflow/favorite/" \
  -d "apikey=YOUR_API_KEY" \
  -d "workflow_uuid=wf_0123456789abcdef0123456789abcdef" \
  -d "favorite=1"

مثال على الإجابة

JSON

{
  "success": true,
  "message": "Workflow added to mobile favorites.",
  "workflow": {"workflow_uuid":"wf_0123456789abcdef0123456789abcdef","active":true,"favorite":true},
  "request_id": "wfreq_a9175f9b864aab7b998325b7"
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

يحصل

List one workflow’s execution logs

نهاية الفقرةhttps://api.smsmobileapi.com/workflow/logs/

Returns paginated runs for one workflow with the event, status, condition trace, action attempts, errors and billing state.

متى تستخدمه

Use it to display recent activity, diagnose a failed action or confirm that a workflow matched the expected event.

حدود

الاسم	يكتب	الاحتياجات	وصف
`apikey`	خيط	مطلوب	Your account API key. You may instead use an Authorization: Bearer header.
`workflow_uuid`	خيط	مطلوب	Public, stable workflow identifier returned by the list endpoint.
`status`	خيط	الاختياري	Filter by matched, skipped, queued, running, completed, failed, cancelled, credit_required or test.
`page`	ثلاجة	الاختياري	Page number. Default 1.
`per_page`	ثلاجة	الاختياري	Rows per page. Default 25, maximum 100.
`include_details`	boolean	الاختياري	Default 1. Set to 0 to omit input and condition trace details.

مثال

حليقة

curl "https://api.smsmobileapi.com/workflow/logs/?apikey=YOUR_API_KEY&workflow_uuid=wf_0123456789abcdef0123456789abcdef&status=completed&per_page=25"

مثال على الإجابة

JSON

{
  "success": true,
  "workflow": {"workflow_uuid":"wf_0123456789abcdef0123456789abcdef","name":"Reply after a missed call","event_type":"call.missed","active":true},
  "data": [
    {
      "event_uuid": "evt_01J8EXAMPLE9Q4V",
      "event_type": "call.missed",
      "status": "completed",
      "test_mode": false,
      "credit_status": "consumed",
      "created_at": "2026-10-06 08:14:21",
      "finished_at": "2026-10-06 08:14:22",
      "actions": [{"action_index":0,"action_type":"send_sms","status":"completed","attempts":1}]
    }
  ],
  "pagination": {"page":1,"per_page":25,"total":1,"pages":1,"has_more":false},
  "request_id": "wfreq_0a53eab7bef30e5ba52a0f86"
}

هل تريد أن تدير هذا الطلب؟اتصل بمفتاحك في أعلى الصفحة لفتح المُختبر التفاعلي

مفتاح الوصل

من الجيد معرفة

A completed run represents a successfully finalized workflow execution.
The request_id can be included in a support request without revealing the API key.

استكشاف الأخطاء وإصلاحها

السطو والمستودعات الآمنة

اقرأي حالة HTTP وميدان خطأ JSON قبل إعادة التجريب. لا تُعيد التثبت من صحة الطلب أو تُثبت فشله دون تصحيح الطلب أولاً.

HTTP	المدونة	ماذا تفعل؟
400	`missing_apikey`	No apikey parameter or Bearer token was supplied.
401	`invalid_apikey`	The API key is unknown or disabled.
404	`workflow_not_found`	The workflow does not exist or does not belong to the authenticated account.
422	`invalid_parameter`	A state, favorite, identifier, status or filter value is invalid.
423	`confidential_mode_active`	Standard API access is locked while Confidential Mode is active.
503	`service_unavailable`	Workflow Studio storage or account validation is temporarily unavailable.

قاعدة إعادة التأهيلRetry only transient 429 and 5x responses. ابدأ بعد ثانية واحدة ثم تراجع إلى 2 و 4 و 8 ثواني

هل تحتاج إلى مساعدة؟

أحضري سياق الطلب ليس أسرارك

Share the endpoint, timestamp, HTTP status and sanitized response. لا تشمل أبداً مفاتيح API، أو مداخل أو محتوى الرسائل الخاصة.

الاتصال بشركة API

تطبيق الجوال SMSMobileAPI الآمن الذي يربط الهاتف بلوحة تحكم الويب وREST API لعمليات الرسائل القصيرة والمكالمات — اتصال مشفر من الهاتف المحمول إلى النظام الأساسي

تطبيق الهاتف المحمول الرسمي

الجسر الآمن بين هاتفك ولوحة المعلومات وواجهة برمجة التطبيقات.

تمر عمليات الرسائل القصيرة والمكالمات عبر تطبيق SMSMobileAPI الرسمي المثبت على هاتفك المتصل. يقوم التطبيق بإقران الجهاز بحسابك بشكل آمن، ومزامنة الأحداث المصرح بها، وربط شبكة الجوال بلوحة التحكم وواجهة برمجة التطبيقات REST.

1تطبيق الجوالإقران الهاتف وشريحة SIM الخاصة به 2رابط مشفريصادق البيانات ويحميها في العبور 3لوحة التحكم وواجهة برمجة التطبيقاتتتحكم في سير العمل والنشاط

الإصدارات الموقعة الموزعة من خلال قوائم Google Play وApple App Store الرسمية
عناصر التحكم في المراجعة والتوقيع والتوزيع لنظامي Google وApple الأساسيين
إقران آمن للجهاز، ونقل HTTPS، والوصول إلى واجهة برمجة التطبيقات المصادق عليها
فقط الأذونات المطلوبة لميزات الهاتف المحمول التي تقوم بتمكينها

احصل على تطبيق SMSMobileAPI الرسمي على Google Play

تحميل التطبيق الرسمي للزجاجة SMSMobileAPI على جهاز التفريغ App Store

تعتمد الإمكانيات على الأذونات والوصول إلى الخلفية التي يسمح بها Android أو iOS.

Workflow Studio API documentation

طلبك الأول في أربع خطوات

Discover workflows

Activate or pause

Manage mobile modes

Follow each execution

حافظ على أوراق اعتمادك على خادمك

حدود

مثال

مثال على الإجابة

حدود

مثال

مثال على الإجابة

حدود

مثال

مثال على الإجابة

حدود

مثال

مثال على الإجابة

السطو والمستودعات الآمنة

أحضري سياق الطلب ليس أسرارك

الجسر الآمن بين هاتفك ولوحة المعلومات وواجهة برمجة التطبيقات.