Eine E-Mail senden

$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 und bcc nehmen einen Empfänger oder eine Liste von Empfängern entgegen, und ein einzelner wird für Sie verpackt. Jeder darf eine bloße Adresse, Name <addr@host> oder ein Array mit email und name sein.

Die Nachricht ist ein Array mit den Feldnamen der API als Schlüsseln, deshalb bleiben replyTo und scheduledAt in camelCase, während idempotencyKey: und apiKey: benannte Argumente des Aufrufs und nie Teil der Nachricht sind. Um ein Feld einer Nachricht zu ändern, die Sie zuvor gebaut haben, entpacken Sie sie in ein neues Array: $client->emails->send([...$message, 'subject' => 'Re: your invoice']) behält jedes andere Feld und ersetzt den Betreff.

Ein Array mit den camelCase-Namen der API als Schlüsseln, $email['status'] liest also den Status.

translate verfasst die Nachricht vor dem Versand in der Sprache eines anderen. Der Body und, sofern Sie das nicht abschalten, der Betreff werden übersetzt, sobald die API die Anfrage annimmt, und was dabei herauskam, geht hinaus: Eine Übersetzung, die nicht erzeugt werden konnte, lässt den Versand scheitern, statt die Nachricht in der Sprache zu verschicken, in der Sie sie geschrieben haben.

$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'] ?? []);

$email['translation'] enthält dann language mit de, languageName mit German, detectedSourceLanguage mit en sowie subject und includeOriginal, beide true.

Niemand hat das gelesen, bevor es hinausging. emails->translate ist derselbe Weg, einen Schritt früher angehalten. Zeigen Sie das Ergebnis einer Person, lassen Sie sie es ändern und senden Sie dann das Freigegebene ganz ohne translate am Aufruf. Es erneut zu übergeben würde ein zweites Mal übersetzen und ihre Änderungen verwerfen.

$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'));

Diese Zeilen geben 200 aus, die Zeilen, mit denen diese Version ausgeliefert wird, dann die Anzahl, die die API jetzt hält, dann de, zh-Hant, Deutsch und bool(true). Die Tabelle ist in der Reihenfolge des Auswahlfelds als OpenEmail\Constants\Languages::ALL mitgeliefert, eine Liste von Arrays mit code, label, native, flag und rtl, ein Auswahlfeld lässt sich daher schon vor der ersten Anfrage füllen. languages->list gibt dieselben Zeilen von der Leitung als einfache Liste zurück, für Aufrufer, denen die aktuellen lieber sind als die, mit denen diese Version ausgeliefert wurde. OpenEmail::resolveLanguage() nimmt einen Code, einen englischen Namen, ein Endonym oder einen Alias entgegen (zh-TW ist ein Alias eines nicht mehr gelisteten Codes) und gibt null zurück, wenn nichts passt, OpenEmail::languageByCode() trifft einen exakten Code ohne Beachtung der Groß- und Kleinschreibung, und OpenEmail::isRtlLanguage() sagt, ob eine Sprache von rechts nach links läuft, wie es sechzehn der Zeilen tun. Durchsuchen Sie native, label und code gemeinsam, zeigen Sie native zuerst und speichern Sie den Code.

• —Eine Sprache, die die API nicht zuordnen kann, ergibt einen validation_error auf translate.to, bevor irgendetwas gesendet wird.
• —translation_too_long bei über 30.000 Zeichen, translation_not_configured, wenn für die Installation keine KI konfiguriert ist, ein 429 ai_quota_exceeded, wenn der Workspace die KI-Aktionen für heute verbraucht hat (es wird um Mitternacht UTC zurückgesetzt und nicht erneut versucht), translation_failed, wenn der Anbieter nicht geantwortet hat. Keiner dieser Fälle sendet die Nachricht ersatzweise unübersetzt.
• —Funktioniert mit template: Übersetzt wird die GERENDERTE Ausgabe, ein gespeicherter Body bedient daher jede Sprache, in der Ihre Kunden lesen. Ein Template, das ein ganzes Dokument rendert, behält seinen doctype, seine <style>-Blöcke und seine @font-face-Regeln: Nur der Body geht an das Modell, der Rest wird wieder darum gelegt. Sein <title> bleibt unangetastet, was ohnehin nirgends angezeigt wird.
• —Eine Wiederholung kostet nichts zusätzlich. Die Übersetzung ist nicht Teil des Idempotenz-Fingerabdrucks (die Anfrage schon, translate eingeschlossen), eine Wiederholung eines unbeantworteten Versands mit demselben Idempotency-Key spielt daher die bereits existierende Nachricht erneut ab, statt ein zweites Mal zu übersetzen und zu senden.
• —Eine übersetzte Nachricht, die queued oder scheduled ist, behält ihren freigegebenen Wortlaut. emails->reschedule verschiebt sie weiterhin, während emails->update einen neuen Wortlaut mit einem 409 translation_locked ablehnt. Ihren Inhalt zu ändern bedeutet also, abzubrechen und erneut zu senden.

content ist auf der Leitung base64. Geben Sie dem Client etwas, das er lesen kann, dann kodiert er die Bytes für Sie: eine Stream-Ressource aus fopen, eine SplFileInfo oder einen PSR-7-Stream oder eine hochgeladene Datei. Ein String wird so gesendet, wie er ist, er muss also bereits base64 sein, und genau das macht OpenEmail::toBase64() aus Bytes, die Sie im Speicher halten.

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,]);