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

## Dal prompt alla consegna.

Il tuo agente può configurare i canali, gestire i clienti e confermare la consegna. Accesso completo in lettura e scrittura tramite MCP e CLI.

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

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

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

## Importa Bird in Rocket. Poi collega una schermata.

Rocket legge le richieste da una collection. La tua chiave API resta nell'ambiente del task.

Collection Bird per Rocket [Scarica la collection](/postman/bird-api-rocket.postman_collection.json)

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

Ambiente

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

-

### Carica la collection

Nel tuo task Rocket, clicca … nella barra di anteprima e scegli APIs. Apri Select an API, clicca Add APIs, scegli Upload JSON, trascina la collection e clicca Submit.

-

### Collega una richiesta a una schermata

Scegli una route e una richiesta come Create an email message, clicca Integrate API, poi clicca l'elemento che attiverà l'invio. Rocket chiede quando chiamare l'API e scrive il codice.

-

### Imposta la tua chiave API

Crea una chiave API in Bird sotto Developers, poi API keys. In Rocket, clicca il nome del task, apri Settings, poi Environment, e imposta BIRD_API_KEY e BIRD_API_URL nelle schede Staging e Production. Una chiave che inizia con bk_eu1_ chiama https://eu1.platform.bird.com.

[Esplora l'API](/docs/api)

## Costruito con un agente. Pronto per i tuoi utenti.

La tua app pubblicata ha bisogno di una propria connessione server-side a Bird.

### Tieni la chiave sul server

Rocket mantiene BIRD_API_KEY nell'ambiente del task. Ometti il prefisso NEXT_PUBLIC_, così la chiave resta nel codice server e fuori dal browser.

[Esplora l'API](/docs/api)

### Usa un mittente sotto il tuo controllo

Verifica il tuo dominio email o configura un mittente idoneo per il canale che scegli.

[Prepara il tuo primo invio](/docs)

### Mostra il risultato reale

Salva l'ID del messaggio. Aggiorna la tua app in base allo stato del messaggio o agli eventi di consegna.

[Segui il risultato](/docs/guides/webhooks)

## Alcuni buoni punti da cui partire.

Descrivi a Rocket cosa deve succedere e indica la richiesta Bird da chiamare.

Invia un'email di benvenuto

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

Invia un aggiornamento ordine via SMS

```
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.
```

Verifica un numero di telefono

```
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.
```

## Prima della tua prima attività.

I dettagli dietro una connessione funzionante.

Perché una collection Postman?

Il pannello APIs di Rocket importa collection Postman, comandi cURL e file OpenAPI. La collection Bird fornisce a ogni richiesta un esempio funzionante e nomina le variabili per l'ambiente di Rocket.

Quale host chiama la mia app?

L'host indicato dalla tua chiave API. Una chiave che inizia con bk_us1_ chiama https://us1.platform.bird.com, una che inizia con bk_eu1_ chiama https://eu1.platform.bird.com. Imposta BIRD_API_URL di conseguenza.

Come ottengo le nuove richieste Bird?

Scarica di nuovo la collection e carica il file nella tua attività. Bird ricostruisce la collection dalla propria specifica API a ogni rilascio.

## Continua a costruire. Tutto si collega.

Fai il prossimo passo con gli strumenti e le guide per il tuo progetto.

- [Riferimento API](/docs/api) — Consulta i campi e le risposte per ogni richiesta.

- [Webhooks](/docs/guides/webhooks) — Invia gli eventi di consegna alla tua app.

- [Altri strumenti AI](/ai) — Usa lo stesso spazio di lavoro da un altro strumento.



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