به محتوای اصلی

ساخت چت بات هوش مصنوعی برای سایت و اپ؛ از جواب تا انجام کار

چت بات هوش مصنوعی بسازید که از دانسته‌ها و جدول‌های شما جواب بدهد، با تأیید کاربر سفارش ثبت و لغو کند و روی سایت، بله و اپ بنشیند؛ از ساعتی ۵۰ تومان.

عاطفه امیری۱۰ دقیقه مطالعهبه‌روزرسانی
در این مطلب

ساخت چت بات هوش مصنوعی برای سایت و اپلیکیشن در فیکارو چند دقیقه کار است، نه یک پروژه‌ی چندماهه. به فارسی می‌نویسید چت بات چه کند، قوانین و فهرست قیمتتان را از یک PDF یا لینک سایت به آن می‌دهید، جدول‌های پروژه‌تان را وصل می‌کنید و اگر بخواهید، کارهایی مثل لغو سفارش یا گرفتن شماره‌ی تماس را هم به آن می‌سپارید، با تأیید خود مشتری. بعد همان چت بات را با یک خط کد روی سایت می‌گذارید، بی‌کدنویسی به بازوی بله وصل می‌کنید یا از اپ و سرور خودتان با API صدا می‌زنید. در فیکارو به آن ایجنت می‌گوییم. هزینه‌اش تومانی است و از ساعتی ۵۰ تومان شروع می‌شود.

چت بات هوش مصنوعی فیکارو چه کارهایی می‌کند؟

  • جواب می‌دهد، فقط از روی دستورالعمل، دانسته‌ها و جدول‌هایی که خودتان داده‌اید، و می‌گوید جواب از کدام دانسته آمده.
  • کار انجام می‌دهد. از راه تابع‌های شما رکورد می‌سازد، ویرایش یا حذف می‌کند، و اگر بخواهید پیش از هر کار از خود کاربر تأیید می‌گیرد.
  • کنار می‌کشد و یاد می‌گیرد. وقتی جواب را ندارد حدس نمی‌زند و کاربر را به تلفن، بله یا ایمیل پشتیبان شما می‌رساند. هر صبح هم سؤال‌های بی‌جواب دیروز را برایتان می‌فرستد.

یک گفت‌وگوی نمونه روی ویجت سایت یک فروشگاه:

مشتری: سفارش ۴۸۲۱ رو لغو کنید، موبایلم ۰۹۱۲۳۴۵۶۷۸۹ هست.

ایجنت: برای انجام این کار تأیید شما لازم است: cancel_order — کد سفارش: ۴۸۲۱، موبایل سفارش‌دهنده: ۰۹۱۲۳۴۵۶۷۸۹ (با دو دکمه‌ی «تأیید» و «لغو»)

مشتری: «تأیید» را می‌زند.

ایجنت: انجام شد. سفارش 4821 لغو شد.

تا مشتری «تأیید» را نزند، هیچ چیزی در دیتابیس عوض نمی‌شود. کد همین تابع را پایین‌تر آورده‌ایم.

سه راه ساخت چت بات برای سایت؛ کدام مال شماست؟

معیارویجت چت آمادهAPI خام مدل + کد خودتانایجنت فیکارو
چیزی که تحویل می‌گیریدپنجره‌ی چت با یک خط اسکریپتدسترسی به مدل؛ بقیه با شماویجت سایت، بازوی بله و API، هر سه از یک ایجنت
دانسته‌هامعمولاً بارگذاری سندخودتان پیاده می‌کنیدمتن، PDF، عکس یا لینک، با بازبینی پیش از ذخیره
داده‌ی زندهمعمولاً نداردخودتان پیاده می‌کنیدجدول‌های پروژه، فقط‌خواندنی
انجام کار (ثبت، ویرایش، حذف)معمولاً نداردخودتان پیاده می‌کنیدبا تابع‌های خودتان، با تأیید کاربر
کد سمت شماهیچزیاد: پرامپت، بازیابی، لاگبرای ویجت و بله هیچ؛ برای API یک درخواست HTTP
پرداختاغلب اشتراک ماهانهبه ازای توکن مصرفیتومانی: ساعتی، به‌علاوه‌ی هزینه‌ی هر جواب

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

ساخت چت بات در فیکارو، قدم‌به‌قدم

