گزارشهای مصرف
این اندپوینت فعال است. همه موارد این صفحه قابل فراخوانیاند، بهجز تفکیک اینستاگرام بر اساس نقطه ورود که هنوز پیشانتشار است و ابتدای آن مشخص شده است.
یک اندپوینت، فعالیت همه رباتهای حساب شما را گزارش میکند.
by_role پاسخهای هوش مصنوعی را از پاسخهای انسانی جدا میکند؛ همان چیزی که برای نشاندادن سهم
خودکارسازی از پشتیبانی به مشتریان خودتان لازم دارید.
messages.total و messages.units یک عدد نیستند. رباتی که از مدل با دقت بالاتر استفاده
میکند، به ازای هر پیام دو واحد مصرف میکند؛ پس مشتریای که روی این مدل ۱٬۰۰۰ پیام فرستاده،
total: 1000 و units: 2000 نشان میدهد.
تطبیق صورتحساب را با units انجام دهید. total را بهعنوان تعداد پیام به مشتری نشان دهید.
external_id شناسه شما برای ربات است. تا زمانی که ساخت ربات از طریق API منتشر نشود، مقدار آن
null است؛ پس امروز همه رباتها اینجا null برمیگردانند. تا آن زمان تطبیق را بر اساس robot_id
انجام دهید.
بازه پیشفرض ۳۰ روز گذشته است و نمیتواند بیش از یک سال باشد. درخواست بازهای بزرگتر، from بعد
از to، یا limit بیشتر از 100، خطای 400 برمیگرداند.
این گزارش فعالیت رباتها را نشان میدهد، نه موجودی باقیمانده شما را. به این پرسش پاسخ میدهد که «این مشتری چقدر مصرف کرد؟»، نه «چقدر از حساب باقی مانده است؟». موجودی بسته خارج از محدوده این API است.
metadata.processed_at لحظهای است که ارقام تا آن زمان دقیقاند. مصرف بهصورت دورهای محاسبه
میشود، پس ممکن است گفتگویی که چند ثانیه پیش انجام شده هنوز شمرده نشده باشد.
یک ربات
برای محدودکردن گزارش به یک ربات، robot_id را بفرستید.
صفحهبندی
با limit و offset صفحهبندی کنید. pagination.total_count تعداد رباتهای منطبق با درخواست شما
در همه صفحههاست؛ پس پیش از شروع میدانید چند فراخوانی لازم است.
تفکیک اینستاگرام بر اساس نقطه ورود
پیشانتشار؛ هنوز قابل فراخوانی نیست. این بخش شکل API را تعهد میکند، نه تاریخ آن را. ارسال
breakdown=source در حال حاضر همان پاسخ استاندارد بالا را بدون فیلدهای اضافه برمیگرداند. بقیه
موارد این صفحه فعالاند.
مشتریای که بیشتر حجمش از پاسخ به استوری میآید، محصولی متفاوت از مشتریای دارد که کامنتها آن را
پیش میبرند؛ و یک total واحد این تفاوت را پنهان میکند.
breakdown=source فیلدهایی اضافه میکند و چیزی را جایگزین نمیکند. messages،
conversations و channels_connected همچنان وجود دارند؛ پس یک تجزیهگر هر دو شکل را پوشش میدهد.
همین واژگان source در هر رویداد message هم میآید؛ پس میتوانید بدون فراخوانی دوم، هر رویداد را
به نقطه ورودش نسبت دهید.
پیدا کردن کسریها
اگر تحویل یک وبهوک همه تلاشهای دوباره خود را مصرف کرده باشد، از طریق همین API متوجه میشوید. شمارشهای اینجا را با آنچه برای همان بازه ذخیره کردهاید مقایسه کنید.