حوادث خارجی
اشتراک گذاری هر نقطه پایانی HTTPS برای canonical OpsIQ حوادث، با فیلتر در هر مقصد
🪝Webhooks & Automation
هر چیزی را تحریک کنید، در هر جایی
اشتراک گذاری HTTPS URL سوگند به OpsIQ حوادثی که لازم است، هر تحویل HMAC-SHA256 امضا شده، workspace-scoped و ردیابی شده از طریق یک چرخه عمر شش لبه ای است.ساخت قوانین بصری، دریافت رویدادهای نقشه برداری یا تماس با اقدامات اداره شده توسط عمومی API.
رویدادهای استاندارد: 53HMAC-SHA256 در هر تحویلتلاش اولیه + پنج retriesشناسه تحویل پایدار در سراسر retries
امضای منبع
تا زمانی که زمین
زندگی زنده Live
53رویدادهای canonical برای مشترک
HMACامضا شده در هر تحویل
5×برنامه ریزی مجدد پس از تلاش اولیه
محدودهنقاط پایانی و log های قفل شده به یک فضای کاری
روتر Event روتر
حوادث در هر دو راه را انجام می دهد.
یک اتاق کنترل یکپارچه برای سه مسیر متمایز: تحویل های ورودی، دریافت های ورودی تایید شده و قراردادهای عمل صریح.
دریافت های ورودی
تاییدیه امضا JSON زمینه های آن را نقشه برداری و فعالیت پذیرفته شده را به تماس درست متصل کنید.
اقدامات اجباری
پارامترهای Declare، تأیید اعتبار، مجوز و الزامات تایید در هر عمل.
OpsIQ اتوبوسرانی ترافیک امضا شده
یک اتوبوس، سه جهت
خروجی
وب‌هوک‌ها
وب‌هوک‌ها
ورودی
حوادث
حوادث
امضای امضا
اتوبوسرانی
اتوبوسرانی
اقدام عملی
POST
POST
invoice.paidyour-crm.com/hook200stripe.payment_intentجدول زمانی تماسنقشه برداریai.action.approved/api/provisionامضاامضایHMAC BAR256
هر تحویل گیرنده های سرسر را می تواند با یک مقایسه زمان ثابت تأیید کند.
رابطه ی کورشناسه پایدار
X-OpsIQ-Delivery تحویل را در هر تلاش مجدد مشخص کنید.
تاریخچهبازرسی قابل بررسی
وضعیت، شمارش تلاش، اسنیپت پاسخ و زمان بندی مجدد برای هر تحویل ورودی.
قابلیت اطمینان · retries
نقاط پایانی پایین می روند. تحویل ها همچنان تلاش می کنند.
یک تحویل ناموفق از طریق نردبان تعریف شده حرکت می کند (1m → 5m → 30m → 2h → 12hاین امر به هر رویداد یک تلاش اولیه و همچنین پنج بار برنامه ریزی شده می دهد.تاریخ تحویل وضعیت HTTP، اسنیپت پاسخ، شمارش تلاش، زمان دوباره تمرین بعدی و شناسه تحویل پایدار را که گیرنده شما می تواند برای کاهش استفاده کند، نگه می دارد.
تعریف شده پشت: پنج retries برنامه ریزی شده (1m)→5m→30m→ 2h → 12hپس از درخواست اولیه، تحویل مشخص شد شکست خورده است.
راه آهن تحویل Per-endpoint: آخرین تحویل سبز / قرمز در یک نگاه، با کد وضعیت و زمان.
در این باره، یک بار روشن شد: امضای را تأیید کنید، زمان های ثابت را رد کنید و ثابت کنید
X-OpsIQ-Delivery ارزش در گیرنده شما14h36mاز طریق تلاش نهایی
6حداکثر تلاش های کامل
بازگشت1m→5m→30m→ 2h → 12h
رابطه ی کورشناسه تحویل پایدار در سراسر تلاش
امنیت گیرندهچک کردن زمان + تحویل-ID dedupe
اتوماسیون دو طرفه
دریافت حوادث و اجازه دادن به AI با خیال راحت عمل کنید.
نقاط پایانی ورودی و نقاط انتهایی عمل سطوح مختلفی هستند، بنابراین آنها اکنون متفاوت به نظر می رسند: یک نقشه خارج از رویدادها بر روی تماس ها، دیگر اقدامات AI قبل از اینکه backend شما نامیده شود.
حوادث خارجی در جدول زمانی مناسب قرار دارند.
ایجاد یک منحصر به فرد URL و به صورت پنهانی، نقشه را بزنید. JSON پس زمینه ها را رها کنید OpsIQ هر رویداد پذیرفته شده را به تماس تطبیق دهید.
https://opsiq.example/api/v1/inbound.php?t=wh_7c91...
contact_email_path
$.customer.email
event_type_path $.type
idempotency_key_path $.id
AI می تواند بدون فرار از قرارداد، کار را درخواست کند.
پارامترهای تعیین شده، تأیید اعتبار و مجوز؛ نیاز به تایید برای نوشتن پرخطر بالا قبل از اعدام.
billing.issue_creditتبلیغاتتاییداجرای اعدام
کلیدها با اجازه، محدودیت ها و اجازه ها
کلید های کاری را برای ابزارها و شرکا بدون دادن تمام قدرت یکپارچه سازی صادر کنید.
داشبورد BI فقط بخوانید
برنامه شریک محدودیت
ابزار داخلی همه چیز
مسیر کد تمیز باقی می ماند.
برای جریان های کاری پیچیده، REST را صدا کنید API به طور مستقیم با همان مدل دامنه.
POST /api/v1.php
مجوز: Bearer opq_workspace_key
{ "action": "crm.conversions.record" }
مجوز: Bearer opq_workspace_key
{ "action": "crm.conversions.record" }
انزوای سخت
هر نقطه پایانی و کلید، به فضای کاری اش جوش داده شده است.
امنیت سیستم بصری خود را در اینجا دارد: تحویل URLs در برابر SSRF محافظت می شود، کلیدها به یک فضای کاری محدود می شوند و درخواست های متقابل تا قبل از هر گونه داده خوانده شده است.
0توکن های جهانی
403عدم تطابق
تحویل URLs نمی تواند به داخل تبدیل شود.
OpsIQ بلوک های خصوصی، حلقه، اهداف گرد و غبار محلی و ابر در صرفه جویی در زمان و دوباره در زمان ارسال.
your-crm.comاجازه
127.0.0.1بلوک
10.0.0.5بلوک
169.254.169.254بلوک
مرزهای مستاجر بخشی از کلید هستند.
پایان ها، رسید های ورودی، log های تحویل و API کلیدها همه تمبرهای کاری را که آنها را ایجاد کرده اند، حمل می کنند.
فضای کاری A Workspace Aکلید اصلی Feq_a1
نقطه پایانی /hook-a
دامنه_key ws_a
نقطه پایانی /hook-a
دامنه_key ws_a
فضای کاری Bکلید اصلی Feq_b7
نقطه پایانی /hook-b
دامنه_key ws_b
نقطه پایانی /hook-b
دامنه_key ws_b
یک کلید از Workspace A Call Workspace B بازگشتی 403 قبل از دسترسی به داده ها
هر درخواست از همان دروازه عبور می کند.
ثبت نام، محدوده کاری، حالت مجوز، محدودیت نرخ و اختیاری IP اجازه لیست قبل از درخواست به داده های کسب و کار بررسی می شود.
همه چیز در جعبه
یک سطح یکپارچه، کاملاً سیم کشی
حوادث خارجی
Subscribe any HTTPS URL to 53 canonical events, filtered per endpoint and signed with HMAC-SHA256.
نقطه پایانی ورودی
یک منحصر به فرد URL + راز در هر منبع؛ امضا و نقشه بر روی جدول زمانی تماس مناسب.
قراردادهای عملیاتی
پارامترهای تعیین شده، تأیید اعتبار، مجوز ها، سیاست های تایید و رفتار حسابرسی برای عملیات backend.
⚖️جایی که متناسب است
نه یک ابزار چسب که اجاره می کنید. لایه ادغام بومی
Zapier و Make برای به هم چسباندن برنامه‌ها عالی‌اند، اما بیرون از پلتفرم شما قرار دارند، نمی‌توانند اقدامات هوش مصنوعی را کنترل کنند و هر اجرا را جداگانه محاسبه می‌کنند. رویدادها، امضاها و اقدامات OpsIQ بومی هستند و همان داده‌های چت، CRM و تیکت‌های شما را به اشتراک می‌گذارند.
| آنچه شما نیاز دارید | Zapier / Make خام | OpsIQ Webhooks & Actions |
|---|---|---|
| کاتالوگ رویداد مستند | Per-app، متناقض | رویدادهای استاندارد OpsIQ: 53 |
| HMAC-SHA256 تحویل را امضا کرد | Rare / DIY در هر zap | ثبت نام هر تحویل، راز در هر نقطه پایانی |
| فیلترهای رویداد Per-endpoint | یک ماشه در zap | Wildcard یا زیرمجموعه دقیق، در هر URL |
| تاریخچه خودکار - تاریخ | محدود / پرداخت مالیات | تلاش اولیه + پنج تجدید نظر برنامه ریزی شده |
| مدیریت ایمن موارد تکراری | شما آن را می سازید | شناسه تحویل پایدار + زمان بندی امضا شده |
| ورودی به سمت راست | زمین در جریان، نه CRM | نقشه ها برای جدول زمانی تماس |
| اکشن‌های هوش مصنوعی را پیش از اجرا کنترل کنید | هیچ مفهومی | سیاست تایید ریسک-آگاه |
| اعدام حسابرسی | هیچ کس | پارامترهای قرمز شده + نتیجه و مدت زمان ثبت شده |
| محدوده API کلید های + Rate Limits | توکن های حساب در سراسر | All / Read- Only / Limited + CIDR |
| تحویل اسRF-hardened | متغیرها | Private /data IPs مسدود شده، re-resoled |
| پر کردن / کلاه های کاری | بله، شما هر کار را پرداخت می کنید | بومی: هیچ یک از آهنگ های تک آهنگ |
| همان داده‌های چت / CRM / تیکت‌ها | کپی شده بین برنامه ها | یک منبع حقیقت |
لیست کامل
همه چیز در وب‌هوک‌ها و اقدامات.
هر توانایی، گروه بندی★نشانه ای از ایستادگی است.
| ویژگی های بازی | آنچه که انجام می دهد |
|---|---|
| اشتراک رویداد | |
| فهرست رویدادهای خروجی (53) ★ | رویدادهای مختلف در سراسر تجارت، صورتحساب، حمایت، CRM، امنیت و تجزیه و تحلیل. |
| اشتراک رویداد Wildcard (*) | یک نقطه پایانی را به همه چیز با یک واحد *. |
| فیلترهای رویداد Per- Endpoint★ | One One URL صورتحساب، حمایت دیگری دریافت کنید، بنابراین هیچ سر و صدا در گیرنده هایی که به آن نیاز ندارند، وجود ندارد. |
| امنیت و امضای | |
| ثبت نام HMAC-SHA256★ | هر بار که با یک راز هر نقطه امضا شده است از طریق X-OpsIQ-Signature. |
| امضای RAW-Body | نشانه های بایت، نه یک شی دوباره سردار، بنابراین هیچ چیز بین فرستنده و گیرنده حرکت نمی کند. |
| دستورالعمل تأیید با زمان ثابت ★ | hash_equals() هدایت کنندگان نمی توانند راه خود را به یک امضای جعلی برسانند. |
| رازهای ثبت نام در هنگام★ | هر بار یک راز هر نقطه را بازسازی کنید، سپس سرگیجه خود را به روز کنید. |
| X-OpsIQ Signature Header | HMAC در هر تحویل برای تأیید انجام می شود. |
| هدر X-OpsIQ-Timestamp | دوره یونیکس در هر تحویل، بنابراین گیرنده ها می توانند وقایع را رد کنند. |
| حفاظت از SSRF Endpoint★ جدید | بلوک های خصوصی، حلقه و ابر-metadata IPs به عنوان اهداف تحویل، در صرفه جویی و در زمان ارسال. |
| Replay Controls★ | یک شناسه تحویل ثابت و زمان بندی شده یونیکس، ورودی ها را برای رد درخواست های استول و تلاش های تکراری ارائه می دهد. |
| قابلیت اطمینان و retries | |
| شناسایی پایدار★ | X-OpsIQ-Delivery در سراسر retries پایدار باقی می ماند، بنابراین یک گیرنده می تواند یادداشت برداری را انجام دهد. |
| بازگشت ناگهانی Retry Ladder★ | 1m → 5m → 30m → 2h → 12h: پنج تلاش مجدد زمان‌بندی‌شده پس از تلاش اول. |
| تاریخ تحویل★ | وضعیت HTTP، اسنیپت پاسخ، شمارش تلاش و زمان دوباره استراحت بعدی، سبز رنگ / amber / قرمز. |
| نوار تحویل برای هر نقطهٔ پایانی | آخرین تحویل ها با وضعیت در یک نگاه، در نقطه پایانی نشان داده شده است. |
| تحویل داده | |
| X-OpsIQ حتی Header | نوع رویداد را به کار می برد تا گیرنده ها بدون تجزیه بدن بتوانند مسیر را طی کنند. |
| X-OpsIQ کارگردان:Delivery Header | یک شناسه تحویل برای ردیابی و رمزگشایی هر تلاش. |
| تست و اعتبار | |
| تحویل تست قبل از رفتن به زندگی★ | یک بار نمونه را آتش بزنید و دقیق آن را بررسی کنید. JSON پاسخ های امضا و HTTP |
| تست امضا (Dy_run) | پاکت امضا شده را بدون پست ارسال می کنید، بنابراین می توانید ابتدا به صورت محلی تأیید کنید. |
| آزمون ورودی | تأیید یک نقشه برداری ایمیل را استخراج می کند و فعالیت درست را ایجاد می کند. |
| مدیریت پایان | |
| فعال / Inactive Redirect | بدون حذف آن، یک نقطه پایانی را بردارید. |
| عدم رضایت با Pending Cancellation | توقف در انتظار بازگشت در هنگام نگه داشتن logs. |
| وب‌هوک‌های ورودی | |
| نقاط پایانی ورودی★ | یک منحصر به فرد URL به علاوه راز هر منبع برای یک سیستم یا رله که می تواند HMAC را به صورت خام ثبت کند. JSON بدن |
| ثبت نام داخلی★ | تایید X-OpsIQ-Inbound-Signature قبل از هر چیز دیگری اتفاق می افتد. |
| JSONمسیر Mapping★ | ایمیل، نوع رویداد و ارزش از طریق $.path از هر گونه شکل شارژ |
| نام انگلیسی : Call Name جدید | نام تماس را با contact_name_path بنابراین جدول زمانی به صورت تمیز خوانده می شود. |
| فیلد استخراج جدید | نقشه یک ارزش پولی یا عددی با value_path برای امتیازدهی و گزارش |
| قالب های خلاصه★ جدید | خلاصه ای از انسان بسازید summary_path یا ${path} قالب توکن |
| پیش بینی های ورودی★ | یک کلیک Stripe، Calendly و Zapier نقشه برداری از قبل پر شده است. |
| Inbound Idempotency★ | وقتی idempotency_key_path یک شناسه رویداد را حل می کند، دریافت های تکراری بدون ایجاد فعالیت دیگری به موفقیت بازمی گردند. |
| فعالیت های ورودی در Contact Timeline★ | رویدادهای پذیرفته شده تبدیل به فعالیت های مقیاس پذیر و محرک در تماس. |
| ورودی Receipt Log | اشتباه / تکراری / بدون محدودیت با محموله خام برای اشکال زدایی. |
| API کنترل دسترسی | |
| APIکلیدها:3حالت های مجوز★ | همه چیز برای ابزارهای قابل اعتماد، فقط خواندن برای داشبورد یا محدود کردن برای مسدود کردن اقدامات خاص. |
| APIکاهش نرخ کلید★ | تماس با ساعت در هر کلید با یک نوار استفاده زنده. |
| APIکلید کلیدیIPگزینه Allowlist (CIDR)★ | پین یک کلید برای دفتر یا مرکز داده IPs با محدوده CIDR. |
| کاتالوگ اکشن زنده (meta.actions)★ | منوی کامل اکشن را پیدا کنید که یک کلید می تواند تماس بگیرد؛ هیچ کلید لازم برای لیست نیست. |
| فضای کاری – LockedAPIکلیدهای کلیدی★ جدید | هر کلید به ایجاد فضای کاری قفل شده است، بنابراین انزوای چند ده ساله اتوماتیک است. |
| لغو کلید API (فوری) ★ | یک کلید نشتی را باز کنید و تماس های آن بلافاصله شکست می خورند. |
| قوانین اتوماسیون | |
| جریان های کاری با Webhook Step | ارسال یک URL به عنوان یک گام در داخل اتوماسیون چند مرحله ای. |
| Visual Rule Builder★ | شرایط و اقدامات را در نظر بگیرید: وقتی X اتفاق می افتد، Y را انجام دهید، هیچ کدی. |
| پایان عملیات | |
| قراردادها★ | هر عمل پارامترهای، نوع تحویل، تأیید اعتبار و پاسخ را اعلام می کند. |
| اجرای مجوز★ | اقدامات می تواند نیاز به مجوز اپراتور داشته باشد. API تماس ها همچنین دامنه های حداقل ثبت شده خود را اجرا می کنند. |
| تایید ریسک-Aware★ | اقدامات دروازه ای با ریسک بالا و مخرب نیازمند تأیید هستند؛ AI نمی تواند کار مخرب خودکار را انجام دهد. |
| اعدام Log★ | هنگامی که حسابرسی امکان پذیر است، OpsIQ سوابق پارامترهای قرمز، وضعیت، نتیجه، مدت و شواهد استقرار را ثبت می کند. |
| اعتبار سنجی HTTP★ | اقدامات از راه دور می تواند از Bearer استفاده کند. API- کلید، پایه یا HMAC احراز هویت؛ هدایت و اهداف ناامن مسدود شده است. |
| چند دهمگی | |
| Endpoint Range Isolation★ جدید | scope_kind/scope_key جوش هر نقطه پایانی، کلید و خط لوله به فضای کاری آن. |
سؤالات متداول
سوالات Webhook پاسخ داد.
همه تیم ها قبل از سیم کشی از آنها می پرسند OpsIQ به بقیه پشته خود: ثبت نام، retries، inbound و Action.
HMAC-SHA را بر اساس درخواست خام با استفاده از راز مشترک خود تکمیل کنید.
X-OpsIQ-Signature آن خلاصۀ هشتم بدون پیشوند است. با یک بررسی زمان ثابت مانند مقایسه کنید hash_equals()کد نمونه در صفحه توسعه دهندگان و در بخش امضای بالا است.پس از درخواست اولیه،OpsIQبرنامه ریزی تا پنج بار: 1m→5m→30m→ 2h → 12hاگر تلاش شش شکست بخورد، تحویل قطعی است.تاریخ وضعیت خود را حفظ می کند، اسنیپت پاسخ و شمارش تلاش برای تشخیص.
بله، هر نقطه پایانی راز خود را دارد که می توانید در هر زمانی بازسازی کنید: چرخش آن، سپس به وضوح خود را در راز جدید اشاره کنید.
بله، سازنده قانون بصری ("هنگامی که X اتفاق می افتد، Y") بیشتر جریان های کاری را پوشش می دهد، با شرایطی در سطح مشتری، اولویت یا کلمه کلیدی. API برای موارد پیچیده در دسترس هستند.
رویدادهای استاندارد: 53. این‌ها تجارت، صورتحساب، پشتیبانی، CRM، امنیت و تحلیل را پوشش می‌دهند، مانند
order.created, payment.completed, invoice.paid, subscription.renewed, ticket.created, crm.deal.won و analytics.anomaly. هر نقطه پایانی می‌تواند مشترک شود در * یا یک زیرمجموعه دقیق.ایجاد یک نقطه پایانی ورودی برای به دست آوردن یک نقطه منحصر به فرد URL و ثبت نام محرمانه، یک Stripe، Calendly یا پیش فرض عمومی فیلد-mapping را انتخاب کنید، سپس سیستم ارسالی یا HMAC را به صورت خام خود انتقال دهید. JSON. OpsIQ امضا را تأیید می کند، ایمیل تماس را استخراج می کند و فعالیت پذیرفته شده را به آن تماس اضافه می کند.
یک اقدام از راه دور یک قرارداد عملیات صریح برای backend شما است، پارامترهای تأیید، مجوز ها، سیاست تایید و پاسخ را اعلام می کند. اقدامات دروازه ای با ریسک بالا نیاز به تأیید دارد، AI نمی تواند اقدامات مخرب خودکار را انجام دهد و ثبت نام می تواند شواهد قرمز را حفظ کند.
کلید های مسئله برای REST API و یک حالت مجوز را در هر کلید انتخاب کنید: همه چیز, فقط بخوانید, or محدودیت (تأثیر های خاص، از جمله کارت های وحشی مانند
crm.contacts.*اضافه کردن یک محدودیت نرخ در ساعت و اختیاری IP هر کلید به فضای کاری که در آن ایجاد شده قفل شده است.وب سایت خارجی استفاده در تحویل یک بار در شرق را بررسی می کند، امضای بدن خام را رد می کند و قدیمی را رد میکند.
X-OpsIQ-Timestampو سپس ادامه X-OpsIQ-Delivery قبل از نوشتن، اگر این شناسه تحویل قبلاً متعهد بود، پاسخ 2xx را بدون تکرار عملیات بازگردانید.