---
title: "Erste SMS senden"
description: "Erstellen Sie einen Bird-API-Schlüssel, aktivieren Sie ein Zielland, senden Sie eine integrierte Vorlage per SMS an Ihr Telefon und lesen Sie den Zustellstatus aus."
canonical: "https://bird.com/de-de/dokumentation/get-started/send-your-first-sms"
---

# Erste SMS senden

Senden Sie mit Bird SMS eine Textnachricht an Ihr eigenes Telefon und lesen Sie die Nachricht anschließend aus, um zu prüfen, ob sie zugestellt wurde. Dieser Schnellstart verwendet eine integrierte Vorlage, die den Text, die Kategorie und einen gemeinsamen Absender liefert, den Bird für das Zielland auswählt. Sie benötigen dafür weder eine Absender-ID noch eine Absenderregistrierung.

Stellen Sie vor dem Start sicher, dass das Wallet Ihrer Organisation Guthaben hat. SMS-Sendungen belasten das Wallet, und Bird lehnt eine Sendung, die das Guthaben nicht decken kann, mit `402` `WalletInsufficientBalance` ab. [Zahlungsmethoden und Wallet](/docs/knowledge-base/billing/payment-methods-wallet) beschreibt das Aufladen.

## 1. API-Schlüssel erstellen

