Przegląd
API szablonów WhatsApp pozwala programowo wysyłać zatwierdzone wiadomości z szablonów WhatsApp. Przydaje się to do wysyłania automatycznych potwierdzeń, przypomnień i powiadomień z zewnętrznych systemów. Do uwierzytelniania potrzebujesz klucza API.
Uwierzytelnianie
Dołączaj klucz API do każdego żądania:
X-API-Key: bg_live_your_key_hereAuthorization: Bearer bg_live_your_key_here
Wysyłanie wiadomości z szablonu
POST https://app.bugalou.com/api/templates/send
Authorization: Bearer bg_live_your_api_key_here
Content-Type: application/json
{
"template": "order_bevestiging",
"phone": "31612345678",
"variables": { "name": "Emma", "order": "12345" }
}
Parametry
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
template | string | Tak | Nazwa szablonu (np. order_bevestiging) |
phone | string | Tak | Numer telefonu z kierunkowym kraju, bez + (np. 31612345678) |
variables | object | Nie | Pary klucz–wartość dla pól zastępczych szablonu |
Pobieranie listy dostępnych szablonów
GET https://app.bugalou.com/api/templates/send Authorization: Bearer bg_live_your_api_key_here
Zwraca tablicę wszystkich zatwierdzonych szablonów z ich nazwami i oczekiwanymi zmiennymi.
Przykładowe szablony
verificatie_code— wysyłka kodu weryfikacyjnegoorder_bevestiging— potwierdzenie zamówienia z numerem zamówieniaorder_verzonden— powiadomienie o wysyłce z informacjami o śledzeniuafspraak_herinnering— przypomnienie o spotkaniufactuur_herinnering— przypomnienie o płatności faktury
Liczba dostępnych wywołań API zależy od twojego planu.
Format odpowiedzi
Sukces: {"success": true, "messageId": "..."}
Błąd: {"error": "Invalid or expired API key"} (401) lub {"error": "Template not found"} (404)
Zastosowania
- E-commerce: wysyłaj potwierdzenia zamówień i informacje o wysyłce ze swojego sklepu
- Firmy usługowe: wysyłaj przypomnienia o spotkaniach i powiadomienia o fakturach
- Własne aplikacje: uruchamiaj wiadomości WhatsApp z dowolnego systemu przez HTTP