# Describe the feature to Leap. Bird delivers the messages.

Point Leap at a Bird guide and describe what your app should send. Leap writes an Encore endpoint with the Bird SDK, and your API key lives in a Leap secret.

[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/leap.mcp.md) · [CLI](/it-it/ai/leap.cli.md) · [TypeScript](/it-it/ai/leap.ts.md) · [Python](/it-it/ai/leap.py.md) · [Go](/it-it/ai/leap.go.md) · [PHP](/it-it/ai/leap.php.md) · [HTTP](/it-it/ai/leap.http.md)

## Aggiungi Bird a Leap. Poi mettiti al lavoro.

Leap scrive l'integrazione da un prompt. Tu aggiungi la chiave API.

Prompt per Leap

```
Add a backend endpoint to send email with Bird. Follow https://bird.com/docs/get-started/send-your-first-email: use the @messagebird/sdk package and read the API key from a secret named BirdApiKey.
```

-

### Chiedi a Leap

Incolla il prompt nella chat di Leap. Leap legge la quickstart di Bird, scrive l'endpoint con l'SDK Bird e dichiara il secret BirdApiKey.

-

### Imposta il secret

Crea una chiave API in Bird sotto Developers, poi API keys. In Leap, apri Settings, poi Secrets, e incolla la chiave come valore di BirdApiKey. L'avviso Missing secret value nella chat apre la stessa schermata.

-

### Invia un test

Chiama l'endpoint creato da Leap. La quickstart invia da onboarding@messagebird.dev a delivered@messagebird.dev, un indirizzo sandbox dove ogni messaggio viene recapitato. Verifica il tuo dominio prima di inviare ai clienti.

[Leggi la quickstart](/docs/get-started/send-your-first-email)

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

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

### Mantieni la chiave sul server

Leap cripta il valore BirdApiKey e passa il segreto al tuo backend a runtime. Il tuo frontend chiama il tuo backend, e il tuo backend chiama Bird.

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

### Usa un mittente che controlli

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.

Indica il prodotto Bird e il segreto. Leap scrive il codice backend.

Invia un'email di benvenuto

```
When a user signs up, send a welcome email with Bird using the @messagebird/sdk package and the BirdApiKey secret. Store the returned message ID with the user.
```

Invia un aggiornamento ordine via SMS

```
When an order ships, send the customer an SMS with Bird, including the tracking link. Use the @messagebird/sdk package and the BirdApiKey secret.
```

Traccia la consegna

```
Add an endpoint to read a Bird email message by its stored ID and return its status, so the order page shows whether the email was delivered.
```

## Prima della tua prima attività.

I dettagli dietro una connessione funzionante.

Come fa Leap a imparare la Bird API?

Dal tuo prompt. Collega una guida di Bird, come il quickstart per le email, e Leap legge la pagina prima di scrivere l'endpoint.

Dove si trova la chiave API?

In un secret di Leap. Leap cifra il valore e lo espone alla tua app a runtime, così la chiave resta fuori dal codice.

Devo impostare una regione?

No. L'Bird SDK legge la regione dalla tua chiave API, quindi una chiave che inizia con bk_eu1_ chiama l'host EU senza configurazione aggiuntiva.

## Continua a costruire. Tutto si collega.

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

- [Quickstart email](/docs/get-started/send-your-first-email) — Crea una chiave e invia la tua prima email.

- [Quickstart SDK](/docs/get-started/quickstarts) — Installa e chiama Bird in ogni linguaggio.

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