اتصال هر سامانهٔ رزرو با Zapier یا Make

پیش از شروع

1. در Rumore، اتصال‌ها را باز کنید و کارت هر سامانهٔ رزرو را پیدا کنید.
2. روشن کردن لینک رزرو را انتخاب کنید، سپس لینک رزرو و کلید محرمانه را کپی کنید. کلید محرمانه فقط یک بار نشان داده می‌شود، پس صفحه را تا ذخیره شدن zap یا سناریو باز نگه دارید.

کلید محرمانه را گم کرده‌اید؟ در همان کارت تعویض کلید محرمانه را انتخاب کنید. کلید قبلی تا ۲۴ ساعت کار می‌کند، پس تا وقتی آن را به‌روز می‌کنید چیزی از دست نمی‌رود.

اگر سامانهٔ رزرو شما فقط وقتی می‌تواند یک zap را شروع کند که رزروی ثبت می‌شود، این هم کار می‌کند. بازدید را با زمان‌هایش بفرستید، و اگر رزرو بعداً لغو شد، آن را دوباره با status برابر cancelled و همان externalId بفرستید.

با Zapier

1. یک zap بسازید که وقتی رزروی در سامانهٔ رزرو شما تمام می‌شود، شروع به کار کند.
2. مرحلهٔ Webhooks by Zapier را اضافه کنید، POST را انتخاب کنید و لینک رزرو را به‌عنوان URL بچسبانید.
3. Payload Type را روی JSON بگذارید و فیلدهای زیر را تطبیق دهید.
4. در بخش Headers، سرآیند Authorization را اضافه کنید با مقدار Bearer، یک فاصله و بعد کلید محرمانهٔ خودتان.

Webhooks by Zapier به یک طرح پولی Zapier نیاز دارد.

با Make

1. سناریوی خود را با تریگر «رزرو تمام‌شده» در سامانهٔ رزروتان شروع کنید.
2. ماژول HTTP به نام Make a request را با روش POST اضافه کنید و لینک رزرو را به‌عنوان URL بچسبانید.
3. یک سرآیند به نام Authorization با مقدار Bearer، یک فاصله و بعد کلید محرمانهٔ خودتان اضافه کنید.
4. نوع بدنه را روی JSON بگذارید و فیلدهای زیر را تطبیق دهید.

فیلدهایی که باید بفرستید

• name: نام مهمان (الزامی)
• email یا phone: دست‌کم یکی از آن‌ها. شماره تلفن را با کد کشور بنویسید، مثل ‎+4512345678‎.
• visitAt: زمان شروع بازدید، همراه با منطقهٔ زمانی، مثل ‎2026-10-05T19:30:00+02:00‎ (الزامی)
• endAt یا durationMinutes: زمان پایان آن. اگر هیچ‌کدام فرستاده نشود، بازدید ۹۰ دقیقه حساب می‌شود.
• externalId: شناسهٔ رزرو در سامانهٔ شما، تا یک رزرو تکراری هرگز دو بار شمرده نشود
• status: یکی از مقادیر completed، no_show یا cancelled. اگر فرستاده نشود، completed در نظر گرفته می‌شود.

یک نمونهٔ آمادهٔ کپی

یک بازدید تمام‌شده این شکلی است، همان‌طور که Rumore انتظار دارد. فیلدهای سامانهٔ رزرو خود را با این نام‌ها تطبیق دهید. فقط name، visitAt و یک ایمیل یا شماره تلفن لازم است.

{
  "name": "Dana Levi",
  "email": "dana@example.com",
  "phone": "+4520123456",
  "visitAt": "2026-10-05T19:30:00+02:00",
  "endAt": "2026-10-05T21:00:00+02:00",
  "externalId": "booking-1042",
  "status": "completed"
}

بررسی لینک از ترمینال

برای بررسی لینک و کلید محرمانه پیش از ساختن هر چیزی، این را در ترمینال بچسبانید و لینک رزرو و کلید محرمانهٔ خودتان را جای کلمات با حروف بزرگ بگذارید. بازدیدِ این نمونه مال چند ماه پیش است، پس Rumore پاسخ too_old می‌دهد و از هیچ‌کس چیزی خواسته نمی‌شود. البته Test Guest در مخاطبان ظاهر می‌شود.

curl -X POST "YOUR_BOOKING_LINK" \
  -H "Authorization: Bearer YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"name":"Test Guest","email":"test@example.com","visitAt":"2026-01-15T12:00:00Z","durationMinutes":60,"externalId":"rumore-test-1"}'

وقتی بازدیدی می‌رسد چه می‌شود

• درخواست ۳ ساعت بعد از پایان بازدید و در ساعت‌های ارسال شما برای مهمان فرستاده می‌شود. اگر در Rumore تأخیر دلخواه خود را تنظیم کرده باشید، همان اعمال می‌شود.
• کسی که گفته با او تماس نگیرید هرگز درخواستی دریافت نمی‌کند، و هیچ‌کس خیلی زود بعد از درخواست قبلی، درخواست تازه‌ای نمی‌گیرد.
• بازدیدی که با وضعیت cancelled یا no_show فرستاده شود نگه داشته می‌شود و از هیچ‌کس چیزی خواسته نمی‌شود. همان externalId را با وضعیت جدید دوباره بفرستید تا درخواستی که هنوز در انتظار است متوقف شود.
• Rumore هرگز فیلدهای رضایت یا بازاریابی را از سامانهٔ رزرو شما نمی‌خواند، پس لازم نیست آن‌ها را بفرستید.

پاسخ Rumore

Zapier و Make این پاسخ را در تاریخچهٔ هر اجرا نشان می‌دهند. اگر بازدیدها نمی‌رسند، اول آن‌جا را ببینید.

• 202 accepted بازدید ثبت شد. اگر شرایط را داشته باشد، ۳ ساعت بعد از پایانش از مهمان نظر خواسته می‌شود.
• 202 duplicate Rumore دقیقاً همین بازدید را از قبل داشت، پس چیزی تغییر نکرد.
• 202 too_old در تاریخچهٔ مهمان ذخیره شد. بازدید بیش از ۷ روز پیش تمام شده، پس از هیچ‌کس چیزی خواسته نمی‌شود.
• 401 کلید محرمانه اشتباه است یا لینک رزرو خاموش است.
• 422 فیلدی جا افتاده یا خوانا نیست. پاسخ نام آن فیلد را می‌گوید.
• 429 بازدیدهای زیادی در زمان کوتاه. یک دقیقه صبر کنید و دوباره بفرستید.