PHP

Envie um e-mail a partir de um script PHP simples com messagebird/sdk. Você precisa de uma chave Bird API: crie uma em Developers > API keys (Envie seu primeiro e-mail explica o processo) e depois exporte-a como BIRD_API_KEY.

1. Instale

composer require messagebird/sdk
mkdir -p examples

O SDK requer PHP 8.2+ e descobre automaticamente um cliente HTTP PSR-18 instalado.

2. Envie

Crie examples/quickstart-email.php para que o caminho de autoload do exemplo gerado seja resolvido corretamente:

<?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 é o remetente compartilhado de onboarding do Bird e delivered@messagebird.dev é um destinatário sandbox que sempre entrega: não é necessária verificação de domínio. O SDK infere a região a partir do prefixo bk_us1_ / bk_eu1_ da sua chave (sem URL base para configurar) e gera automaticamente um Idempotency-Key por chamada, então reenvios são seguros.

3. Execute

php examples/quickstart-email.php

O script imprime o ID da mensagem e o status:

em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted é o 202 do API: Bird tem a mensagem e a entrega de forma assíncrona. Consulte-a pelo ID em_ com $bird->email->get($message->getId()) e acompanhe o status mudar para delivered.

Próximos passos

• PHP SDK: o cliente completo, modelo de erro e verificação de webhook.
• Envie seu primeiro e-mail: criação de uma chave API e o conjunto completo de endereços sandbox.
• Domínios de envio: verifique seu próprio domínio para envio em produção.
• Referência do API de e-mail: o esquema completo de requisição e resposta.