PHP

Envoyez un e-mail depuis un script PHP simple avec messagebird/sdk. Vous avez besoin d'une clé Bird API : créez-en une dans Developers > Clés API (Envoyez votre premier e-mail décrit la procédure), puis exportez-la en tant que BIRD_API_KEY.

1. Installer

composer require messagebird/sdk
mkdir -p examples

Le SDK nécessite PHP 8.2+ et découvre automatiquement un client HTTP PSR-18 installé.

2. Envoyer

Créez examples/quickstart-email.php pour que le chemin d'autoload de l'exemple généré se résolve correctement :

<?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 est l'expéditeur d'onboarding partagé de Bird et delivered@messagebird.dev est un destinataire sandbox qui délivre systématiquement : aucune vérification de domaine n'est nécessaire. Le SDK déduit la région à partir du préfixe bk_us1_ / bk_eu1_ de votre clé (aucune URL de base à configurer) et génère automatiquement un Idempotency-Key par appel, ce qui rend les envois réessayés sûrs.

3. Exécuter

php examples/quickstart-email.php

Le script affiche l'ID du message et son statut :

em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted est le 202 du API : Bird détient le message et le délivre de manière asynchrone. Récupérez-le par son ID em_ avec $bird->email->get($message->getId()) et observez le statut passer à delivered.

Étapes suivantes

• PHP SDK : le client complet, le modèle d'erreur et la vérification des webhooks.
• Envoyez votre premier e-mail : création d'une clé API et liste complète des adresses sandbox.
• Domaines d'envoi : vérifiez votre propre domaine pour l'envoi en production.
• Référence API e-mail : le schéma complet de requête et de réponse.