Dërgoni një email

$email = $client->emails->send([    'from' => ['email' => '[email protected]', 'name' => 'Acme Billing'],    'to' => ['[email protected]', 'Grace <[email protected]>'],    'cc' => '[email protected]',    'bcc' => [['email' => '[email protected]']],    'replyTo' => '[email protected]',    'subject' => 'Your September invoice',    'html' => '<p>Invoice attached.</p>',    'text' => 'Invoice attached.',    'headers' => ['X-Campaign' => 'invoices'],    'attachments' => [['filename' => 'invoice.pdf', 'content' => new \SplFileInfo('invoice.pdf')]],    'threadId' => 'CAHk7pQ2x9LmZ4-mail.example.com',    'scheduledAt' => 'PT1H',    'tags' => ['order' => '4021'],    'tracking' => ['opens' => true, 'clicks' => true],]); echo $email['id'], ' ', $email['status'], PHP_EOL;

to, cc dhe bcc marrin një marrës ose një listë marrësish, dhe një marrës i vetëm mbështillet për ju. Secili mund të jetë një adresë e zhveshur, Name <addr@host> ose një array me email dhe name.

Mesazhi është një array i vetëm me çelësa sipas emrave të fushave të API-së; prandaj replyTo dhe scheduledAt mbeten në camelCase, ndërsa idempotencyKey: dhe apiKey: janë argumente me emër të thirrjes dhe kurrë pjesë e mesazhit. Për të ndryshuar një fushë të një mesazhi që e ndërtuat më parë, shpërndajeni në një array të ri: $client->emails->send([...$message, 'subject' => 'Re: your invoice']) ruan çdo fushë tjetër dhe zëvendëson subjektin.

Një array me çelësa sipas emrave camelCase të API-së, ndaj $email['status'] lexon statusin.

translate e shkruan mesazhin në gjuhën e dikujt tjetër para se ai të niset. Trupi, dhe subjekti veç nëse e fikni, përkthehet kur API-ja e pranon kërkesën, dhe ajo që doli është ajo që niset: një përkthim që nuk mund të prodhohej e refuzon dërgimin në vend që ta nisë mesazhin në gjuhën në të cilën e shkruat.

$email = $client->emails->send([    'from' => '[email protected]',    'to' => '[email protected]',    'subject' => 'Your September invoice',    'html' => '<p>Invoice attached. Payment is due on the 14th.</p>',    'translate' => ['to' => 'de'],]); print_r($email['translation'] ?? []);

Atëherë $email['translation'] mban language të barabartë me de, languageName me German, detectedSourceLanguage me en, dhe subject e includeOriginal të dyja true.

Askush nuk e lexoi atë para se të nisej. emails->translate është e njëjta vajtje-ardhje e ndalur një hap më herët. Tregojani një personi, lëreni ta ndryshojë, pastaj dërgoni atë që ai miratoi pa asnjë translate te thirrja. Dhënia e tij sërish do ta përkthente tekstin për herë të dytë dhe do t’i hidhte poshtë redaktimet e tij.

$preview = $client->emails->translate([    'subject' => 'Your September invoice',    'html' => '<p>Invoice attached. Payment is due on the 14th.</p>',    'to' => 'de',]); echo $preview['language']['native'], PHP_EOL, $preview['subject'], PHP_EOL, $preview['html'], PHP_EOL;echo 'Send it as it is? [y/N] '; $answer = fgets(STDIN); if ($answer !== false && strtolower(trim($answer)) === 'y') {    $client->emails->send([        'from' => '[email protected]',        'to' => '[email protected]',        'subject' => $preview['subject'],        'html' => $preview['html'],    ]);}

use OpenEmail\Constants\Languages;use OpenEmail\OpenEmail; echo count(Languages::ALL), PHP_EOL; $current = $client->languages->list();echo count($current), PHP_EOL; echo OpenEmail::resolveLanguage('Deutsch')['code'] ?? 'none', PHP_EOL;echo OpenEmail::resolveLanguage('zh-TW')['code'] ?? 'none', PHP_EOL;echo OpenEmail::languageByCode('DE')['native'] ?? 'none', PHP_EOL;var_dump(OpenEmail::isRtlLanguage('ar'));

