Enviar um 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 e bcc aceitam um destinatário ou uma lista deles, e um único é envolvido automaticamente. Cada um pode ser um endereço simples, Name <addr@host> ou um array com email e name.

A mensagem é um único array com as chaves dos nomes de campo da API, e é por isso que replyTo e scheduledAt continuam em camelCase, enquanto idempotencyKey: e apiKey: são argumentos nomeados da chamada e nunca fazem parte da mensagem. Para alterar um campo de uma mensagem que construiu antes, espalhe-a num novo array: $client->emails->send([...$message, 'subject' => 'Re: your invoice']) mantém todos os outros campos e substitui o assunto.

Um array com as chaves dos nomes em camelCase da API, por isso $email['status'] lê o estado.

translate escreve a mensagem na língua de outra pessoa antes de ela partir. O corpo, e o assunto a menos que o desative, é traduzido quando a API aceita o pedido, e o que saiu é o que vai sair: uma tradução que não pôde ser produzida recusa o envio em vez de o publicar na língua em que o escreveu.

$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'] contém então language igual a de, languageName igual a German, detectedSourceLanguage igual a en, e subject e includeOriginal ambos true.

Ninguém leu aquilo antes de partir. emails->translate é a mesma ida e volta parada um passo antes. Mostre-a a uma pessoa, deixe-a alterá-la e depois envie o que ela aprovou sem qualquer translate na chamada. Passá-lo outra vez traduziria uma segunda vez e deitaria fora as edições dela.

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

Essas linhas de código imprimem 200, o número de linhas com que esta versão vem, depois quantas a API tem agora, e depois de, zh-Hant, Deutsch e bool(true). A tabela vem incluída, pela ordem do seletor, como OpenEmail\Constants\Languages::ALL, uma lista de arrays com code, label, native, flag e rtl, para que um seletor possa ser preenchido antes do primeiro pedido. languages->list devolve as mesmas linhas vindas da rede sob a forma de uma lista simples, para quem prefira as atuais às que esta versão trouxe. OpenEmail::resolveLanguage() aceita um código, um nome em inglês, um endónimo ou um alias (zh-TW é um alias de um código que já não é listado) e devolve null quando nada corresponde, OpenEmail::languageByCode() faz corresponder um código exato sem distinguir maiúsculas de minúsculas, e OpenEmail::isRtlLanguage() indica se uma língua se lê da direita para a esquerda, como acontece com dezasseis das linhas. Pesquise native, label e code em conjunto, mostre native primeiro e guarde o código.

• —Um idioma que a API não consegue identificar é um validation_error em translate.to, antes de seja o que for ser enviado.
• —translation_too_long acima de 30 000 caracteres, translation_not_configured quando a instalação não tem IA configurada, um 429 ai_quota_exceeded quando o espaço de trabalho já gastou as ações de IA de hoje (é reposta à meia-noite UTC e não é repetido), translation_failed quando o fornecedor não respondeu. Nenhum deles envia a mensagem por traduzir como alternativa.
• —Funciona com template: é o resultado RENDERIZADO que é traduzido, por isso um corpo guardado serve todas as línguas em que os seus clientes leem. Um template que renderiza um documento inteiro mantém o seu doctype, os seus blocos <style> e as suas regras @font-face: só o corpo vai para o modelo e o resto é reposto à volta dele. O seu <title> fica intacto, e nada o mostra de qualquer forma.
• —Uma repetição não custa nada a mais. A tradução não faz parte da impressão digital de idempotência (o pedido faz, translate incluído), por isso repetir um envio sem resposta com a mesma Idempotency-Key reproduz a mensagem que já existe em vez de traduzir e enviar uma segunda.
• —Uma mensagem traduzida que esteja em fila ou agendada mantém o texto aprovado. emails->reschedule continua a movê-la, enquanto emails->update recusa um texto novo com um 409 translation_locked, por isso mudar o que diz significa cancelar e enviar de novo.

content segue em base64 pela rede. Dê ao cliente algo que ele consiga ler e ele codifica os bytes por si: um recurso de stream de fopen, um SplFileInfo, ou um stream PSR-7 ou ficheiro carregado. Uma string é enviada tal como está, por isso tem de já estar em base64, que é o que OpenEmail::toBase64() faz dos bytes que tem em memória.

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