---
title: "Wyślij swoją pierwszą wiadomość SMS"
description: "Utwórz klucz Bird API, włącz kraj docelowy, wyślij wbudowany szablon SMS na swój telefon i odczytaj status doręczenia."
canonical: "https://bird.com/pl-pl/dokumentacja/get-started/send-your-first-sms"
---

# Wyślij swoją pierwszą wiadomość SMS

Wyślij wiadomość tekstową na własny telefon za pomocą Bird SMS, a następnie odczytaj ją, żeby sprawdzić, czy została doręczona. Ten przewodnik szybkiego startu używa wbudowanego szablonu, który dostarcza tekst, kategorię i współdzielonego nadawcę, którego Bird wybiera dla miejsca docelowego. Nie potrzebujesz do tego identyfikatora nadawcy ani rejestracji nadawcy.

Zanim zaczniesz, upewnij się, że portfel Twojej organizacji ma środki. Wysyłki SMS pobierają środki z portfela, a Bird odrzuca wysyłkę, której saldo nie jest w stanie pokryć, zwracając `402` `WalletInsufficientBalance`. [Metody płatności i portfel](/docs/knowledge-base/billing/payment-methods-wallet) opisuje doładowanie.

## 1. Utwórz klucz API

W panelu przejdź do **Platform tools** > [**Klucze API**](https://bird.com/dashboard/w/api-keys) i utwórz klucz z zakresem `sms:write`, który obejmuje wysyłanie i odczytywanie wiadomości. Klucze są przypisane do regionu i wyglądają jak `bk_us1_...` lub `bk_eu1_...`. Region w prefiksie wskazuje, który host API wywołać: `https://us1.platform.bird.com` lub `https://eu1.platform.bird.com`.

![Strona kluczy API w panelu Bird, z listą kluczy wraz z zamaskowanym prefiksem, zakresami i czasem ostatniego użycia](/images/docs/dashboard-api-keys.png)

Pełny klucz jest wyświetlany **raz**, w momencie utworzenia. Skopiuj go w bezpieczne miejsce, a następnie wyeksportuj do przykładów cURL:

```bash
export BIRD_API_KEY="bk_us1_..."
```

## 2. Włącz kraj docelowy

Bird wysyła SMS tylko do krajów włączonych dla Twojego obszaru roboczego. Wysyłka do innego kraju kończy się błędem `422` `SMSDestinationNotEnabled`. Włącz kraj swojego numeru telefonu w sekcji [**SMS** > **Destinations**](https://bird.com/dashboard/w/sms/destinations). Jeśli kraj jest już włączony, przejdź do kroku 3.

Z terminala [Bird CLI](/docs/cli) wprowadza tę samą zmianę. Podaj dwuliterowy kod ISO kraju, na przykład `US` dla Stanów Zjednoczonych. Jeśli Twój login CLI nie ma dostępu do ustawień SMS, polecenie wyświetli komendę `bird auth login`, która go doda:

```bash
bird sms destinations update --destination US=true
```

Agenci połączeni z [serwerem MCP](/docs/ai/mcp-server) używają narzędzia `sms_destinations_update`. Publiczne API nie ma operacji dla destynacji. Zastosowanie zmiany do wysyłek może zająć do minuty.

## 3. Wyślij wiadomość

Wyślij wbudowany szablon `bird_otp_verification` na swój telefon. Renderuje się jako **"493021 is your verification code. Do not share it."** z wartością `code`, którą przekażesz. Zainstaluj Bird SDK dla swojego języka, korzystając z jego [quickstartu SDK](/docs/get-started/quickstarts).

W kartach SDK zastąp przykładowy klucz API i zastąp `+14155550100` swoim numerem telefonu komórkowego w formacie [E.164](https://en.wikipedia.org/wiki/E.164). Karta CLI używa Twojego loginu, a karta cURL używa `BIRD_API_KEY`.

**TypeScript**

```typescript
import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: "bk_XXXXXXXXXXXXXXXXXXXXXXXX" });

const msg = await bird.sms.send({
  to: "+14155550100",
  template: { slug: "bird_otp_verification", parameters: { code: "493021" } },
});

console.log(msg.id, msg.status);
```

Examples: [TypeScript](/pl-pl/dokumentacja/get-started/send-your-first-sms.ts.md) · [Python](/pl-pl/dokumentacja/get-started/send-your-first-sms.py.md) · [Go](/pl-pl/dokumentacja/get-started/send-your-first-sms.go.md) · [PHP](/pl-pl/dokumentacja/get-started/send-your-first-sms.php.md) · [CLI](/pl-pl/dokumentacja/get-started/send-your-first-sms.cli.md) · [MCP](/pl-pl/dokumentacja/get-started/send-your-first-sms.mcp.md) · [cURL](/pl-pl/dokumentacja/get-started/send-your-first-sms.curl.md)

Jeśli Twój klucz zaczyna się od `bk_eu1_`, wywołaj zamiast tego `https://eu1.platform.bird.com`.

API odpowiada kodem `202 Accepted` i wiadomością. Jej `id` zaczyna się od `sms_`, a `status` ma wartość `accepted`: Bird przyjął wiadomość i dostarczy ją asynchronicznie. Zachowaj `id` na następny krok. Wiadomość przychodzi od współdzielonego nadawcy, którego Bird wybrał dla Twojego kraju.

## 4. Sprawdź status dostarczenia

Pobierz wiadomość po jej ID. Odczyt zaraz po wysłaniu może zwrócić `404`, dopóki wiadomość nie stanie się widoczna na endpoincie odczytu, co następuje krótko po `202`. Odczytaj ją ponownie chwilę później. Zastąp `SMS_MESSAGE_ID` wartością `id` z kroku 3, a przykładowy klucz API w zakładkach SDK swoim własnym. SDK Go nie ma typowanej metody do odczytu wiadomości SMS, więc zakładka Go wywołuje ścieżkę API przez metodę żądania `client.Get` obiektu SDK.

**TypeScript**

```typescript
import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: "bk_XXXXXXXXXXXXXXXXXXXXXXXX" });

const msg = await bird.sms.get("SMS_MESSAGE_ID");

console.log(msg.id, msg.status);
```

Examples: [TypeScript](/pl-pl/dokumentacja/get-started/send-your-first-sms.ts.md) · [Python](/pl-pl/dokumentacja/get-started/send-your-first-sms.py.md) · [Go](/pl-pl/dokumentacja/get-started/send-your-first-sms.go.md) · [PHP](/pl-pl/dokumentacja/get-started/send-your-first-sms.php.md) · [CLI](/pl-pl/dokumentacja/get-started/send-your-first-sms.cli.md) · [cURL](/pl-pl/dokumentacja/get-started/send-your-first-sms.curl.md)

Pole `status` informuje, gdzie znajduje się wiadomość:

- `accepted`: Bird ma wiadomość i nie przekazał jej jeszcze do operatora.
- `sent`: operator ma wiadomość, a `sent_at` rejestruje, kiedy Bird ją przekazał.
- `delivered`: operator potwierdził dostarczenie, a `delivered_at` zapisuje, kiedy to nastąpiło.
- `undelivered`, `failed`, `rejected` lub `expired`: wiadomość nie dotarła na telefon. `last_error` podaje przyczynę, a [Błędy dostarczenia](/docs/guides/sms/delivery-errors) wyjaśnia każdy z nich.

Odpytuj, aż status opuści `accepted` i `sent`, lub zasubskrybuj [zdarzenia SMS](/docs/guides/sms/events), aby otrzymywać każdą zmianę przez webhook. Każda wiadomość pojawia się też na stronie [**Messages**](https://bird.com/dashboard/w/sms/messages) z osią czasu zdarzeń.

## Napraw nieudane wysłanie

- **`422` `SMSDestinationNotEnabled`**: kraj odbiorcy nie jest włączony dla Twojego obszaru roboczego. Włącz go zgodnie z [krokiem 2](#2-włącz-kraj-docelowy), poczekaj do minuty i wyślij ponownie.
- **`402` `WalletInsufficientBalance`**: portfel nie pokrywa kosztu wiadomości. Doładuj portfel, a następnie wyślij ponownie.
- **`403` `InsufficientScope`**: klucz API nie ma zakresu `sms`. Zmień zakresy klucza lub utwórz klucz z `sms:write`.

## Następne kroki

- [Wysyłanie SMS](/docs/guides/sms/sending-sms): wyślij własny tekst z nadawcą i kategorią, w partiach i z bezpiecznym ponawianiem.
- [Identyfikatory nadawcy SMS](/docs/guides/sms/senders): wybierz nadawcę dla każdego kraju i zarejestruj go tam, gdzie kraj tego wymaga.
- [Szablony SMS](/docs/guides/sms/templates): katalog wbudowanych szablonów i ich zmienne.
- [Zdarzenia SMS](/docs/guides/sms/events): typy zdarzeń i dostarczanie webhooków przy każdej zmianie statusu.
- [Dokumentacja SMS API](/docs/api/reference/create-sms-message): pełny schemat żądania i odpowiedzi.

## Related resources

- [Sending your first SMS](/learn/sms/sending-your-first-sms) (video)
- [One-way and two-way SMS](/explained/sms/what-is-the-difference-between-one-way-and-two-way-sms) (answer)
- [Two-way SMS](/sms-api/features/two-way) (product)
- [Build your first integration](/learn/paths/integration) (course)

[Get an implementation brief](/learn/workspace?topic=sms-replies)