Envoyer un e-mail

$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 et bcc acceptent un destinataire ou une liste de destinataires, et un destinataire seul est enveloppé pour vous. Chacun peut être une adresse nue, Name <addr@host>, ou un tableau avec email et name.

Le message est un tableau dont les clés sont les noms de champ de l'API, c'est pourquoi replyTo et scheduledAt restent en camelCase, alors que idempotencyKey: et apiKey: sont des arguments nommés de l'appel et ne font jamais partie du message. Pour changer un champ d'un message construit plus tôt, décompressez-le dans un nouveau tableau : $client->emails->send([...$message, 'subject' => 'Re: your invoice']) garde tous les autres champs et remplace l'objet.

Un tableau dont les clés sont les noms camelCase de l'API : $email['status'] lit donc le statut.

translate rédige le message dans la langue de quelqu'un d'autre avant son départ. Le corps, et l'objet sauf si vous le désactivez, est traduit au moment où l'API accepte la requête, et ce qui en est sorti est ce qui part : une traduction qui n'a pas pu être produite fait refuser l'envoi plutôt que d'expédier le message dans la langue où vous l'avez écrit.

$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'] contient alors language à de, languageName à German, detectedSourceLanguage à en, et subject et includeOriginal tous deux à true.

Personne n'a relu ce texte avant son départ. emails->translate est le même aller-retour, arrêté une étape plus tôt. Montrez-le à une personne, laissez-la le modifier, puis envoyez ce qu'elle a approuvé sans aucun translate sur l'appel. Le repasser traduirait une deuxième fois et jetterait ses corrections.

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

Ces lignes affichent 200, le nombre de lignes livrées avec cette version, puis le nombre que l'API contient maintenant, puis de, zh-Hant, Deutsch et bool(true). La table est embarquée, dans l'ordre du sélecteur, sous la forme OpenEmail\Constants\Languages::ALL, une liste de tableaux avec code, label, native, flag et rtl, pour qu'un sélecteur puisse être rempli avant la première requête. languages->list renvoie les mêmes lignes depuis le réseau sous forme de simple liste, pour un appelant qui préfère les lignes actuelles à celles livrées avec cette version. OpenEmail::resolveLanguage() accepte un code, un nom anglais, un endonyme ou un alias (zh-TW est l'alias d'un code qui n'est plus listé) et renvoie null quand rien ne correspond, OpenEmail::languageByCode() trouve un code exact sans tenir compte de la casse, et OpenEmail::isRtlLanguage() indique si une langue s'écrit de droite à gauche, comme c'est le cas de seize des lignes. Cherchez dans native, label et code ensemble, affichez native en premier, et stockez le code.

• —Une langue que l'API ne peut pas identifier donne une validation_error sur translate.to, avant tout envoi.
• —translation_too_long au-delà de 30 000 caractères, translation_not_configured quand l'installation n'a aucune IA configurée, un 429 ai_quota_exceeded quand l'espace de travail a épuisé les actions IA du jour (il se réinitialise à minuit UTC et n'est pas réessayé), translation_failed quand le fournisseur n'a pas répondu. Aucun d'eux n'envoie le message non traduit en guise de repli.
• —Fonctionne avec template : c'est la sortie RENDUE qui est traduite, si bien qu'un seul corps stocké sert toutes les langues que lisent vos clients. Un template qui rend un document entier conserve son doctype, ses blocs <style> et ses règles @font-face : seul le corps part vers le modèle et le reste est remis autour. Son <title> est laissé tel quel, et rien ne l'affiche de toute façon.
• —Une retentative ne coûte rien de plus. La traduction ne fait pas partie de l'empreinte d'idempotence (la requête, elle, en fait partie, translate compris) : réessayer un envoi resté sans réponse avec la même Idempotency-Key rejoue donc le message qui existe déjà au lieu d'en traduire et d'en envoyer un second.
• —Un message traduit qui est en file d'attente ou planifié garde la formulation approuvée. emails->reschedule le déplace toujours, tandis que emails->update refuse une nouvelle formulation avec un 409 translation_locked : changer ce qu'il dit implique donc de l'annuler et de l'envoyer à nouveau.

content est en base64 sur le réseau. Donnez au client quelque chose qu'il peut lire et il encode les octets pour vous : une ressource de flux issue de fopen, un SplFileInfo, ou un flux ou un fichier téléversé PSR-7. Une chaîne est envoyée telle quelle : elle doit donc déjà être en base64, ce que OpenEmail::toBase64() fait des octets que vous avez en mémoire.

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