ایجنت پروژه لازم ندارد. از تب «هوش مصنوعی (AI)» در نوار بالای پنل شروع می‌کنید:

  1. ایجنت جدید را بزنید و پلن را انتخاب کنید. می‌توانید از صفر شروع کنید یا از یکی از هفت قالب آماده، مثل پاسخ‌گوی FAQ، پشتیبان فروشگاه یا دسته‌بند تیکت.
  2. دستورالعمل را به فارسی بنویسید: لحن، طول جواب، و اینکه چه چیزی را نگوید.
  3. دانسته‌ها را اضافه کنید: پرسش‌وپاسخ، متن آزاد، یا PDF، عکس و صفحه‌ی سایت.
  4. اگر جواب در داده‌ی زنده است، جدولهای پروژه‌تان را وصل کنید.
  5. اگر چت بات باید کاری انجام بدهد، تا ۳ تابع پروژه را وصل کنید.
  6. در صفحه‌ی مدل یکی از مدل‌های پلنتان را انتخاب کنید؛ پلن‌های بالاتر از خانواده‌ی GPT و Gemini انتخاب بیشتری دارند.
  7. در میز آزمایش مثل یک مشتری با آن گفت‌وگو کنید. هزینه‌ی هر جواب زیر همان جواب به تومان نوشته می‌شود.
  8. منتشرش کنید: ویجت سایت، بازوی بله یا API.

چت بات از کجا جواب می‌دهد؟ دانسته‌ها و جدول‌ها

دانسته‌ها حافظه‌ی ثابت چت بات‌اند: ساعت کاری، هزینه‌ی ارسال، شرایط مرجوعی. لازم نیست دوباره تایپشان کنید: PDF و عکس با تشخیص متن خوانده می‌شوند و از لینک صفحه‌ی سایت متن اصلی بیرون کشیده می‌شود. متن پیش از ذخیره در یک جعبه‌ی قابل ویرایش نشانتان داده می‌شود، و هر جواب API در knowledgeIds می‌گوید از کدام دانسته‌ها آمده است.

جدول‌ها داده‌ی زنده‌اند. ایجنتی که به جدول محصول وصل است، به «کفش مشکی سایز ۴۲ زیر ۲ میلیون دارید؟» از روی خود جدول جواب می‌دهد. مدل برای هر پرسش حداکثر دو query فقط‌خواندنی می‌نویسد و جواب فقط از روی ردیف‌های برگشتی ساخته می‌شود. ستون‌های مخفی، ایمیل، تلفن و ستون‌های فقط‌ادمین هرگز به ایجنت داده نمی‌شوند.

چت باتی که ثبت، ویرایش و لغو می‌کند

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

  • اجازه‌ی نوشتن: تابع در دیتابیس پروژه‌ی خودش رکورد می‌سازد، ویرایش یا حذف می‌کند.
  • پیش از انجام از کاربر تأیید بگیر: تابع اجرا نمی‌شود تا کاربر خلاصه‌ی کار را ببیند و تأیید کند.

تابع cancel_order پشت همان گفت‌وگوی بالاست، برای پروژه‌ای با جدول order و ستون‌های code، phone و status. کد را در یک فانکشن تازه بگذارید و فعالش کنید، بعد در صفحه‌ی «توابع» ایجنت وصلش کنید با دو پارامتر: order_code با توضیح «کد سفارش» و phone با توضیح «موبایل سفارش‌دهنده».

const fa = "۰۱۲۳۴۵۶۷۸۹";
function digits(s) {
  return String(s || "")
    .replace(/[۰-۹]/g, (d) => fa.indexOf(d))
    .replace(/\D/g, "");
}

const code = digits(ctx.input.order_code);
const phone = digits(ctx.input.phone).slice(-10);
if (!code || phone.length !== 10) {
  ctx.reject("کد سفارش و موبایل را کامل بنویسید");
}

const order = ctx.db.list("order", {
  filter: { code: code },
  limit: 1,
})[0];

if (!order || digits(order.phone).slice(-10) !== phone) {
  ctx.reject("سفارشی با این کد و موبایل پیدا نشد");
}
if (order.status !== "pending") {
  ctx.reject("این سفارش ارسال شده و دیگر لغو نمی‌شود");
}

ctx.db.update("order", order.id, { status: "cancelled" });
ctx.respond({ message: "سفارش " + code + " لغو شد." });

تابع موبایل را با موبایل خود سفارش می‌سنجد و فقط سفارش ارسال‌نشده را لغو می‌کند. دلیل هر ctx.reject بعد از «انجام نشد:» به کاربر نشان داده می‌شود. وقتی تأیید روشن است، پاسخ API به‌جای اجرای تابع یک pendingAction دارد:

