Skip to main content

API biznesowe WhatsApp

Połącz się z oficjalnym API WhatsApp Business od Meta, aby wysyłać spersonalizowane kampanie, automatyzować rozmowy i zarządzać zaangażowaniem klientów na dużą skalę.

Wymagania wstępne

Konto BeeCastly (wystarczy plan darmowy)
Konto Meta Business (business.facebook.com)
Zweryfikowany firmowy numer telefonu (nieużywany jeszcze w WhatsApp)
Zakończona weryfikacja firmy w Meta Business Manager

Przewodnik konfiguracji

1Połącz WhatsApp w BeeCastly

Przejdź do Ustawienia → Integracje → WhatsApp w panelu BeeCastly.
Kliknij „Połącz WhatsApp Business API”. Zostaniesz przekierowany do wbudowanego procesu rejestracji Meta.
Postępuj zgodnie z instrukcjami, aby wybrać konto Meta Business i numer telefonu.
Po połączeniu identyfikator konta WhatsApp Business, identyfikator numeru telefonu oraz token dostępu są konfigurowane automatycznie.

2Utwórz szablony wiadomości

WhatsApp wymaga wcześniej zatwierdzonych szablonów dla wiadomości wychodzących (poza 24-godzinnym oknem nie możesz wysyłać dowolnych wiadomości).
Przejdź do Kampanie → Szablony i kliknij „Utwórz szablon”.
Wybierz kategorię: Marketingowa, Użytkowa lub Uwierzytelniająca.
Napisz szablon ze zmiennymi takimi jak {{1}}, {{2}} na potrzeby personalizacji.
Prześlij go do weryfikacji przez Meta. Zatwierdzenie trwa zwykle od 1 do 24 godzin.

3Wyślij kampanię masową

Przejdź do Kampanie → Wysyłki masowe → Utwórz.
Wybierz WhatsApp jako kanał.
Wskaż zatwierdzony szablon i odbiorców (kontakty, tagi lub segmenty).
Przypisz zmienne szablonu do pól kontaktu (imię, telefon, pola niestandardowe).
Podejrzyj wiadomość, a następnie kliknij Wyślij teraz lub Zaplanuj.

4Zarządzaj rozmowami

Wszystkie przychodzące wiadomości WhatsApp pojawiają się w Wiadomości → WhatsApp.
Odpowiadaj klientom bezpośrednio ze skrzynki odbiorczej — w ciągu 24-godzinnego okna możesz wysyłać dowolne wiadomości.
Włącz Automatyczne odpowiedzi AI, aby bot AI samodzielnie obsługiwał typowe pytania.
Przypisuj rozmowy członkom zespołu do obsługi ręcznej.

Dobre praktyki

Utrzymuj wysoką ocenę jakości

Utrzymuj WYSOKĄ ocenę jakości wiadomości, unikając spamu. Jeśli użytkownicy Cię zablokują lub zgłoszą Twoje wiadomości, Meta może ograniczyć Twoje limity wysyłki.

Zbieraj wyraźne zgody

Zawsze uzyskaj wyraźną zgodę przed wysłaniem wiadomości marketingowych. Korzystaj z formularzy, widżetów na stronie lub zbierania zgód osobiście.

Mądrze korzystaj z automatycznych odpowiedzi AI

Automatyczne odpowiedzi AI działają najlepiej, gdy bot został wytrenowany na odpowiednich artykułach z bazy wiedzy. Zawsze zapewnij klientom możliwość kontaktu z człowiekiem.

Ważne: 24-godzinne okno wiadomości

WhatsApp Business API ma 24-godzinne okno wiadomości. Dowolne wiadomości możesz wysyłać wyłącznie w ciągu 24 godzin od ostatniej wiadomości klienta. Poza tym oknem musisz używać zatwierdzonych szablonów.

API Examples

Use the BeeCastly REST API to send WhatsApp messages programmatically.

bash
curl -X POST https://api.beecastly.com/api/whatsapp/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+1234567890",
    "message": "Hello from BeeCastly!"
  }
javascript·send-message.js
const response = await fetch('https://api.beecastly.com/api/whatsapp/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    phone: '+1234567890',
    message: 'Hello from BeeCastly!',
  }),
});

const data = await response.json();
console.log(data);

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

Ensure the recipient has opted in to receive messages. Check your WhatsApp Business Account health status in the Meta Business Manager.

Rate limits

WhatsApp Cloud API has rate limits. Start with small batches and scale gradually. Use the BeeCastly campaign scheduler to manage sending rates.

Frequently Asked Questions

How long does Meta verification take?
Meta Business verification typically takes 2-5 business days. Ensure your business documents are clear and match your Business Manager details.
Can I use my personal WhatsApp number?
No, you need a dedicated WhatsApp Business API number. This cannot be a personal WhatsApp or WhatsApp Business App number.
What is the cost per message?
WhatsApp charges per conversation (24-hour window), not per message. The first message in a conversation is charged; all subsequent messages within 24 hours are free.