ईमेल भेजें

from openemail import openemail email = openemail.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': pdf_bytes}],    'threadId': 'thread_…',    'scheduledAt': 'PT1H',    'tags': {'order': '4021'},    'tracking': {'opens': True, 'clicks': True},})

to, cc और bcc एक प्राप्तकर्ता लेते हैं या कई, और अकेले को आपके लिए लपेट दिया जाता है। हर एक सादा पता हो सकता है, Name <addr@host>, या {'email': ..., 'name': ...}।

translate संदेश को जाने से पहले किसी और की भाषा में लिख देता है। body, और जब तक आप उसे बंद न करें तब तक विषय भी, तब अनूदित होता है जब API रिक्वेस्ट स्वीकार करता है, और जो निकला वही बाहर जाता है: जो अनुवाद बन ही नहीं सका, वह संदेश को आपकी लिखी भाषा में भेजने के बजाय send को अस्वीकार कर देता है।

from openemail import openemail email = openemail.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(email.get('translation'))

जाने से पहले उसे किसी ने पढ़ा ही नहीं। emails.translate वही चक्कर है, बस एक क़दम पहले रोक दिया गया। इसे किसी व्यक्ति को दिखाएँ, उसे बदलने दें, फिर जो उसने मंज़ूर किया वही भेजें, कॉल पर translate बिल्कुल लगाए बिना। दोबारा उसे पास करना दूसरी बार अनुवाद कर देता और उनके संपादन फेंक देता।

from openemail import openemail preview = openemail.emails.translate({    'subject': 'Your September invoice',    'html': '<p>Invoice attached. Payment is due on the 14th.</p>',    'to': 'de',}) print(preview['language']['native'], preview['detectedSourceLanguage'])print(preview['html']) approved_subject = input(f"Subject [{preview['subject']}]: ") or preview['subject'] or '' openemail.emails.send({    'from': '[email protected]',    'to': '[email protected]',    'subject': approved_subject,    'html': preview['html'] or '',})

from openemail import LANGUAGES, is_rtl_language, language_by_code, openemail, resolve_language current = openemail.languages.list() german = resolve_language('Deutsch')traditional = resolve_language('zh-TW')upper = language_by_code('DE') assert len(LANGUAGES) == 200assert german is not None and german['code'] == 'de'assert traditional is not None and traditional['code'] == 'zh-Hant'assert upper is not None and upper['native'] == 'Deutsch'assert is_rtl_language('ar')

तालिका picker के क्रम में बंडल की गई है, ताकि पहले अनुरोध से पहले ही picker भरा जा सके। languages.list() तार से आई उन्हीं पंक्तियों को एक सादी list के रूप में लौटाता है, उस कॉलर के लिए जो इस वर्शन के साथ आई पंक्तियों के बजाय मौजूदा पंक्तियाँ चाहता हो। resolve_language कोई कोड, अंग्रेज़ी नाम, स्वनाम या उपनाम लेता है (zh-TW अब सूचीबद्ध न रहे एक कोड का उपनाम है), language_by_code किसी सटीक कोड से केस की परवाह किए बिना मिलान करता है, और सोलह पंक्तियाँ दाएँ से बाएँ हैं। native, label और code को एक साथ खोजें, native पहले दिखाएँ, और कोड संग्रहित करें।

• —जो भाषा किसी पर हल नहीं होती वह कुछ भी भेजे जाने से पहले translate.to पर validation_error है।
• —30,000 वर्ण से ऊपर translation_too_long, जब install में कोई AI कॉन्फ़िगर न हो तब translation_not_configured, जब workspace ने आज की AI क्रियाएँ इस्तेमाल कर ली हों तब 429 ai_quota_exceeded (यह UTC की आधी रात को रीसेट होता है और इसे दोबारा नहीं आज़माया जाता), और जब provider ने उत्तर न दिया हो तब translation_failed। इनमें से कोई भी fallback के तौर पर संदेश बिना अनुवाद के नहीं भेजता।
• —template के साथ काम करता है: अनुवाद render किए गए आउटपुट का होता है, इसलिए एक संग्रहित body आपके ग्राहकों की हर पढ़ी जाने वाली भाषा में काम आता है। पूरा दस्तावेज़ render करने वाला template अपना doctype, अपने <style> ब्लॉक और अपने @font-face नियम बनाए रखता है: model के पास केवल body जाता है और बाक़ी सब उसके चारों ओर वापस रख दिया जाता है। उसका <title> अछूता छोड़ दिया जाता है, जिसे वैसे भी कुछ नहीं दिखाता।
• —retry का कोई अतिरिक्त ख़र्च नहीं। अनुवाद idempotency fingerprint का हिस्सा नहीं है (रिक्वेस्ट है, translate सहित), इसलिए बिना उत्तर वाले send को उसी Idempotency-Key के साथ दोबारा भेजना पहले से मौजूद संदेश को दोहरा देता है, दूसरी बार अनुवाद करके भेजता नहीं।
• —जो अनूदित संदेश queued या scheduled है, उसके शब्द बदले नहीं जा सकते। emails.reschedule अब भी उसे खिसका सकता है; उसमें लिखी बात बदलने का मतलब है उसे रद्द करके दोबारा भेजना।

तार पर content base64 होता है। आप bytes दें और वे आपके लिए encode कर दिए जाते हैं।

from pathlib import Path from openemail.types import AttachmentInput attachments: list[AttachmentInput] = [    {        'filename': 'invoice.pdf',        'content': Path('invoice.pdf').read_bytes(),        'contentType': 'application/pdf',    },]

• emails.send()पूरा रेफ़रेंस
• emails.translate()पूरा रेफ़रेंस
• languages.list()पूरा रेफ़रेंस