{
  "answered": true,
  "answer": "برای انجام این کار تأیید شما لازم است: cancel_order — کد سفارش: ۴۸۲۱، موبایل سفارش‌دهنده: ۰۹۱۲۳۴۵۶۷۸۹",
  "output": null,
  "sources": [],
  "requestId": "0199d3a2-7c41-7b8e-9f3a-2d6e1c0b4a17",
  "handoff": false,
  "knowledgeIds": [],
  "pendingAction": {
    "fn": "cancel_order",
    "summary": "cancel_order — کد سفارش: ۴۸۲۱، موبایل سفارش‌دهنده: ۰۹۱۲۳۴۵۶۷۸۹",
    "token": "eyJ…",
    "expiresAt": "2026-10-21T10:05:00Z"
  }
}

خلاصه را سرور از آرگومان‌ها می‌سازد، نه مدل، پس متن جاسازی‌شده در پرسش نمی‌تواند کار دیگری را جای این کار جلوه دهد. توکن یک‌بارمصرف است و پنج دقیقه عمر دارد. ویجت و بله کارت تأیید را خودشان نشان می‌دهند؛ در اپ خودتان، بعد از تأیید کاربر توکن را به /confirm بفرستید:

curl -X POST "https://api.fikaro.ir/ai/v1/bots/{botId}/confirm" \
  -H "Authorization: Bearer apck_bot_..." \
  -H "Content-Type: application/json" \
  -d '{"token": "eyJ…"}'

رایج‌ترین کار نوشتنی را هم بی‌کدنویسی ساخته‌ایم: دکمه‌ی ثبت لید در صفحه‌ی «توابع» تابعی آماده می‌سازد که نام و شماره‌ی کسی را که می‌خواهد با او تماس بگیرید در جدولی از پروژه‌تان ثبت می‌کند. تابع فقط در پروژه‌ی خودش می‌نویسد، در هر پرسش حداکثر یک کار نوشتنی انجام می‌شود و هر کانال سقف نوشتن جدا دارد. جزئیات در نوشتن و تأیید آمده است.

چت بات را کجا بگذارم؟ سایت، بله، اپ و بک‌اند

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

ویجت سایت با یک خط کد

در صفحه‌ی «ویجت سایت» دامنه‌تان را به فهرست مجاز اضافه کنید، ظاهر را تنظیم کنید و این خط را پیش از </body> بگذارید:

<script src="https://api.fikaro.ir/ai/widget/v1.js" data-agent="{botId}" data-key="apck_wgt_..." async></script>

وردپرس، سایت‌ساز یا HTML دست‌نویس فرقی نمی‌کند. ویجت فقط روی دامنه‌های مجاز شما ساخته می‌شود و کلید خود ایجنت در صفحه دیده نمی‌شود. گفت‌وگو را بین صفحه‌ها نگه می‌دارد، کارت تأیید و دکمه‌ی «گفت‌وگو با پشتیبان انسانی» را خودش نشان می‌دهد و پیام نامناسب را پیش از رسیدن به مدل جدا می‌کند.

بازوی بله، بدون کد

در بله از @botfather یک بازو بسازید و توکنش را در صفحه‌ی «بازوی بله» ایجنت بگذارید. از آن لحظه ایجنت به پیام‌های متنی بازوی شما جواب می‌دهد و ۶ پیام آخر هر گفت‌وگو را تا ۲۴ ساعت به خاطر می‌سپارد. جزئیات در اتصال به بازوی بله آمده است.

API برای اپ و سرور

کلید apck_bot_ یک راز خرج‌کننده است، پس بهتر است ایجنت را از سرور خودتان صدا بزنید:

const BOT = "https://api.fikaro.ir/ai/v1/bots/{botId}";

async function call(path, payload) {
  const res = await fetch(BOT + path, {
    method: "POST",
    headers: {
      Authorization: "Bearer apck_bot_...",
      "Content-Type": "application/json",
    },
    body: JSON.stringify(payload),
  });
  const body = await res.json();
  if (!res.ok) throw new Error(`${body.code}: ${body.detail}`);
  return body;
}

async function chat(text, history) {
  const r = await call("/ask", { input: text, history });
  if (!r.pendingAction) return r;
  const ok = await askUser(r.pendingAction.summary); // دکمه‌ی تأیید رابط شما
  if (!ok) return null; // توکن خودش باطل می‌شود
  return call("/confirm", { token: r.pendingAction.token });
}

