Sign inGet Started
Rozpocznij
Przewodniki
Referencja API
SDK
CLI
Baza wiedzy
Changelog

Rozliczenia i zużycie

Rozliczenia działają na poziomie organizacji: plan, portfel i strumień faktur należą do organizacji. Ta strona opisuje, jak rozliczenia wpływają na integrację: jak mierzone jest zużycie, jak odczytać bieżący stan i jak poziom planu wyznacza limity operacyjne, w ramach których działa Twoja integracja. Informacje o operacjach na koncie (szczegóły cennika, metody płatności, podatki) znajdziesz w Bazie wiedzy: Plany i cennik oraz Zużycie, wydatki i faktury.
Rozliczeniami zarządzają ludzie, nie integracje. Każda operacja rozliczeniowa wymaga zakresu org:billing, który jest powiązany z rolą organizacji i nie może być nadany kluczowi API obszaru roboczego, więc żaden klucz bk_* nie odczyta zużycia, nie doładuje portfela ani nie zmieni planu. Właściciele i administratorzy rozliczeń robią to w sekcji Billing and payments w dashboardzie; role opisuje Users, teams & roles. Wyjątkiem są katalogi planów, produktów i cen: nie wymagają uwierzytelniania, publikują cennik na tej stronie, a CLI i MCP mogą odczytać katalog planów bezpośrednio. Ten przewodnik wyjaśnia więc, jak rozliczenia wpływają na Twoją integrację, i wskazuje stronę dashboardu z każdą liczbą. Strony te (Overview, Usage, Invoices, Spend i Settings) są opisane w artykułach Knowledge base linkowanych w tekście.

Plany i poziomy

Twoja organizacja subskrybuje jeden plan. Bieżąca subskrypcja, ulepszenia i anulowanie znajdują się na stronie Billing overview. Każdy plan ma tier (free, startup, growth lub enterprise), a tier decyduje o tym, jakie limity operacyjne odczuwa Twoja integracja:
  • Wolumen wysyłki w planie. Każdy plan zawiera miesięczny limit wysyłek e-maili, mierzony na odbiorcę: wiadomość do trzech odbiorców zużywa trzy. W płatnych planach wysyłki powyżej limitu są rozliczane jako nadwyżka do twardego pułapu; po jego przekroczeniu wysyłki są odrzucane z błędem limitu, aż okres się zresetuje. Plan Free nie ma żadnej nadwyżki: zatrzymuje się na swoich limitach miesięcznym i dziennym. Limity, pułapy i pułap nadwyżki znajdziesz w Plany i cennik.
  • Pułapy ograniczania liczby żądań skalują się z planem. Limity żądań zaczynają od wartości bazowej, Twój plan zastępuje ją wyższą, a nadpisanie per organizacja zastępuje obie, więc wyższe plany podnoszą pułapy wysyłania i odczytu. Model, bazowa stawka każdej grupy i nagłówki opisano w Limity żądań.
  • Limity zasobów. Ograniczenia takie jak liczba domen wysyłkowych, pul IP i dedykowanych adresów IP, które może posiadać organizacja, są ustawiane per plan i konfigurowalne per organizacja. Jeśli osiągniesz któryś z nich, skontaktuj się ze wsparciem zamiast szukać obejścia.
Podwyższenie planu obowiązuje natychmiast i udostępnia pełny nowy limit na resztę bieżącego okresu. Obniżenie i anulowanie wchodzą w życie na koniec bieżącego okresu rozliczeniowego. Szczegóły dotyczące sekwencji nieudanej płatności i innych reguł czasowych znajdziesz w Zmiany planu i odnowienia. Projektuj integracje tak, aby obsługiwały błędy, gdy konto przekroczy swój limit.

Pomiar zużycia

