مفاهیم اصلی

تنها قانون

کانال همیشه متعلق به یک ربات است. اتصال اینستاگرامِ مستقل وجود ندارد. اول ربات را بسازید، سپس کانال را به آن متصل کنید.

create robot  →  attach channel  →  receive events

این قاعده در مدل داده اعمال می‌شود؛ قراردادی نیست که بتوانیم آن را سهل بگیریم. کانال بدون رباتی که مالکش باشد نمی‌تواند وجود داشته باشد.

اشیا

هر ربات از هر نوع کانال حداکثر یکی دارد. یک ربات نمی‌تواند دو صفحه اینستاگرام داشته باشد. برای صفحه دوم یک ربات جداگانه بسازید.

مشتری و کاربر نهایی دو شخص متفاوت‌اند

این دو واژه در سراسر این مستندات به کار می‌روند و هرگز به یک معنا نیستند.

اگر شریک تجاری ما هستید، مشتریان شما کسب‌وکارهای روی پلتفرم شما هستند و کاربران نهایی آن‌ها عموم مردم‌اند. گفتگو همیشه میان یک کاربر نهایی و اپراتورها یا هوش مصنوعی یک مشتری است.

یک ربات برای هر مشتری

اگر به مشتریان زیادی خدمت می‌دهید، برای هر مشتری یک ربات بسازید. همین کار است که گفتگوها، قانون‌های خودکارسازی و داده‌های آموزشی یک مشتری را از مشتری دیگر جدا نگه می‌دارد.

کاربران نهایی به چنین تفکیکی نیاز ندارند: آن‌ها درون گفتگوهای یک ربات شناسایی می‌شوند، و اگر یک شخص به دو مشتری مختلف پیام دهد، دو گفتگوی بی‌ارتباط ایجاد می‌شود.

external_id شناسه خود شماست

هر ربات می‌تواند یک external_id داشته باشد: شناسه مشتری در سیستم خود شما. ما آن را در هر رویداد برمی‌گردانیم، پس هیچ‌وقت به جدول تطبیق میان شناسه‌های ما و شما نیاز ندارید.

{ "name": "Rose Flower Shop", "external_id": "shop_10422" }

external_id برای هر شریک یکتاست، پس شناسه‌های شما با شناسه‌های شریک دیگر تداخل ندارد. استفاده دوباره از یکی از شناسه‌های خودتان 409 برمی‌گرداند.

ظرفیت

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

وقتی ظرفیت تمام شود، 403 capacity_exhausted دریافت می‌کنید. details وضعیت شما را نشان می‌دهد: occupied تعداد کانال‌های فعال شماست، requested تعدادی است که این فراخوانی نیاز دارد، و capacity سقفی است که بسته‌تان اجازه می‌دهد.

{
  "error": {
    "code": "capacity_exhausted",
    "message": "You have reached the maximum number of channels your plan allows.",
    "request_id": "req_8f2Kq9mR",
    "details": { "occupied": 10, "requested": 1, "capacity": 10 }
  }
}

حذف ربات یا کانال ظرفیت را بلافاصله آزاد می‌کند. غیرفعال‌کردن کانال هم ظرفیت را آزاد می‌کند — ظرفیت فقط کانال‌های فعال را می‌شمارد، پس صفحه مشتری‌ای که موقتاً متوقف شده، سابقه، قانون‌ها و تنظیماتش را حفظ می‌کند بی‌آنکه جایی از ظرفیت را اشغال کند. فعال و غیرفعال‌کردن کانال را ببینید.