Apple Messages में इमेज और फ़ाइलें भेजें

किसी खुली ग्राहक बातचीत में प्रोडक्ट इमेज, निर्देश या रसीद भेजने के लिए Image या Document टेम्पलेट का उपयोग करें। मैसेज प्रोसेसिंग के दौरान Bird स्रोत फ़ाइल को फ़ेच करता है और उसे Apple के लिए तैयार करता है।

फ़ेच की जा सकने वाली फ़ाइल तैयार करें

भेजी जाने वाली फ़ाइल को ऐसे सार्वजनिक HTTPS URL पर होस्ट करें जिसे ब्राउज़र कुकीज़ या साइन-इन के बिना फ़ेच किया जा सके। इसी काम के लिए बनाई गई ऐसी फ़ाइल का उपयोग करें जिसे उस URL पर सार्वजनिक करना सुरक्षित हो। किसी निजी ड्राइव का प्रीव्यू पेज सीधा फ़ाइल URL नहीं होता।

मैसेज भेजने का संदर्भ मीडिया से जुड़ी सीमाएँ तय करता है:

प्रोसेसिंग पूरी होने तक URL उपलब्ध रखें। अगर साइन किया गया URL बहुत जल्दी समाप्त हो जाता है, तो संदेश स्वीकार होने के बाद भी विफल हो सकता है। साइन-इन किए बिना ब्राउज़र में URL का परीक्षण करें और पुष्टि करें कि वह HTML पेज के बजाय असली फ़ाइल लौटाता है।

टेम्पलेट कॉन्फ़िगर करें

1. Templates खोलें और New template > Image या Document चुनें।
2. Content में ड्राफ़्ट को एक Template name दें और एक उपयोगी Message लिखें जो अटैचमेंट के बारे में बताए।
3. Apple delivery में Attachment URL, File name और Media type सेट करें। उदाहरण के लिए, PDF के लिए .pdf फ़ाइल नाम और application/pdf का उपयोग होता है।
4. Personalization में व्यवसाय चुनें, फिर ड्राफ़्ट सेव करें।
5. भेजने से पहले असली ग्राहक और फ़ाइल की जाँच करते हुए संदेश तैयार करें और उसकी समीक्षा करें।

बंडल किया गया प्रीव्यू आर्टवर्क असली संदेश भेजने के लिए अटैचमेंट का स्रोत नहीं है। अपना इच्छित URL स्पष्ट रूप से दें।

एक बार अपलोड करें और attachment_id से दोबारा उपयोग करें

ऊपर दिया गया टेम्पलेट प्रवाह हर बार source_url से भेजता है, इसलिए Bird हर भेजने पर फ़ाइल को फिर से फ़ेच करता है। जब आप इसके बजाय API से भेजते हैं, तो आप अटैचमेंट अपलोड करें से फ़ाइल एक बार अपलोड कर सकते हैं और बाद में भेजे जाने वाले संदेशों में उसका दोबारा उपयोग कर सकते हैं, जिससे फ़ाइल को फिर से फ़ेच नहीं करना पड़ता।

POST /v1/amb/attachments को एक ऐसी वर्कस्पेस API कुंजी के साथ कॉल करें जिसके पास amb:write हो, एक Idempotency-Key हेडर, जिसे अनुरोध में देना अनिवार्य है, और एक बॉडी जिसमें from (भेजने वाले बिज़नेस की Apple Business ID) हो, साथ ही या तो 25,000,000 बाइट तक का एक file भाग, या 99,999,999 बाइट तक का एक source_url हो। प्रतिक्रिया में aat_ से शुरू होने वाला एक id मिलता है। हर कॉल एक नया अटैचमेंट अपलोड करता है, भले ही आपने वही फ़ाइल पहले अपलोड की हो। उसी Idempotency-Key के साथ दोबारा कॉल करने पर दोबारा अपलोड किए बिना पहला ही परिणाम मिलता है, इसलिए हर फ़ाइल के लिए जिसे आप अपलोड करना चाहते हैं, एक नई कुंजी का उपयोग करें। बाद में भेजते समय, source_url की जगह उस ID को content.attachments[].attachment_id में सेट करें। प्राप्त किए गए अटैचमेंट में भी उसी तरह की ID होती है: इसे amb.received वेबहुक इवेंट में data.message.content.attachments[].attachment_id से पढ़ें, और फ़ाइल को खुद डाउनलोड और दोबारा अपलोड किए बिना उसे ग्राहक को वापस भेज दें।

किसी अटैचमेंट पर expires_at, Bird का अनुमान है कि Apple फ़ाइल को कब तक रखेगा, यह कोई गारंटी नहीं है: Apple लगभग 30 दिनों की उपलब्धता बताता है, जो हर बार तब नवीनीकृत होती है जब बाद का कोई संदेश उस संदर्भ का दोबारा उपयोग करता है। जिस attachment_id का expires_at 24 घंटे से भी कम समय में आ रहा है, उसके साथ भेजा गया संदेश Apple तक पहुँचने से पहले ही अस्वीकार कर दिया जाता है; ऐसा होने पर फ़ाइल फिर से अपलोड करें, या उसे source_url से भेजें। टेम्पलेट attachment_id संग्रहीत नहीं कर सकता, क्योंकि टेम्पलेट लंबे समय तक रहता है और अटैचमेंट ID नहीं।

परिणाम जाँचें

सबमिट किए गए संदेश और उसके इवेंट जांचें, फिर किसी अधिकृत Apple टेस्ट डिवाइस पर अटैचमेंट खोलें। देखें कि सामग्री साफ़ पढ़ी जा सकती है, फ़ाइल का नाम सही है, और आसपास की वेबसाइट के बिना भी सामग्री समझ में आती है।

अगर संदेश स्वीकार होने के बाद विफल होता है, तो टेम्पलेट बदलने से पहले उसकी त्रुटि जांचें। आम कारणों में ऐसा URL जिस तक पहुंचा नहीं जा सकता, अप्रत्याशित मीडिया टाइप, आकार सीमा से बड़ी फ़ाइल या अमान्य PNG डेटा शामिल हैं। फ़ाइल का एक्सटेंशन बदलने से उसका फ़ॉर्मैट नहीं बदलता।

डैशबोर्ड में आने वाला अटैचमेंट डाउनलोड करने के लिए, बातचीत के ट्रांसक्रिप्ट में उसका फ़ाइल नाम चुनें। इसके लिए वर्कस्पेस में Apple Messages का पढ़ने का एक्सेस चाहिए।

API के ज़रिए फ़ाइल पाने के लिए, संदेश के content.attachments[] में मौजूद attachment_id के साथ अटैचमेंट डाउनलोड करें का उपयोग करें, या amb.received वेबहुक इवेंट के data.message.id और उस संदेश के content.attachments ऐरे में अटैचमेंट की शून्य-आधारित स्थिति के साथ मैसेज अटैचमेंट प्राप्त करें का उपयोग करें। दोनों ही तरीकों में, एक ऐसी वर्कस्पेस API कुंजी से प्रमाणित करें जिसके पास amb:read हो; प्रतिक्रिया में डिक्रिप्ट की गई फ़ाइल बाइट्स होती हैं। संदेश आने पर फ़ाइल डाउनलोड करके उसकी अपनी कॉपी रखें, क्योंकि Apple की रिटेंशन अवधि के बाद उपलब्धता की कोई गारंटी नहीं है।