Każde wysłanie jest rozliczane w ramach bieżącego okresu rozliczeniowego organizacji. Strona Usage w dashboardzie pokazuje aktualny obraz dla każdego produktu, w oknie pomiarowym właściwym dla danego produktu: okres planu dla e-maili z limitem, miesiąc kalendarzowy dla pay-as-you-go. Produkty rozlicza się na jeden z dwóch sposobów, a różnica wpływa na Twoją integrację:
  • Produkty z limitem mają wliczony w plan pakiet (wysyłki e-mail). Strona pokazuje, ile z pakietu wykorzystałeś i jak bardzo go przekroczyłeś, dzięki czemu widzisz narastające nadużycie zanim zostanie naliczone.
  • Produkty pay-as-you-go są rozliczane za każde użycie według cennika (SMS, WhatsApp). Wiadomość może obciążyć portfel dwukrotnie: opłatą Bird przy przetwarzaniu wysyłki i opłatą strony trzeciej (dopłata operatora za SMS, udział Meta za WhatsApp) przy dostarczeniu wiadomości. Podział kosztów na wiadomość odczytasz z cost w wiadomości SMS lub WhatsApp: transaction_amount to opłata Bird, a passthrough_amount to opłata strony trzeciej.
Strona obejmuje każdy produkt z subskrypcją lub zużyciem w bieżącym okresie i przedstawia wykresy podziału dziennego, według kraju i domeny wysyłkowej dla dowolnego z nich.
Strona Usage w dashboardzie Bird: łączne wydatki z prognozą, liczba wysyłek na kanał i dzienne wykresy zużycia

Portfel

Każda organizacja ma portfel: wspólne saldo przedpłacone, przez które przechodzą wszystkie opłaty. Odnowienia planu, nadwyżki i wysyłki pay-as-you-go obciążają portfel; zapisana karta służy do jego uzupełniania (doładowania, automatyczne doładowanie oraz pokrycie odnowienia, na które saldo nie wystarcza). Strona Spend w dashboardzie to pełny rejestr wpłat i obciążeń, więc każdy ruch na portfelu jest rozliczony w jednym miejscu, a każde rozliczone doładowanie generuje trwałe potwierdzenie, które możesz pobrać jako PDF z tej samej sekcji.
Operacyjnie portfel jest zależnością wysyłek pay-as-you-go: wysyłki SMS i WhatsApp są odrzucane, gdy saldo nie pokrywa kosztu. SMS jest odrzucany na poziomie API z błędem 402; wysyłka WhatsApp jest przyjmowana, a potem odrzucana, gdy Bird próbuje ją naliczyć. Opłata naliczana przy dostarczeniu, której saldo nie pokrywa, jest pomijana zamiast odrzucana, więc wiadomość wciąż dociera do odbiorcy. Przy wolumenie transakcyjnym skonfiguruj automatyczne doładowanie i alert o niskim saldzie na stronie Billing overview lub monitoruj i alertuj po swojej stronie. Payment methods and wallet opisuje oba elementy sterowania w dashboardzie. Ostrzeżenia o niskim saldzie i powiadomienia o nieudanych płatnościach trafiają do właścicieli organizacji. E-maile z fakturami trafiają na listę powiadomień rozliczeniowych organizacji, jeśli jest ustawiona, a w przeciwnym razie do właściciela organizacji. Ustaw tę listę w Settings > Organization. Użyj monitorowanego aliasu zespołowego, aby poczta rozliczeniowa nie zależała od skrzynki jednej osoby.

Faktury

Faktury są wystawiane na organizację, jedna na miesiąc kalendarzowy, i widoczne na stronie Invoices w dashboardzie, gdzie możesz otworzyć fakturę, by zobaczyć pozycje, lub pobrać ją jako PDF. Faktury odzwierciedlają te same pomiary co strona Usage: opłata cykliczna za plan plus ewentualne nadużycie i wydatki pay-as-you-go za dany okres. Strukturę faktur, statusy i terminy płatności opisuje Usage, spend & invoices w Knowledge base.

Następne kroki

Powiązane zasoby

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Poznaj możliwościBird pricing
Uzyskaj brief wdrożeniowy