PHP

Wyślij e-mail ze zwykłego skryptu PHP za pomocą messagebird/sdk. Potrzebujesz klucza Bird API: utwórz go w Developers > Klucze API (Wyślij pierwszy e-mail opisuje ten proces), a następnie wyeksportuj go jako BIRD_API_KEY.

1. Zainstaluj

composer require messagebird/sdk
mkdir -p examples

SDK wymaga PHP 8.2+ i automatycznie wykrywa zainstalowanego klienta PSR-18 HTTP.

2. Wyślij

Utwórz examples/quickstart-email.php, aby ścieżka autoload z wygenerowanego przykładu została poprawnie rozwiązana:

<?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 to współdzielony nadawca onboardingowy Bird, a delivered@messagebird.dev to odbiorca sandbox, który zawsze doręcza wiadomości: weryfikacja domeny nie jest potrzebna. SDK wnioskuje region z prefiksu bk_us1_ / bk_eu1_ Twojego klucza (nie trzeba konfigurować bazowego URL-a) i automatycznie generuje Idempotency-Key przy każdym wywołaniu, więc ponowne wysyłki są bezpieczne.

3. Uruchom

php examples/quickstart-email.php

Skrypt wypisuje ID wiadomości i status:

em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted to 202 API: Bird przyjął wiadomość i doręcza ją asynchronicznie. Pobierz ją po em_ ID za pomocą $bird->email->get($message->getId()) i obserwuj, jak status zmieni się na delivered.

Następne kroki

• PHP SDK: pełny klient, model błędów i weryfikacja webhooków.
• Wyślij pierwszy e-mail: tworzenie klucza API i pełny zestaw adresów sandbox.
• Domeny wysyłkowe: zweryfikuj własną domenę do wysyłki produkcyjnej.
• Dokumentacja e-mail API: pełny schemat żądania i odpowiedzi.