دریافت خودکار رویدادهای های چت با وب‌هوک
۲۶ مهر ۱۴۰۵ ۳ دقیقه مطالعه
وب‌هوک یعنی های چت خودش به سرور شما خبر بدهد. مثلا هر وقت گفتگوی تازه‌ای شروع شد، در CRM یک تیکت باز شود یا پیام فرم آفلاین به گروه فروش برسد.
پیش از شروع
- وب‌هوک در بسته‌های بالاتر فعال است.
- دسترسی مدیریت وب‌هوک‌ها لازم است.
- یک آدرس
httpsروی سرورتان آماده کنید که درخواست POST بگیرد.
ساخت وب‌هوک
- به توسعه‌دهندگان بروید و زبانه وب‌هوک‌ها را باز کنید.
- وب‌هوک تازه را بزنید.
- آدرس (فقط https) را بنویسید.
- رویدادهایی را که می‌خواهید تیک بزنید.
- ثبت را بزنید.
بعد از ثبت، کلید امضا فقط یک بار نمایش داده می‌شود. کپی‌اش کنید و روی سرورتان نگه دارید.
رویدادها
| رویداد | چه وقت فرستاده می‌شود |
|---|---|
| گفتگوی تازه | گفتگوی تازه شروع شد |
| سپردن گفتگو | گفتگو به اپراتوری سپرده شد |
| انتقال گفتگو | گفتگو منتقل شد |
| بسته شدن گفتگو | گفتگو بسته شد |
| پیام تازه (فقط عمومی) | پیام تازه؛ یادداشت‌های مخفی هرگز فرستاده نمی‌شوند |
| امتیاز تازه | مشتری امتیاز داد |
| تغییر مشخصات کاربر | نام، شماره یا ایمیل عوض شد |
| مسدود شدن کاربر | کاربری مسدود شد |
| پیام فرم آفلاین | خارج از ساعت کاری پیامی ثبت شد |
آزمایش و پیگیری
- با دکمه آزمایش کنار هر وب‌هوک یک درخواست نمونه بفرستید. نتیجه، موفق یا ناموفق، همان لحظه نشان داده می‌شود.
- اگر ارسال‌ها خطا بدهند، کنار وب‌هوک تعداد خطاها با رنگ قرمز دیده می‌شود.
- در آخرین ارسال‌ها (۷ روز) هر ارسال با نتیجه و شماره تلاش آمده است. خطاهایی مثل پاسخ در زمان مقرر نرسید، دامنه پیدا نشد یا خطای گواهی امنیتی کمک می‌کنند مشکل را سریع پیدا کنید.
سرور شما باید در کمتر از ۵ ثانیه با کد موفق جواب بدهد.
بررسی امضا
هر درخواست هدر X-HiChat-Signature دارد که زمان و امضا را با هم دارد. حتما امضا را با کلید امضا بررسی کنید و درخواست‌های قدیمی‌تر از ۵ دقیقه را رد کنید تا کسی نتواند درخواست جعلی بفرستد. نمونه کد در بخش بررسی امضا همین صفحه پنل و در راهنمای فنی وب‌هوک آمده است.
برای خواندن یا فرستادن پیام از سیستم خودتان، کلید API بسازید.