Këto rreshta printojnë 200, rreshtat me të cilët vjen ky version, pastaj sa mban API-ja tani, pastaj de, zh-Hant, Deutsch dhe bool(true). Tabela përfshihet në paketë, në rendin e përzgjedhësit, si OpenEmail\Constants\Languages::ALL, një listë array-sh me code, label, native, flag dhe rtl, ndaj një përzgjedhës mund të mbushet para kërkesës së parë. languages->list kthen të njëjtët rreshta nga rrjeti si listë e thjeshtë, për një thirrës që preferon rreshtat aktualë në vend të atyre me të cilët erdhi ky version. OpenEmail::resolveLanguage() merr një kod, një emër në anglisht, një endonim ose një pseudonim (zh-TW është pseudonim i një kodi që nuk listohet më) dhe kthen null kur asgjë nuk përputhet, OpenEmail::languageByCode() përputh një kod të saktë pavarësisht shkronjave të mëdha a të vogla, dhe OpenEmail::isRtlLanguage() tregon nëse një gjuhë lexohet nga e djathta në të majtë, siç ndodh me gjashtëmbëdhjetë nga rreshtat. Kërkoni njëkohësisht te native, label dhe code, tregoni së pari native dhe ruani kodin.

• —Një gjuhë që API-ja nuk mund ta përputhë jep një validation_error te translate.to, para se të dërgohet çfarëdo.
• —translation_too_long mbi 30.000 karaktere, translation_not_configured kur instalimi nuk ka AI të konfiguruar, një 429 ai_quota_exceeded kur hapësira e punës i ka përdorur veprimet e AI-së për sot (rivendoset në mesnatë UTC dhe nuk riprovohet), translation_failed kur ofruesi nuk u përgjigj. Asnjëri prej tyre nuk e dërgon mesazhin të papërkthyer si zgjidhje rezervë.
• —Funksionon me template: ajo që përkthehet është dalja e RENDERUAR, kështu që një trup i vetëm i ruajtur u shërben të gjitha gjuhëve në të cilat lexojnë klientët tuaj. Një template që renderon një dokument të tërë e ruan doctype-in e vet, blloqet e veta <style> dhe rregullat @font-face: te modeli shkon vetëm trupi dhe pjesa tjetër vendoset sërish rreth tij. <title> i tij lihet i paprekur, gjë që nuk e shfaq gjithsesi asgjë.
• —Një riprovim nuk kushton asgjë më shumë. Përkthimi nuk është pjesë e gjurmës së idempotencës (kërkesa është, përfshirë translate), kështu që riprovimi i një dërgimi pa përgjigje me të njëjtin Idempotency-Key riluan mesazhin që ekziston tashmë në vend që të përkthejë e të dërgojë një të dytë.
• —Një mesazh i përkthyer që është në radhë ose i planifikuar e ruan tekstin e miratuar. emails->reschedule e zhvendos ende, ndërsa emails->update e refuzon një tekst të ri me një 409 translation_locked, ndaj ndryshimi i asaj që thotë do të thotë anulim dhe dërgim nga e para.

content është base64 në rrjet. Jepini klientit diçka që mund ta lexojë dhe ai i kodon bajtet për ju: një burim stream-i nga fopen, një SplFileInfo, ose një stream PSR-7 apo skedar i ngarkuar. Një string dërgohet ashtu siç është, ndaj duhet të jetë tashmë base64, që është ajo që bën OpenEmail::toBase64() me bajtet që mbani në memorie.

use OpenEmail\OpenEmail; $attachments = [    ['filename' => 'invoice.pdf', 'content' => OpenEmail::toBase64(file_get_contents('invoice.pdf')), 'contentType' => 'application/pdf'],    ['filename' => 'report.csv', 'content' => new \SplFileInfo('report.csv')],    ['filename' => 'contacts.csv', 'content' => fopen('contacts.csv', 'rb')],    ['fileId' => 'file_6bb640f5b99e47deb758f1f5'],]; $client->emails->send([    'from' => '[email protected]',    'to' => '[email protected]',    'subject' => 'Your documents',    'text' => 'All three are attached.',    'attachments' => $attachments,]);