CLI

Wyślij pierwszy e-mail z terminala macOS lub Linux: zainstaluj bird CLI, zaloguj się raz i wyślij. Nie musisz kopiować klucza API.

1. Instalacja

curl -fsSL https://cli.bird.com/install.sh | sh

Uruchom bird version, aby potwierdzić, że instalacja się powiodła. Informacje o systemie Windows i innych opcjach instalacji znajdziesz w artykule Instalacja CLI.

2. Logowanie

bird auth login --scope emails:write

To polecenie otwiera w przeglądarce stronę zgody, na której wybierasz obszar roboczy i zatwierdzasz uprawnienie. Zakres emails:write pozwala wysyłać w kroku 3. Bez niego bird auth login żąda dostępu tylko do odczytu i wysyłka jest odrzucana. CLI zapisuje token OAuth powiązany z obszarem roboczym w ~/.config/bird/credentials.json, odświeża go w razie potrzeby i rejestruje region obszaru roboczego.

3. Wyślij e-mail

Wyślij z udostępnionej domeny onboardingowej Bird na adres sandboxowy delivered@messagebird.dev: bez weryfikacji domeny, bez prawdziwej skrzynki pocztowej.

bird email send \
  --from onboarding@messagebird.dev \
  --to delivered@messagebird.dev \
  --subject "Hello from Bird" \
  --html "<p>My first Bird email.</p>"

CLI wypisuje zaakceptowaną wiadomość jako JSON. Pola *_count śledzą odbiorców przez kolejne stany doręczenia. W początkowej odpowiedzi jeden odbiorca jest zaakceptowany, żaden nie jest doręczony:

{
  "id": "em_01ky7ma8y2es1s2akzk53tmjn0",
  "status": "accepted",
  "category": "marketing",
  "from": { "email": "onboarding@messagebird.dev" },
  "to": [{ "email": "delivered@messagebird.dev" }],
  "subject": "Hello from Bird",
  "accepted_count": 1,
  "processed_count": 0,
  "delivered_count": 0,
  "deferred_count": 0,
  "bounced_count": 0,
  "complained_count": 0,
  "rejected_count": 0,
  "open_count": 0,
  "click_count": 0,
  "track_opens": true,
  "track_clicks": true,
  "created_at": "2026-07-23T13:58:20.866Z"
}

--to można powtarzać dla wielu odbiorców, --text wysyła treść jako zwykły tekst, a --dry-run wypisuje rozwiązane żądanie bez wysyłania.

4. Sprawdź wynik

accepted oznacza, że Bird przyjął wiadomość i doręcza ją asynchronicznie. Odczytaj ją ponownie po identyfikatorze em_ i obserwuj, aż status osiągnie delivered:

bird email get em_01ky7ma8y2es1s2akzk53tmjn0

Dodaj --format text, aby zamiast JSON uzyskać kartę czytelną dla człowieka.

Każde polecenie domyślnie wypisuje JSON na standardowe wyjście. Błędy trafiają na standardowe wyjście błędów w postaci odpowiedzi z błędem JSON, a kody zakończenia identyfikują kategorie awarii. Pełny kontrakt znajdziesz w artykule CLI dla agentów.

Kolejne kroki

• Dokumentacja CLI: instalacja, uwierzytelnianie, kontrakt wyjściowy i główne grupy poleceń.
• CLI dla agentów: wyjście JSON, kody zakończenia, --dry-run i idempotentne ponowienia.
• Wyślij pierwszy e-mail: ten sam przepływ przez surowe HTTP i SDK.
• Domeny wysyłkowe: zweryfikuj własną domenę do wysyłki produkcyjnej.