متن جواب در answer است. answered: false یعنی ایجنت جواب را نداشته، و هر جا handoff برابر true است راه تماس با پشتیبان را نشان بدهید. history پیام‌های قبلی همان گفت‌وگوست: آرایه‌ای از {role, text}، قدیمی به جدید، حداکثر ۶ پیام؛ شکل کاملش در گفت‌وگوی چندنوبتی آمده است.

در اپ فلاتر همان پرسش با بسته‌ی http:

import 'dart:convert';
import 'package:http/http.dart' as http;

const botUrl = 'https://api.fikaro.ir/ai/v1/bots/{botId}/ask';

Future<Map<String, dynamic>> ask(String question) async {
  final res = await http.post(
    Uri.parse(botUrl),
    headers: {
      'Authorization': 'Bearer apck_bot_...',
      'Content-Type': 'application/json',
    },
    body: jsonEncode({'input': question}),
  );
  final body = jsonDecode(utf8.decode(res.bodyBytes));
  if (res.statusCode >= 400) {
    throw Exception('${body['code']}: ${body['detail']}');
  }
  return body;
}

utf8.decode را جا نیندازید؛ بدون آن، بسته‌ی http متن فارسی را به‌هم‌ریخته می‌خواند.

کلیدی که داخل اپ می‌گذارید قابل استخراج است. پیش از انتشار، در صفحه‌ی «سقف و هزینه»ی ایجنت سقف ماهانه بگذارید؛ وقتی پر شود، ایجنت تا آخر ماه رد می‌کند و چیزی بیشتر خرج نمی‌شود. اگر کلید لو رفت، «عوض کردن کلید» کلید قبلی را همان لحظه از کار می‌اندازد.

از کد فانکشن‌های پروژه

کد یک فانکشن پروژه هم می‌تواند بی کلید و بی درخواست HTTP از ایجنت بپرسد؛ مثلاً هر تیکت تازه را با یک ایجنت دسته‌بند برچسب بزند:

const r = ctx.ai.ask("<شناسهٔ ایجنت>", ctx.input.body, {
  data: { title: ctx.input.title },
});

جواب همان بدنه‌ی پاسخ API است و هر اجرای فانکشن حداکثر ۲ بار می‌پرسد؛ در قانون‌ها کار نمی‌کند. جزئیات در راهنمای فانکشن‌ها.

وقتی چت بات جواب را نمی‌داند

پرسشی که ایجنت جوابش را نداشته باشد handoff: true می‌گیرد. در صفحه‌ی «ارجاع به انسان» یک راه تماس می‌گذارید (تلفن، شناسه‌ی بله، ایمیل یا پیوند) و ویجت و بله همان را زیر جواب نشان می‌دهند. هر روز از ساعت ۹ صبح هم خلاصه‌ی سؤال‌های بی‌جواب دیروز در زنگوله‌ی پنل می‌آید، و کنار هر کدام در گزارش سؤال‌ها دکمه‌ی «افزودن به دانسته‌ها» هست. این چرخه را در چت بات پشتیبانی سایت کامل نوشته‌ایم.

هزینه ساخت چت بات هوش مصنوعی چقدر است؟

ساختن ایجنت هزینه‌ی جدایی ندارد. چت بات دو هزینه دارد و هر دو تومانی است:

  • هزینه‌ی ساعتی، فقط وقتی ایجنت روشن است: از ساعتی ۵۰ تومان در پلن اسپرسو، یعنی حدود ۳۶ هزار تومان در ماه برای ایجنتی که همیشه روشن است، تا ساعتی ۵۰۰ تومان در آفوگاتو. پلن بالاتر دانسته، جدول، سرعت و مدل بیشتری دارد. ایجنت خاموش هیچ هزینه‌ای ندارد.
  • هزینه‌ی هر جواب، بر پایه‌ی هزینه‌ی واقعی مدل برای همان پرسش. پنل برای هر مدل برآورد یک جواب معمولی را نشان می‌دهد که امروز با مدل پیش‌فرض حدود ۱۰۰ تومان است. پرسشی که به جدول می‌رسد دو بار مدل را صدا می‌زند.

برای شروع لازم نیست حتی یک تومان پرداخت کنید. حساب تازه ۱۵۰ هزار تومان اعتبار هدیه‌ی ثبت‌نام دارد که هزینه‌ی ساعتی را می‌دهد؛ این اعتبار به‌تنهایی بیش از چهار ماه ایجنت اسپرسوی همیشه‌روشن را می‌پوشاند. ۵۰۰۰ تومان اعتبار هدیه‌ی هوش مصنوعی هم دارد که خرج جواب‌ها و تشخیص متن PDF می‌شود. بعد از آن، کیف پول را با درگاه زرین‌پال و به تومان شارژ می‌کنید. جدول کامل پلن‌ها در صفحه‌ی قیمت‌ها است.

