Utwórz konto i klucz
Dwa sposoby na uzyskanie klucza — z poziomu Bitrix24 lub w konsoli deweloperskiej za pomocą adresu e-mail i hasła. Bez redirect URI, bez PKCE, bez ekranu zgody.
Klucz API można uzyskać na dwa równie dobre sposoby, w zależności od tego, jak korzystają Państwo z WASync.
Otwórz aplikację w Bitrix24, przejdź do Settings → API & Agents i znajdź kartę API keys. Nadaj integracji nazwę i kliknij Create key.
Utworzenie klucza wymaga co najmniej jednego połączenia z aktywnym API add-on
(12 USD za numer miesięcznie) — bez niego przycisk jest nieaktywny i wyświetla
przyczynę, a serwer odpowiada 403 addon_required. Klucz jest wyświetlany
jednorazowo, w tym samym miejscu, wraz z przyciskiem Copy, i ma standardowe
zakresy whatsapp.read whatsapp.send.
Listy dozwolonych adresów IP, konfiguracja webhooks oraz zarządzanie kilkoma portalami z jednego konta znajdują się w konsoli deweloperskiej, a nie na tej karcie — karta zawiera link do niej.
Klucz jest wyświetlany tylko raz — przechowywany jest wyłącznie jego hash. Skopiuj go od razu do swojego środowiska.
export WASYNC_API_KEY=wsk_live_…Wysyłaj go w każdym żądaniu:
Authorization: Bearer $WASYNC_API_KEYTo cała konfiguracja uwierzytelniania. Bez redirect URI, bez PKCE, bez ekranu zgody, bez odświeżania tokenów.
Zakresy
Zaznacz tylko to, czego potrzebuje integracja — zakresy są przypisane do klucza.
| Scope | What it allows |
|---|---|
whatsapp.read | Wyświetlanie listy połączeń i odczyt wiadomości. |
whatsapp.send | Wysyłanie wiadomości i odczyt potwierdzeń. |
whatsapp.events | Odbieranie webhooks oraz konfiguracja miejsca ich dostarczania. |
whatsapp.manage | Tworzenie, podgląd, restartowanie, wylogowywanie i usuwanie połączeń. |
Zakresy oraz lista dostępnych połączeń są ustalane na bieżąco przy każdym żądaniu, więc unieważnienie klucza lub zawężenie jego uprawnień działa już od następnego wywołania — nic nie jest buforowane i nic nie trzeba odświeżać. Szczegóły oraz informacje o tym, czym grozi wyciek poszczególnych zakresów, znajdą Państwo w sekcji Zakresy.
Nie możesz zablokować sobie dostępu
Opcjonalna lista dozwolonych adresów IP jest egzekwowana wyłącznie przy wywołaniach API. Strona, na której ją edytujesz, jest uwierzytelniana kontem, a nie kluczem, więc pozostaje dostępna z każdego adresu. Zobacz Lista dozwolonych adresów IP.
Ile kosztuje połączenie
Każdy numer WhatsApp wymaga aktywnej licencji, aby wysyłać i odbierać wiadomości.
Nowy numer zaczyna od 7-dniowego bezpłatnego okresu próbnego, a następnie
kosztuje 19 USD miesięcznie za numer qr (WAPP) lub 29 USD miesięcznie za numer
cloud_api (WABA). Na portalu Bitrix24 dostęp do numeru przez API to osobny
dodatek za 12 USD za numer miesięcznie. Pełny opis znajdą Państwo w
Licencje i okres próbny.