Skip to main content

WhatsApp Business API

شماره WhatsApp خود را به BeeCastly وصل کنید تا با مشتریان چت کنید، بگذارید هوش مصنوعی به‌جای شما پاسخ دهد و پیام گروهی بفرستید. می‌توانید با اسکن یک کد QR یا از طریق Meta WhatsApp Cloud API رسمی وصل شوید.

پیش نیازها

یک حساب BeeCastly (سطح رایگان کار می کند)
یک حساب تجاری متا (business.facebook.com)
برای روش Cloud API: یک حساب Meta Business (business.facebook.com) و یک شماره تلفن برای ثبت در Meta

دو راه اتصال

اسکن کد QR

شماره‌ای را که از قبل استفاده می‌کنید، از جمله شماره برنامه WhatsApp Business، درست مثل WhatsApp Web وصل کنید. رایگان است و به تأیید Meta نیاز ندارد. برای پاسخ‌ها و پاسخ‌های خودکار بهترین است. برای پیام گروهی انبوه از آن استفاده نکنید: WhatsApp ممکن است شماره را مسدود کند.

WhatsApp Cloud API (Meta)

روش رسمی از طرف Meta. به یک حساب Meta Business و قالب‌های پیام تأییدشده نیاز دارد. این روشی است که برای پیام‌های گروهی و کمپین‌ها باید استفاده کنید.

راهنمای راه اندازی

1واتس اپ را در BeeCastly وصل کنید

به Integrations → Channels → WhatsApp بروید.
کد QR: گزینه WhatsApp QR را انتخاب کنید. در گوشی‌تان WhatsApp را باز کنید ← Linked devices ← Link a device و کد را اسکن کنید. گوشی شما مثل همیشه کار می‌کند.
Cloud API: گزینه WhatsApp Cloud API (Meta) را انتخاب کنید و روی Connect with Facebook کلیک کنید. حساب Meta Business و شماره تلفن خود را انتخاب کنید. اگر ترجیح می‌دهید دستی انجام دهید، Step-by-step Wizard از شما Meta App ID، WhatsApp Business Account ID، Phone Number ID و توکن دسترسی را می‌خواهد.

2ایجاد الگوهای پیام

در Cloud API فقط تا 24 ساعت پس از آخرین پیام مشتری می‌توانید متن آزاد بفرستید. خارج از این بازه به قالبی نیاز دارید که Meta تأیید کرده باشد.
به Campaigns → Templates بروید و یک قالب بسازید.
یک دسته انتخاب کنید: Marketing، Utility یا Authentication.
برای نام‌ها و جزئیات دیگر، متغیرهایی مثل {{1}} و {{2}} اضافه کنید.
آن را ارسال کنید. Meta آن را بررسی می‌کند و وضعیت در BeeCastly به‌روز می‌شود.

3ارسال یک کمپین پخش

به کمپین‌ها ← پخش ← ایجاد بروید.
WhatsApp را به عنوان کانال انتخاب کنید.
الگوی تأیید شده و مخاطبان خود (مخاطبین، برچسب‌ها، یا بخش‌ها) را انتخاب کنید.
متغیرهای الگو را برای تماس با فیلدها (نام، تلفن، و سپس قسمت‌های سفارشی ارسال کنید
کلیک کنید)
را انتخاب کنید. یا زمان بندی.

4مدیریت مکالمات

پیام‌های ورودی WhatsApp در Messages → WhatsApp (و در All Messages) می‌آیند.
از صندوق ورودی پاسخ دهید، برای پاسخ‌هایی که زیاد می‌فرستید از Quick Replies استفاده کنید و چت‌ها را به اعضای تیم واگذار کنید.
پاسخ‌های هوش مصنوعی را روشن کنید تا چت‌بات‌تان به سؤال‌های رایج از روی پایگاه دانش شما پاسخ دهد و در صورت نیاز کار را به یک انسان بسپارد.

5ابزارهای بیشتر WhatsApp

Messages → Status Studio: وضعیت WhatsApp منتشر کنید.
Messages → wa.me Link: یک لینک چت با یک کلیک یا کد QR برای وب‌سایت و پوسترهایتان بسازید.
Integrations → Channels → WhatsApp: پروفایل کسب‌وکار و کاتالوگ محصولات خود را ویرایش کنید (Cloud API).

بهترین شیوه ها

رتبه بندی کیفیت بالا را حفظ کنید

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

رضایت شرکت را دریافت کنید

پیش از ارسال پیام‌های بازاریابی اجازه روشن بگیرید، مثلاً با یک فرم، چت وب‌سایت یا حضوری.

از پاسخ خودکار هوش مصنوعی هوشمندانه استفاده کنید

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

مهم: بازه 24 ساعته (Cloud API)

در WhatsApp Cloud API فقط تا 24 ساعت پس از آخرین پیام مشتری می‌توانید متن آزاد بفرستید. خارج از این بازه باید از یک قالب تأییدشده استفاده کنید.

API Examples

Send a WhatsApp message from your own software with an API key. See the Messages API for details.

bash
curl -X POST https://beecastly.com/api/v1/messages/send \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel":"WHATSAPP","to":"+919876543210","content":"Hello from BeeCastly!"}'
javascript·send-message.js
const response = await fetch('https://beecastly.com/api/v1/messages/send', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    channel: 'WHATSAPP',
    to: '+919876543210',
    content: 'Hello from BeeCastly!',
  }),
});

const data = await response.json(); // { success: true, data: { messageId, status: "queued" } }

Troubleshooting

Template not approved

If your template is rejected by Meta, check that it follows WhatsApp's guidelines: no promotional content in utility templates, proper formatting, and clear call-to-action buttons.

Messages not delivering

QR method: check that your phone is online and still shows BeeCastly under Linked devices. Cloud API: check that the customer has opted in and that your number's status is healthy in Meta Business Manager.

Rate limits

Meta limits how many people a new Cloud API number can message per day, and the limit grows as you send good-quality messages. Start with small broadcasts and schedule larger ones in Campaigns → Broadcasts.

Frequently Asked Questions

Can I use my WhatsApp Business App number?
Yes. With the QR method you link the number you already use, the same way WhatsApp Web works, and you keep using the app on your phone. For the Cloud API, you connect a number through Meta's sign-up steps.
Do I need Meta approval?
Not for the QR method. The Cloud API needs a Meta Business account, and Meta must approve your message templates before you can use them.
Which method should I use for broadcasts?
The Cloud API. Sending bulk messages over the QR method can get your number banned by WhatsApp, so use QR for replies and auto-replies to people who message you.
WhatsApp Guide - BeeCastly Documentation | BeeCastly