CLI

Invia la tua prima email da un terminale macOS o Linux: installa la bird CLI, accedi una volta e invia. Non serve copiare una chiave API.

1. Installazione

Esempio di codice

curl -fsSL https://cli.bird.com/install.sh | sh

Esegui bird version per verificare che l'installazione sia riuscita. Per Windows e altre opzioni di installazione, consulta Installare la CLI.

2. Accesso

Esempio di codice

bird auth login --scope emails:write

Questo apre una pagina di consenso nel browser dove scegli uno spazio di lavoro e approvi l'autorizzazione. Lo scope emails:write consente l'invio al passaggio 3. Senza di esso, bird auth login richiede accesso in sola lettura e l'invio viene rifiutato. La CLI memorizza un token OAuth legato allo spazio di lavoro in ~/.config/bird/credentials.json, lo aggiorna quando necessario e registra la regione dello spazio di lavoro.

3. Inviare un'email

Invia dal dominio condiviso di onboarding di Bird all'indirizzo sandbox delivered@messagebird.dev: nessuna verifica del dominio, nessuna casella di posta reale necessaria.

Esempio di codice

bird email send \
  --from onboarding@messagebird.dev \
  --to delivered@messagebird.dev \
  --subject "Hello from Bird" \
  --html "<p>My first Bird email.</p>"

La CLI stampa il messaggio accettato come JSON. I campi *_count tracciano i destinatari attraverso gli stati di consegna. Nella risposta iniziale, un destinatario è accettato e nessuno è consegnato:

Esempio di codice

{
  "id": "em_01ky7ma8y2es1s2akzk53tmjn0",
  "status": "accepted",
  "category": "marketing",
  "from": { "email": "onboarding@messagebird.dev" },
  "to": [{ "email": "delivered@messagebird.dev" }],
  "subject": "Hello from Bird",
  "accepted_count": 1,
  "processed_count": 0,
  "delivered_count": 0,
  "deferred_count": 0,
  "bounced_count": 0,
  "complained_count": 0,
  "rejected_count": 0,
  "open_count": 0,
  "click_count": 0,
  "track_opens": true,
  "track_clicks": true,
  "created_at": "2026-07-23T13:58:20.866Z"
}

--to è ripetibile per più destinatari, --text invia un corpo in testo semplice e --dry-run stampa la richiesta risolta senza inviarla.

4. Controllare il risultato

accepted significa che Bird ha accettato il messaggio e lo consegna in modo asincrono. Rileggilo tramite il suo ID em_ e osserva lo stato raggiungere delivered:

Esempio di codice

bird email get em_01ky7ma8y2es1s2akzk53tmjn0

Aggiungi --format text per una scheda leggibile invece di JSON.

Ogni comando scrive JSON sullo standard output per impostazione predefinita. Gli errori usano una risposta di errore JSON sullo standard error, e i codici di uscita identificano le categorie di errore. Consulta la CLI per agenti per il contratto completo.

Passaggi successivi

Riferimento CLI: installazione, autenticazione, il contratto di output e i principali gruppi di comandi.
La CLI per agenti: output JSON, codici di uscita, --dry-run e ripetizioni idempotenti.
Invia la tua prima email: lo stesso flusso tramite HTTP diretto e gli SDK.
Domini di invio: verifica il tuo dominio per l'invio in produzione.

Risorse correlate

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Guarda la guidaTesting email without spamming anyone Esplora la funzionalitàTest email delivery Segui il percorso di apprendimentoOperate messaging reliably

Prova l'esercitazione e ottieni un brief di implementazione