توسعه‌دهندگان

وب‌هوک‌ها

هر اعلانی که حساب کاربری شما تولید می‌کند، می‌تواند به‌صورت یک JSON POST امضا شده مستقیماً به سیستم‌های خود شما ارسال شود — بنابراین اتفاقاتی که روی هاستینگ شما رخ می‌دهد می‌تواند جریانی کاری را در هر جای دیگری آغاز کند.

چیزهایی که می‌توانید آن را به آن‌ها متصل کنید

یک وب‌هوک یک درخواست معمولی HTTPS است، بنابراین هر ابزاری که بتواند آن را دریافت کند، می‌تواند بر اساس آن عمل کند. نیازی نیست که ما برای ابزار شما یکپارچه‌سازی بسازیم.

پلتفرم‌های اتوماسیون

یک وب‌هوک را به یک گردش‌کار در n8n, Make, Zapier, Pipedream, Activepieces متصل کنید تا هر رویداد به یک محرک تبدیل شود — ارسال به یک کانال، باز کردن یک تیکت، به‌روزرسانی یک صفحه گسترده، یا فراخوانی یک API دیگر. پلتفرم‌های خودمیزبان دقیقاً به همین صورت کار می‌کنند، مشروط بر اینکه نقطه پایانی از طریق HTTPS قابل دسترسی باشد.

سی‌آر‌ام‌ها و میزهای راهنما

رویدادهای صورت‌حساب و حساب کاربری را به HubSpot, Pipedrive, Salesforce، یا به هر میز کمک (helpdesk) یا CRM دارای وب‌هوک ورودی ارسال کنید تا سابقه مشتری وضعیت میزبانی‌اش را بدون نیاز به کپی‌برداری دستی بازتاب دهد.

هر چیز دیگری که گوش می‌دهد

Slack, Discord, Google Sheets, Airtable, Notion، مانیتورینگ خودتان، یک انبار داده، یا یک اسکریپت کوچک که نوشته‌اید. اگر بتواند یک درخواست HTTPS POST را بپذیرد و JSON را بخواند، می‌تواند این موارد را دریافت کند.

آنچه ارسال می‌شود

شما انتخاب می‌کنید که هر دسته‌بندی به کدام مقصد ارسال شود — و حتی می‌توانید چند مقصد را متصل کنید، به‌طوری‌که صورت‌حساب‌ها به یک جا و هشدار0های سایت به جای دیگری بروند. همه چیز به‌طور پیش‌فرض فعال است.

صورت‌حساب‌ها و پرداخت‌ها

فاکتورهای صادرشده و پرداخت‌شده، پرداخت‌های ناموفق، کارت‌هایی که تاریخ انقضای آن‌ها نزدیک است، تمدیدها و لغو اشتراک‌ها.

سایت‌ها و امنیت

راه‌اندازی به اتمام رسید، یک وب‌سایت معلق شد، بدافزار پیدا شد، پشتیبان‌گیری‌ها و تغییرات گواهی.

پشتیبانی و دامنه‌ها

تیکت‌های باز و ارجاع‌شده، انتقال دامنه‌ها، تمدیدها و تغییرات DNS.

اثبات اینکه یک درخواست از طرف ما آمده است

هر درخواست با رازی امضا می‌شود که فقط شما و ما از آن مطلع هستیم. پیش از اقدام بر روی بدنه، امضا را بررسی کنید — این هدرها با هر تحویل ارسال می‌شوند:

X-Zinn-Signature: sha256=<hmac of `timestamp.body`>
X-Zinn-Timestamp: unix seconds
X-Zinn-Delivery: stable id for this delivery
X-Zinn-Event: invoice.paid

مُهر زمانی به‌جای اینکه در کنار بدنه ارسال شود، همراه با آن امضا می‌شود؛ بنابراین، درخواستی که فردی ضبط کرده باشد، نمی‌تواند بعداً علیه شما بازپخش شود. هر چیزی را که قدیمی‌تر از چند دقیقه است رد کنید.

رمز امضای شما فقط یک بار، هنگام افزودن وب‌هوک نمایش داده می‌شود. ما نمی‌توانیم آن را دوباره نمایش دهیم — اگر آن را گم کردید، مقصد را حذف کرده و دوباره اضافه کنید.

در حال راه‌اندازی یکی

  1. در داشبورد خود، بخش «اعلان‌ها» (Notifications) را باز کرده و یک مقصد از نوع وب‌هوک (Webhook) اضافه کنید.
  2. نشانی پایانی HTTPS خود را وارد کنید و کلید امضایی را که به شما نشان می‌دهیم، کپی کنید.
  3. آزمایش را فشار دهید. ما درخواست واقعی را با همان شکل درخواست زنده ارسال می‌کنیم تا بتوانید پیش از وقوع هر اتفاق واقعی، بر اساس آن برنامه‌نویسی کنید.
  4. دسته‌بندی‌هایی را که آن مقصد باید دریافت کند، انتخاب کنید. انواع جدید اعلان‌ به‌صورت خودکار روشن می‌شوند.

شما می‌توانید هر تعداد مقصد که می‌خواهید اضافه کنید، وب‌هوک‌ها را با ایمیل، Slack و Telegram ترکیب کنید و به هر کدام مجموعه متفاوتی از دسته‌ها را اختصاص دهید.

ترجیح می‌دهید با ما تماس بگیرید؟

وب‌هوک‌ها به شما اطلاع می‌دهند که چه زمانی رویدادی رخ داده است. API ابزاری است که با آن می‌توانید رویدادی را رقم بزنید — تمامی عملیاتی که داشبورد انجام می‌دهد برای شما در دسترس است.

مرور مرجع API