PHP

Kirim email dari skrip PHP biasa dengan messagebird/sdk. Anda memerlukan kunci Bird API: buat di Developers > API keys (Kirim email pertama Anda memandu prosesnya), lalu ekspor sebagai BIRD_API_KEY.

1. Instal

composer require messagebird/sdk
mkdir -p examples

SDK memerlukan PHP 8.2+ dan secara otomatis mendeteksi klien PSR-18 HTTP yang terinstal.

2. Kirim

Buat examples/quickstart-email.php agar path autoload dari contoh yang dihasilkan dapat ditemukan dengan benar:

<?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 adalah pengirim onboarding bersama milik Bird dan delivered@messagebird.dev adalah penerima sandbox yang selalu berhasil terkirim: tidak perlu verifikasi domain. SDK menyimpulkan region dari prefiks bk_us1_ / bk_eu1_ pada kunci Anda (tidak perlu mengonfigurasi base URL) dan otomatis menghasilkan Idempotency-Key per panggilan, sehingga pengiriman ulang aman.

3. Jalankan

php examples/quickstart-email.php

Skrip mencetak ID pesan dan statusnya:

em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted adalah 202 dari API: Bird menerima pesan dan mengirimkannya secara asinkron. Ambil pesan berdasarkan em_ ID dengan $bird->email->get($message->getId()) dan pantau statusnya berubah menjadi delivered.

Langkah selanjutnya

• PHP SDK: klien lengkap, model kesalahan, dan verifikasi webhook.
• Kirim email pertama Anda: membuat kunci API dan daftar lengkap alamat sandbox.
• Domain pengiriman: verifikasi domain Anda sendiri untuk pengiriman produksi.
• Referensi API email: skema request dan response lengkap.