Отправка письма

$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 и bcc принимают одного получателя или список получателей, а одиночный оборачивается за вас. Каждый может быть голым адресом, Name <addr@host> или массивом с email и name.

Сообщение представляет собой один массив с ключами по именам полей API, поэтому replyTo и scheduledAt остаются в camelCase, тогда как idempotencyKey: и apiKey: являются именованными аргументами вызова и никогда не входят в сообщение. Чтобы изменить одно поле в сообщении, собранном ранее, распакуйте его в новый массив: $client->emails->send([...$message, 'subject' => 'Re: your invoice']) сохраняет все остальные поля и заменяет тему.

Массив с ключами по именам API в camelCase, поэтому $email['status'] читает статус.

translate пишет сообщение на чужом языке перед его уходом. Тело, а также тема, если вы это не отключите, переводятся в момент приёма запроса, и что получилось, то и уходит: перевод, который не удалось получить, отклоняет отправку, а не отправляет письмо на том языке, на котором вы его написали.

$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'] содержит language, равный de, languageName, равный German, detectedSourceLanguage, равный en, а subject и includeOriginal оба равны true.

Никто не прочитал этот текст до отправки. emails->translate проходит тот же путь, но останавливается на шаг раньше. Покажите результат человеку, дайте ему внести правки, затем отправьте одобренное вообще без translate в вызове. Повторная передача переведёт текст ещё раз и отбросит его правки.

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

Эти строки печатают 200, число строк, с которыми поставляется эта версия, затем сколько их сейчас в API, затем de, zh-Hant, Deutsch и bool(true). Таблица встроена в пакет в порядке списка выбора как OpenEmail\Constants\Languages::ALL, список массивов с code, label, native, flag и rtl, поэтому список выбора можно заполнить до первого запроса. languages->list возвращает те же строки по сети как обычный список для тех, кому нужны текущие строки, а не те, с которыми вышла эта версия. OpenEmail::resolveLanguage() принимает код, английское название, самоназвание или псевдоним (zh-TW является псевдонимом кода, которого больше нет в списке) и возвращает null, если ничего не совпало, OpenEmail::languageByCode() ищет точное совпадение кода без учёта регистра, а OpenEmail::isRtlLanguage() сообщает, пишется ли язык справа налево, как шестнадцать из этих строк. Ищите по native, label и code вместе, показывайте сначала native и сохраняйте код.

• —Язык, который API не может распознать, даёт validation_error для translate.to ещё до отправки.
• —translation_too_long при объёме свыше 30 000 символов, translation_not_configured, когда в установке не настроен ИИ, 429 ai_quota_exceeded, когда рабочее пространство израсходовало действия ИИ на сегодня (лимит сбрасывается в полночь по UTC, и повтор не выполняется), translation_failed, когда провайдер не ответил. Ни в одном из этих случаев сообщение не отправляется без перевода в качестве запасного варианта.
• —Работает с template: переводится ОТРИСОВАННЫЙ результат, так что одно сохранённое тело обслуживает все языки, на которых читают ваши клиенты. Шаблон, отрисовывающий целый документ, сохраняет свой doctype, блоки <style> и правила @font-face: к модели уходит только тело, а остальное возвращается вокруг него. Его <title> остаётся нетронутым, поскольку его всё равно нигде не показывают.
• —Повтор не стоит ничего сверху. Перевод не входит в отпечаток идемпотентности (в него входит запрос, включая translate), так что повтор неотвеченной отправки с тем же Idempotency-Key воспроизводит уже существующее сообщение, а не переводит и отправляет второе.
• —Переведённое сообщение в очереди или в расписании сохраняет одобренный текст. emails->reschedule по-прежнему переносит его, а emails->update отклоняет новый текст с 409 translation_locked, поэтому, чтобы изменить содержание, придётся отменить отправку и отправить заново.

content передаётся по сети в base64. Дайте клиенту то, что он может прочитать, и он закодирует байты за вас: ресурс потока из fopen, SplFileInfo либо поток PSR-7 или загруженный файл. Строка отправляется как есть, поэтому уже должна быть в base64, а именно это OpenEmail::toBase64() делает из байтов, которые у вас в памяти.

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