# Design it in Rocket. Wire it to Bird.

Import the Bird API into Rocket as a Postman collection. Attach a request to a screen, and Rocket writes the call for email, SMS, WhatsApp, voice, or verification.

[Get Started](/dashboard/signup)

[Contact Sales](/demo)

## Vom Prompt zur Zustellung.

Ihr Agent kann Kanäle einrichten, Kunden verwalten und die Zustellung bestätigen. Voller Lese- und Schreibzugriff über MCP und CLI.

**MCP**: `https://mcp.bird.com`

```json
{
  "name": "voice_legs_list"
}
```

Examples: [MCP](/de-de/ai/rocket.mcp.md) · [CLI](/de-de/ai/rocket.cli.md) · [TypeScript](/de-de/ai/rocket.ts.md) · [Python](/de-de/ai/rocket.py.md) · [Go](/de-de/ai/rocket.go.md) · [PHP](/de-de/ai/rocket.php.md) · [HTTP](/de-de/ai/rocket.http.md)

## Importieren Sie Bird in Rocket. Dann verbinden Sie einen Screen.

Rocket liest die Requests aus einer Collection. Ihr API-Key bleibt in der Umgebung des Tasks.

Bird-Collection für Rocket [Collection herunterladen](/postman/bird-api-rocket.postman_collection.json)

```
bird-api-rocket.postman_collection.json
```

Umgebung

```
BIRD_API_KEY=bk_us1_…
BIRD_API_URL=https://us1.platform.bird.com
```

-

### Collection hochladen

Klicken Sie in Ihrem Rocket-Task auf … in der Vorschau-Toolbar und wählen Sie APIs. Öffnen Sie Select an API, klicken Sie auf Add APIs, wählen Sie Upload JSON, ziehen Sie die Collection hinein und klicken Sie auf Submit.

-

### Einen Request mit einem Screen verbinden

Wählen Sie eine Route und einen Request wie Create an email message, klicken Sie auf Integrate API und dann auf das Element, das den Versand auslösen soll. Rocket fragt, wann die API aufgerufen werden soll, und schreibt den Code.

-

### Ihren API-Key festlegen

Erstellen Sie einen API-Key in Bird unter Developers, dann API keys. Klicken Sie in Rocket auf den Task-Namen, öffnen Sie Settings, dann Environment, und setzen Sie BIRD_API_KEY und BIRD_API_URL in den Tabs Staging und Production. Ein Key, der mit bk_eu1_ beginnt, ruft https://eu1.platform.bird.com auf.

[Die API erkunden](/docs/api)

## Mit einem Agenten gebaut. Bereit für Ihre Nutzer.

Ihre veröffentlichte App benötigt eine eigene serverseitige Verbindung zu Bird.

### Den Schlüssel auf dem Server belassen

Rocket speichert BIRD_API_KEY in der Umgebung des Tasks. Lassen Sie das Präfix NEXT_PUBLIC_ weg, damit der Schlüssel im Servercode bleibt und nicht im Browser landet.

[Die API erkunden](/docs/api)

### Einen eigenen Absender verwenden

Verifizieren Sie Ihre E-Mail-Domain oder konfigurieren Sie einen berechtigten Absender für den gewählten Kanal.

[Den ersten Versand vorbereiten](/docs)

### Das tatsächliche Ergebnis anzeigen

Speichern Sie die Nachrichten-ID. Aktualisieren Sie Ihre App anhand des Nachrichtenstatus oder der Zustellereignisse.

[Dem Ergebnis folgen](/docs/guides/webhooks)

## Ein paar gute Ausgangspunkte, um loszulegen.

Sagen Sie Rocket, was passieren soll, und benennen Sie den Bird-Request, der aufgerufen werden soll.

Eine Willkommens-E-Mail senden

```
When a user signs up, call Create an email message to send a welcome email. Save the returned message ID on the user.
```

Ein Bestell-Update per SMS senden

```
When an order ships, call Create an SMS message with the customer’s phone number and the tracking link. Show an error on the order page if the call fails.
```

Eine Telefonnummer verifizieren

```
On the sign-up screen, call Create a verification for the phone number the user enters. On the next screen, call Create a verification passcode check with the code they type.
```

## Vor Ihrer ersten Aufgabe.

Die Details hinter einer funktionierenden Verbindung.

Warum eine Postman-Collection?

Das APIs-Panel von Rocket importiert Postman-Collections, cURL-Befehle und OpenAPI-Dateien. Die Bird-Collection liefert zu jeder Anfrage ein funktionierendes Beispiel und benennt die Variablen passend für die Rocket-Umgebung.

Welchen Host ruft meine App auf?

Den Host, den Ihr API-Schlüssel vorgibt. Ein Schlüssel, der mit bk_us1_ beginnt, ruft https://us1.platform.bird.com auf, und ein Schlüssel, der mit bk_eu1_ beginnt, ruft https://eu1.platform.bird.com auf. Setzen Sie BIRD_API_URL entsprechend.

Wie erhalte ich neue Bird-Anfragen?

Laden Sie die Collection erneut herunter und laden Sie die Datei in Ihre Aufgabe hoch. Bird erstellt die Collection bei jeder Veröffentlichung aus der API-Spezifikation neu.

## Weiter bauen. Alles ist verbunden.

Gehen Sie den nächsten Schritt mit den Tools und Anleitungen für Ihr Projekt.

- [API-Referenz](/docs/api) — Lesen Sie die Felder und Antworten für jede Anfrage.

- [Webhooks](/docs/guides/webhooks) — Senden Sie Zustellereignisse an Ihre App zurück.

- [Andere KI-Tools](/ai) — Nutzen Sie denselben Workspace mit einem anderen Tool.



## Related resources

- [Setting up your coding agent](/learn/basics/setting-up-your-coding-agent) (video)
- [Set up your coding agent](/docs/ai/set-up-your-agent) (docs)
- [What is an MCP server, and how does an agent use one to send messages?](/explained/platform/what-is-an-mcp-server-and-how-does-an-agent-send-messages) (answer)
- [Build with AI agents](/learn/paths/agents) (course)

[Get an implementation brief](/learn/workspace?topic=agents)