PHP

Envía un correo electrónico desde un script PHP simple con messagebird/sdk. Necesitas una clave Bird API: crea una en Developers > API keys (Envía tu primer correo electrónico te guía paso a paso) y luego expórtala como BIRD_API_KEY.

1. Instala

composer require messagebird/sdk
mkdir -p examples

El SDK requiere PHP 8.2+ y descubre automáticamente un cliente HTTP PSR-18 instalado.

2. Envía

Crea examples/quickstart-email.php para que la ruta de autoload del ejemplo generado se resuelva correctamente:

<?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 es el remitente compartido de incorporación de Bird y delivered@messagebird.dev es un destinatario de sandbox que siempre entrega: no necesitas verificación de dominio. El SDK infiere la región a partir del prefijo bk_us1_ / bk_eu1_ de tu clave (no hay URL base que configurar) y genera automáticamente un Idempotency-Key por llamada, así que los envíos reintentados son seguros.

3. Ejecútalo

php examples/quickstart-email.php

El script imprime el ID del mensaje y el estado:

em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted es el 202 del API: Bird tiene el mensaje y lo entrega de forma asíncrona. Consúltalo por su ID em_ con $bird->email->get($message->getId()) y observa cómo el estado pasa a delivered.

Próximos pasos

• PHP SDK: el cliente completo, el modelo de errores y la verificación de webhooks.
• Envía tu primer correo electrónico: cómo crear una clave API y el conjunto completo de direcciones de sandbox.
• Dominios de envío: verifica tu propio dominio para envíos en producción.
• Referencia de API de email: el esquema completo de solicitud y respuesta.