پیش از ساختن، این محدودیت‌ها را بدانید

هر چیزی که به ایجنت بدهید ممکن است بیرون کشیده شود. جلوگیری کامل از prompt injection ممکن نیست. رمز، کلید یا هر چیزی که نباید به دست کاربر برسد را در دستورالعمل، دانسته‌ها و جدول‌های وصل‌شده نگذارید.

اعتبارسنجی تابع نوشتنی آخرین دروازه است. هر کسی که با ایجنت حرف می‌زند می‌تواند آن را به صدا زدن تابع با مقدارهای معتبر وادارد. تأیید جلوی کاری را می‌گیرد که کاربر نخواسته، ولی جلوی کاربری را که خودش چیز بی‌ربطی می‌خواهد نمی‌گیرد. پس مثل cancel_order بالا، هر مقدار را در خود تابع بسنجید و هویت را با چیزی که فقط صاحب رکورد می‌داند چک کنید.

گزارش‌ها بسته به پلن ۳۰ تا ۱۸۰ روز می‌مانند. متن پرسش، data و history ثبت می‌شوند تا ببینید چه پرسیده‌اند، پس داده‌ی شخصی کاربر را بی‌دلیل نفرستید.

از کدام کار شروع کنم؟

هر کدام از این‌ها را در یک مقاله‌ی جدا با کد کامل نوشته‌ایم:

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

کارهای بعدی: ثبت لید با چت بات و ساخت ربات بله با هوش مصنوعی.

سوالات متداول

برای ساخت چت بات هوش مصنوعی برای سایت باید برنامه‌نویسی بلد باشم؟
نه. دستورالعمل، دانسته‌ها، اتصال جدول و حتی تابع «ثبت لید» همه در پنل ساخته می‌شوند. ویجت سایت با یک خط اسکریپت روی سایتتان می‌نشیند و بازوی بله فقط یک توکن می‌خواهد. کد فقط وقتی لازم است که بخواهید ایجنت را از اپ یا سرور خودتان با API صدا بزنید، یا تابع نوشتنی خاص خودتان را بنویسید.
هزینه ساخت چت بات برای سایت چقدر است؟
ساختن هزینه ندارد. ایجنت روشن هزینه‌ی ساعتی دارد، از ۵۰ تومان در پلن اسپرسو (حدود ۳۶ هزار تومان در ماه برای ایجنت همیشه‌روشن) تا ۵۰۰ تومان در آفوگاتو، و هر جواب بر پایه‌ی هزینه‌ی واقعی مدل به تومان حساب می‌شود. ایجنت خاموش هزینه‌ای ندارد. حساب تازه اعتبار هدیه‌ی ثبت‌نام برای هزینه‌ی ساعتی و ۵۰۰۰ تومان اعتبار هدیه‌ی هوش مصنوعی برای جواب‌ها دارد.
چت بات می‌تواند سفارش ثبت یا لغو کند یا شماره‌ی مشتری را بگیرد؟
بله، از راه تابع‌هایی که خودتان با «اجازه‌ی نوشتن» به ایجنت وصل می‌کنید. اگر «تأیید» را روشن کنید، کاربر پیش از هر کار خلاصه‌اش را می‌بیند و تا تأیید نکند چیزی ثبت نمی‌شود. برای گرفتن نام و شماره‌ی تماس، دکمه‌ی «ثبت لید» تابع آماده را بی‌کدنویسی می‌سازد.
چت بات فیکارو سؤال دنباله‌دار کاربر را می‌فهمد؟
بله. ویجت سایت پیام‌های قبلی گفت‌وگو را خودش همراه هر پرسش می‌فرستد و بازوی بله ۶ پیام آخر هر گفت‌وگو را تا ۲۴ ساعت نگه می‌دارد. در API، اپ شما پیام‌های قبلی را در فیلد history می‌فرستد (حداکثر ۶ پیام و ۸۰۰۰ نویسه).
می‌شود چت بات را به اپلیکیشن اندروید یا فلاتر وصل کرد؟
بله. ایجنت یک آدرس API معمولی است و هر کلاینت HTTP می‌تواند صدایش بزند. چون کلید داخل اپ قابل استخراج است، بهتر است از سرور خودتان صدایش بزنید، و اگر کلید را در اپ گذاشتید، پیش از انتشار برای ایجنت سقف ماهانه بگذارید.

مطالب مرتبط