Gehen Sie im Dashboard zu **Platform tools** > [**API-Schlüssel**](https://bird.com/dashboard/w/api-keys) und erstellen Sie einen Schlüssel mit dem Scope `sms:write`, der das Senden und Auslesen von Nachrichten abdeckt. Schlüssel sind auf eine Region beschränkt und sehen aus wie `bk_us1_...` oder `bk_eu1_...`. Die Region im Präfix gibt an, welchen API-Host Sie aufrufen: `https://us1.platform.bird.com` oder `https://eu1.platform.bird.com`.

![Die API-Schlüsselseite im Bird-Dashboard mit maskiertem Präfix, Scopes und letzter Verwendung](/images/docs/dashboard-api-keys.png)

Der vollständige Schlüssel wird **einmalig** bei der Erstellung angezeigt. Kopieren Sie ihn an einen sicheren Ort und exportieren Sie ihn dann für die cURL-Beispiele:

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

## 2. Zielland aktivieren

Bird sendet SMS nur in die Länder, die für Ihren Workspace aktiviert sind. Ein Versand in ein anderes Land schlägt mit `422` `SMSDestinationNotEnabled` fehl. Aktivieren Sie das Land Ihrer Telefonnummer unter [**SMS** > **Destinations**](https://bird.com/dashboard/w/sms/destinations). Falls es bereits als aktiviert angezeigt wird, fahren Sie mit Schritt 3 fort.

Über ein Terminal nimmt die [Bird CLI](/docs/cli) dieselbe Änderung vor. Übergeben Sie den zweibuchstabigen ISO-Code des Landes, zum Beispiel `US` für die Vereinigten Staaten. Falls Ihr CLI-Login keinen Zugriff auf SMS-Einstellungen hat, gibt der Befehl den `bird auth login`-Befehl aus, der den Zugriff hinzufügt:

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

Agenten, die mit dem [MCP-Server](/docs/ai/mcp-server) verbunden sind, verwenden das `sms_destinations_update`-Tool. Die öffentliche API bietet keine Operation für Zielländer. Eine Änderung kann bis zu einer Minute brauchen, bis sie auf Sendungen angewendet wird.

## 3. Nachricht senden

Senden Sie das integrierte `bird_otp_verification`-Template an Ihr Telefon. Es wird als **"493021 is your verification code. Do not share it."** mit dem von Ihnen übergebenen `code`-Wert gerendert. Installieren Sie das Bird SDK für Ihre Sprache, indem Sie dem [SDK-Quickstart](/docs/get-started/quickstarts) folgen.

Ersetzen Sie in den SDK-Tabs den Beispiel-API-Schlüssel und ersetzen Sie `+14155550100` durch Ihre Mobilnummer im [E.164](https://en.wikipedia.org/wiki/E.164)-Format. Die CLI verwendet Ihr Login, und der cURL-Tab verwendet `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](/de-de/dokumentation/get-started/send-your-first-sms.ts.md) · [Python](/de-de/dokumentation/get-started/send-your-first-sms.py.md) · [Go](/de-de/dokumentation/get-started/send-your-first-sms.go.md) · [PHP](/de-de/dokumentation/get-started/send-your-first-sms.php.md) · [CLI](/de-de/dokumentation/get-started/send-your-first-sms.cli.md) · [MCP](/de-de/dokumentation/get-started/send-your-first-sms.mcp.md) · [cURL](/de-de/dokumentation/get-started/send-your-first-sms.curl.md)

Wenn Ihr Schlüssel mit `bk_eu1_` beginnt, rufen Sie stattdessen `https://eu1.platform.bird.com` auf.

Die API antwortet mit `202 Accepted` und der Nachricht. Die `id` beginnt mit `sms_`, und der `status` ist `accepted`: Bird hat die Nachricht und stellt sie asynchron zu. Notieren Sie die `id` für den nächsten Schritt. Die Nachricht kommt vom gemeinsam genutzten Absender, den Bird für Ihr Land ausgewählt hat.

## 4. Zustellstatus prüfen

Rufen Sie die Nachricht anhand ihrer ID ab. Ein Lesevorgang direkt nach dem Senden kann `404` zurückgeben, bis die Nachricht auf dem Lese-Endpoint sichtbar wird – das geschieht kurz nach dem `202`. Lesen Sie sie einen Moment später erneut. Ersetzen Sie `SMS_MESSAGE_ID` durch die `id` aus Schritt 3 und den Beispiel-API-Schlüssel in den SDK-Tabs durch Ihren eigenen. Das Go-SDK bietet keine typisierte Methode zum Lesen einer SMS-Nachricht, daher ruft der Go-Tab den API-Pfad über die `client.Get`-Request-Methode des SDK auf.

**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](/de-de/dokumentation/get-started/send-your-first-sms.ts.md) · [Python](/de-de/dokumentation/get-started/send-your-first-sms.py.md) · [Go](/de-de/dokumentation/get-started/send-your-first-sms.go.md) · [PHP](/de-de/dokumentation/get-started/send-your-first-sms.php.md) · [CLI](/de-de/dokumentation/get-started/send-your-first-sms.cli.md) · [cURL](/de-de/dokumentation/get-started/send-your-first-sms.curl.md)

Das Feld `status` gibt an, wo sich die Nachricht befindet:

- `accepted`: Bird hat die Nachricht und hat sie noch nicht an einen Carrier übergeben.
- `sent`: Der Carrier hat die Nachricht, und `sent_at` gibt an, wann Bird sie übergeben hat.
- `delivered`: Der Carrier hat die Zustellung bestätigt, und `delivered_at` gibt den Zeitpunkt an.
- `undelivered`, `failed`, `rejected` oder `expired`: Die Nachricht hat das Telefon nicht erreicht. `last_error` nennt den Grund, und [Zustellungsfehler](/docs/guides/sms/delivery-errors) erläutert jeden einzelnen.

Fragen Sie den Status ab, bis er `accepted` und `sent` verlässt, oder abonnieren Sie die [SMS-Events](/docs/guides/sms/events), um jede Änderung per Webhook zu erhalten. Jede Nachricht erscheint außerdem auf der Seite [**Messages**](https://bird.com/dashboard/w/sms/messages) mit ihrer Event-Timeline.

## Fehlgeschlagenen Versand beheben

- **`422` `SMSDestinationNotEnabled`**: Das Land des Empfängers ist für Ihren Workspace nicht aktiviert. Aktivieren Sie es wie in [Schritt 2](#2-zielland-aktivieren), warten Sie bis zu einer Minute und senden Sie erneut.
- **`402` `WalletInsufficientBalance`**: Das Guthaben reicht nicht für die Nachricht. Laden Sie das Wallet auf und senden Sie erneut.
- **`403` `InsufficientScope`**: Dem API-Key fehlt der Scope `sms`. Bearbeiten Sie die Scopes des Keys oder erstellen Sie einen Key mit `sms:write`.

## Nächste Schritte

- [SMS senden](/docs/guides/sms/sending-sms): Senden Sie eigenen Text mit einem Sender und einer Kategorie, in Batches und mit sicheren Wiederholungsversuchen.
- [SMS-Sender-IDs](/docs/guides/sms/senders): Wählen Sie einen Sender pro Land und registrieren Sie ihn, wo das Land es verlangt.
- [SMS-Templates](/docs/guides/sms/templates): Der Katalog der integrierten Templates und ihre Variablen.
- [SMS-Events](/docs/guides/sms/events): Die Event-Typen und der Webhook-Versand für jede Statusänderung.
- [SMS-API-Referenz](/docs/api/reference/create-sms-message): das vollständige Request- und Response-Schema.

## 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)