PHP

Invia un'email da uno script PHP con messagebird/sdk. Ti serve una chiave Bird API: creane una in Developers > API keys (Invia la tua prima email spiega come fare), poi esportala come BIRD_API_KEY.

1. Installazione

composer require messagebird/sdk
mkdir -p examples

L'SDK richiede PHP 8.2+ e rileva automaticamente un client HTTP PSR-18 installato.

2. Invio

Crea examples/quickstart-email.php in modo che il percorso di autoload dell'esempio generato venga risolto correttamente:

<?php

// Send your first email. Set BIRD_API_KEY in your environment, then run:
//   php examples/quickstart-email.php

declare(strict_types=1);

require __DIR__ . '/../vendor/autoload.php';

use MessageBird\Bird;

$bird = new Bird(getenv('BIRD_API_KEY') ?: '');

$message = $bird->email->send(
    from: 'Bird <onboarding@messagebird.dev>',
    to: ['delivered@messagebird.dev'],
    subject: 'Hello from Bird',
    html: '<p>My first Bird email.</p>',
);

echo $message->getId(), ' ', $message->getStatus(), "\n";

onboarding@messagebird.dev è il mittente condiviso di onboarding di Bird e delivered@messagebird.dev è un destinatario sandbox che recapita sempre: non serve verificare il dominio. L'SDK ricava la regione dal prefisso bk_us1_ / bk_eu1_ della tua chiave (nessun URL base da configurare) e genera automaticamente un Idempotency-Key per ogni chiamata, quindi i reinvii sono sicuri.

3. Esecuzione

php examples/quickstart-email.php

Lo script stampa l'ID del messaggio e lo stato:

em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted è lo 202 dell'API: Bird ha il messaggio e lo recapita in modo asincrono. Recuperalo tramite il suo ID em_ con $bird->email->get($message->getId()) e osserva lo stato passare a delivered.

Passi successivi

• PHP SDK: il client completo, il modello di errore e la verifica dei webhook.
• Invia la tua prima email: creazione di una chiave API e l'elenco completo degli indirizzi sandbox.
• Domini di invio: verifica il tuo dominio per l'invio in produzione.
• Riferimento API Email: lo schema completo di richiesta e risposta.