PHP

messagebird/sdk के साथ एक सामान्य PHP स्क्रिप्ट से ईमेल भेजें। इसके लिए आपको एक Bird API कुंजी चाहिए: Platform tools > API keys में एक कुंजी बनाएँ (अपना पहला ईमेल भेजें में इसकी पूरी प्रक्रिया दी गई है), फिर उसे BIRD_API_KEY के रूप में एक्सपोर्ट करें।

1. इंस्टॉल करें

composer require messagebird/sdk
mkdir -p examples

SDK के लिए PHP 8.2+ आवश्यक है, और यह इंस्टॉल किए गए PSR-18 HTTP क्लाइंट को अपने आप खोज लेता है।

2. भेजें

examples/quickstart-email.php बनाएँ, ताकि जनरेट किए गए उदाहरण का ऑटोलोड पाथ सही ढंग से मिल सके:

<?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, Bird का साझा ऑनबोर्डिंग प्रेषक है, और delivered@messagebird.dev एक सैंडबॉक्स प्राप्तकर्ता है जिस पर ईमेल हमेशा डिलीवर होता है, इसलिए डोमेन सत्यापन की ज़रूरत नहीं है। SDK आपकी कुंजी के bk_us1_ / bk_eu1_ प्रीफ़िक्स से क्षेत्र तय करता है, इसलिए कोई बेस URL कॉन्फ़िगर नहीं करना पड़ता। यह हर कॉल के लिए अपने आप एक Idempotency-Key बनाता है, इसलिए भेजने के लिए फिर से प्रयास करना सुरक्षित है।

3. इसे चलाएँ

php examples/quickstart-email.php

स्क्रिप्ट संदेश ID और स्थिति प्रिंट करती है:

em_01ky7ma8y2es1s2akzk53tmjn0 accepted

accepted, API का 202 है: Bird के पास संदेश पहुँच गया है और वह उसे एसिंक्रोनस रूप से डिलीवर करता है। $bird->email->get($message->getId()) से उसकी em_ ID के ज़रिए संदेश प्राप्त करें और स्थिति को delivered में बदलते हुए देखें।

अगले कदम

• PHP SDK: पूरा क्लाइंट, त्रुटि मॉडल और वेबहुक सत्यापन।
• अपना पहला ईमेल भेजें: API कुंजी बनाना और सैंडबॉक्स पतों का पूरा सेट।
• भेजने वाले डोमेन: प्रोडक्शन में भेजने के लिए अपना डोमेन सत्यापित करें।
• ईमेल API संदर्भ: अनुरोध और प्रतिक्रिया का पूरा स्कीमा।