Skip to main content

API WhatsApp для бизнеса

Подключите свой номер WhatsApp к BeeCastly, чтобы общаться с клиентами, позволить ИИ отвечать за вас и делать рассылки. Подключиться можно, отсканировав QR-код, или через официальный Meta WhatsApp Cloud API.

Что понадобится

Аккаунт BeeCastly (подойдёт бесплатный тариф)
Аккаунт Meta Business (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Подключите WhatsApp в 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: создайте ссылку click-to-chat или QR-код для вашего сайта и плакатов.
Integrations → Channels → WhatsApp: редактируйте профиль компании и каталог товаров (Cloud API).

Лучшие практики

Поддерживайте высокий рейтинг качества

Держите рейтинг качества сообщений на высоком уровне и не допускайте спама. Если пользователи блокируют вас или жалуются на сообщения, Meta может урезать ваши лимиты отправки.

Получайте согласие на рассылку

Получите чёткое разрешение, прежде чем отправлять маркетинговые сообщения, например через форму, чат на сайте или лично.

Разумно используйте автоответы ИИ

Ответы ИИ работают лучше всего, когда в вашей Базе знаний есть цены, часы работы и правила. Всегда оставляйте клиентам возможность связаться с человеком.

Важно: 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