ساخت کلید API برای اتصال های چت به CRM و سیستم‌های دیگر
اگر می‌خواهید گفتگوهای های چت را در CRM، سیستم فروش یا نرم‌افزار خودتان داشته باشید، به یک کلید API نیاز دارید. این کلید به برنامه شما اجازه می‌دهد از طرف سایت با های چت کار کند.
پیش از شروع
- API در بسته‌های بالاتر فعال است. اگر بسته‌تان آن را نداشته باشد، بالای صفحه پیام ارتقا می‌بینید.
- برای ساخت کلید دسترسی مدیریت کلیدهای API لازم است.
ساخت کلید
- از منوی پنل به توسعه‌دهندگان بروید و زبانه کلیدهای API را باز کنید.
- کلید تازه را بزنید.
- یک نام بگذارید که بعدا بدانید مال کجاست؛ مثلا «اتصال به CRM».
- اعتبار را انتخاب کنید: یک ماه، سه ماه، یک سال یا بدون انقضا.
- فقط دسترسی‌هایی را تیک بزنید که برنامه واقعا لازم دارد.
- در آی‌پی‌های مجاز (اجباری) آی‌پی سروری را بنویسید که درخواست‌ها از آن فرستاده می‌شود. محدوده هم قبول است، مثل
203.0.113.0/24. اگر پنل را از همان سیستم باز کرده‌اید، استفاده از آی‌پی من آی‌پی فعلی شما را اضافه می‌کند. - ادامه را بزنید، رمز عبور حسابتان را وارد کنید و ساخت کلید را بزنید. اگر تایید دو مرحله‌ای را روشن کرده باشید، کد برنامه احراز هویت را هم باید وارد کنید.
همان لحظه کلید را کپی کنید و جای امنی نگه دارید.
اگر بعدا کلید را لازم داشتید، کنار همان کلید در فهرست نمایش کلید را بزنید و رمز عبور حسابتان را وارد کنید (و اگر تایید دو مرحله‌ای روشن است، کد آن را). فقط مالک وبسایت و کسی که کلید را ساخته می‌تواند آن را دوباره ببیند؛ پنجره بعد از دو دقیقه خودش بسته می‌شود و هر بار نمایش در گزارش فعالیت‌ها ثبت می‌شود. کلیدهایی که پیش از اضافه شدن این امکان ساخته شده‌اند قابل نمایش نیستند؛ برای آن‌ها یک کلید تازه بسازید. در همان پنجره یک نمونه درخواست با کلید کامل هم می‌بینید.
دسترسی‌ها
| دسترسی | کاربرد |
|---|---|
| خواندن گفتگوها / مدیریت گفتگوها | دیدن گفتگوها؛ بستن، سپردن و برچسب زدن |
| خواندن پیام‌ها / ارسال پیام | خواندن و فرستادن پیام از طرف سیستم شما |
| خواندن کاربران / ویرایش و مسدود کردن کاربران | اطلاعات مشتری‌ها |
| دیدن اپراتورها و دپارتمان‌ها | فهرست تیم |
| خواندن و مدیریت پاسخ‌های آماده | پاسخ‌های آماده |
| آمار | گزارش‌ها |
| مدیریت وب‌هوک‌ها و فرمان به ویجت | کارهای پیشرفته |
مدیریت کلیدها
در فهرست کلیدها برای هر کدام آخرین زمان استفاده، آخرین آی‌پی و تاریخ انقضا آمده است. با دکمه آی‌پی‌ها می‌توانید فهرست آی‌پی‌های مجاز هر کلید را عوض کنید. کلیدهای قدیمی که بدون آی‌پی ساخته شده‌اند برچسب بدون محدودیت آی‌پی دارند؛ برای امنیت بیشتر برایشان آی‌پی مجاز بگذارید. اگر کلیدی لو رفت یا دیگر لازم نیست، باطل کردن را بزنید. برنامه‌هایی که از آن استفاده می‌کنند بلافاصله قطع می‌شوند.
استفاده از کلید
کلید را در هدر Authorization هر درخواست بفرستید. نمونه درخواست در همین صفحه پنل هست و همه آدرس‌ها در راهنمای API آمده است.
اگر می‌خواهید هوش مصنوعی مثل Claude یا ChatGPT را به پشتیبانی وصل کنید، به جای کلید API از کلید MCP استفاده کنید.
اگر می‌خواهید به جای پرسیدن مداوم، هر اتفاق تازه خودش به سرورتان خبر داده شود، از وب‌هوک استفاده کنید.