---
title: "API و وب‌هوک چیست و چت‌بات چطور با سیستم‌های دیگر کسب‌وکار حرف می‌زند؟"
description: "API و وب‌هوک چیست؟ با مثال ساده بخوانید چت‌بات چطور اطلاعات را از سیستم دیگر می‌گیرد یا رویداد می‌فرستد و قبل از اتصال چه چیزهایی باید آماده باشد."
url: "https://artinmag.ir/articles/artinbot-api-webhook-explained-chatbot-connect-systems"
author: "مرتضی علیزاده"
category: "چت بات"
published: "2026-10-22T17:31:12.4854609"
updated: "2026-10-22T17:31:12.485461"
lang: "fa"
publisher: "مجله آرتین — شرکت هوش گستر فردا آرتین"
---

# API و وب‌هوک چیست و چت‌بات چطور با سیستم‌های دیگر کسب‌وکار حرف می‌زند؟

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

## چرا چت‌بات گاهی نباید فقط جواب بدهد؟

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

اینجاست که دو واژه وارد بحث می‌شوند که شاید بارها شنیده‌اید و کمتر کسی دقیق توضیحشان داده است: API و وب‌هوک. این مقاله قرار نیست شما را برنامه‌نویس کند. هدفش این است که وقتی تیم فنی یا یک فروشنده‌ی نرم‌افزار این واژه‌ها را به کار برد، دقیقاً بدانید درباره‌ی چه حرف می‌زنند و چه چیزی باید فراهم باشد تا چت‌بات واقعاً به یک سیستم دیگر وصل شود.

اگر هنوز مبحث دانش و منابع چت‌بات برایتان روشن نیست، پیش از این مقاله بهتر است [آماده‌سازی اسناد کسب‌وکار قبل از آپلود](https://artinmag.ir/articles/artinbot-prepare-business-documents-before-chatbot-upload) را بخوانید. چون اتصال به سیستم‌ها جای دانش درست را نمی‌گیرد و فقط مکمل آن است. برای آشنایی با خود محصول هم می‌توانید به [آرتین‌بات](https://artin-bot.ir) سر بزنید.

## API را با یک رستوران توضیح بدهیم

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

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

نکته‌ی مهمی که اغلب نادیده گرفته می‌شود: API را سیستم مقصد باید داشته باشد. اگر نرم‌افزار فروشگاه یا حسابداری شما چنین راهی را فراهم نکرده باشد، چت‌بات هر قدر هم هوشمند باشد، دری برای زدن ندارد.

## وب‌هوک را با زنگ در مقایسه کنید

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

وب‌هوک روشی است که وقتی رویداد مشخصی رخ داد، سیستم اول به طور خودکار اطلاعات را به یک آدرس معین در سیستم دوم می‌فرستد. مثلاً وقتی مشتری فرم درخواست تماس را کامل کرد، اطلاعاتش بلافاصله به نرم‌افزار مدیریت مشتریان یا یک اعلان داخلی ارسال شود. سیستم دوم لازم نیست مدام بپرسد «چیز جدیدی هست؟»؛ خبر خودش می‌رسد.

## تفاوت این دو در یک جمله

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

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

## سه سناریوی واقعی برای یک فروشگاه یا شرکت خدماتی

سناریوی اول، پیگیری سفارش. مشتری شماره‌ی سفارش را می‌دهد، چت‌بات آن را از طریق اتصال مجاز از سیستم فروشگاه می‌پرسد و وضعیت واقعی را برمی‌گرداند. در آرتین‌بات برای فروشگاه‌هایی که از ووکامرس یا شاپیفای استفاده می‌کنند، ابزار پیگیری سفارش در نظر گرفته شده است که همین کار را با رعایت حریم خصوصی مشتری انجام می‌دهد. جزئیاتش را در مقاله‌ی [ابزار «سفارشم کجاست؟»](https://artinmag.ir/articles/artinbot-where-is-my-order-tool-woocommerce-shopify) بخوانید.

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

سناریوی سوم، اعلان به تیم. وقتی مشتری ناراضی است یا درخواست حساسی ثبت کرده، می‌توان به جای اینکه چت‌بات سعی کند خودش حلش کند، رویداد را به یک کانال داخلی بفرستید. این همان اصل ارجاع به انسان است که در [اصل سکوت ربات](https://artinmag.ir/articles/artinbot-bot-silence-principle-human-handoff) مفصل‌تر توضیح داده‌ایم.

## قبل از اتصال، چه چیزهایی باید آماده باشد؟

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

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

اگر این بخش‌ها را دوست دارید از زاویه‌ی ریسک و منبع حقیقت بررسی کنید، مقاله‌ی [اتصال ایجنت به موجودی و قیمت واقعی](https://artinmag.ir/articles/artinbot-connect-ai-agent-to-real-inventory-pricing) دقیقاً برای همین نوشته شده است.

## آرتین‌بات در این بخش چه فراهم می‌کند؟

در آرتین‌بات می‌توانید ابزارهایی تعریف کنید که چت‌بات در حین گفت‌وگو از آن‌ها استفاده کند. ابزار می‌تواند اطلاعات لازم را مرحله‌به‌مرحله از مشتری بگیرد، تاریخ شمسی را بفهمد و درخواست را به سرویس بیرونی بفرستد. اگر سرویس مقصدی در دسترس نباشد، حالت ثبت درخواست هم وجود دارد که اطلاعات را برای پیگیری تیم نگه می‌دارد. جزئیات این بخش در مقاله‌ی [ابزارهای API و هماهنگ‌کننده‌ی ابزار](https://artinmag.ir/articles/artinbot-api-tools-orchestrator) آمده است.

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

## اشتباهی که در این مرحله رایج است

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

اشتباه سوم هم نادیده گرفتن موارد شکست است. وقتی سیستم مقصد جواب نمی‌دهد، چت‌بات چه می‌گوید؟ بهترین حالت این است که صادقانه اعلام کند اطلاعات در دسترس نیست و مشتری را به پشتیبان ارجاع دهد؛ همان رفتاری که در مقاله‌ی [سه رفتار درست وقتی چت‌بات جواب را نمی‌داند](https://artinmag.ir/articles/artinbot-chatbot-dont-know-three-right-behaviors) درباره‌اش نوشتیم.

## جمع‌بندی

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

اگر می‌خواهید چت‌بات کسب‌وکارتان را بسازید و بعد از آماده شدن دانش، قدم به قدم آن را به سیستم‌های خود وصل کنید، [آرتین‌بات](https://artin-bot.ir) را امتحان کنید.

## پرسش‌های متداول

### API چیست؟

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

### وب‌هوک چیست؟

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

### تفاوت API و وب‌هوک چیست؟

در API درخواست از سمت شما شروع می‌شود، در وب‌هوک سیستم مبدأ هنگام رویداد شما را خبر می‌کند.

### آیا چت‌بات به همه‌ی نرم‌افزارها وصل است؟

خیر. اتصال به API موجود، مجوز، طراحی و پیاده‌سازی مناسب نیاز دارد و صرف وجود چت‌بات به معنی اتصال آماده نیست.

### چه سطح دسترسی به چت‌بات بدهیم؟

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

### اگر سیستم مقصد جواب ندهد چه می‌شود؟

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

---

منبع: [API و وب‌هوک چیست و چت‌بات چطور با سیستم‌های دیگر کسب‌وکار حرف می‌زند؟](https://artinmag.ir/articles/artinbot-api-webhook-explained-chatbot-connect-systems) — مجله آرتین