Brevo डेटा एक्सपोर्ट और माइग्रेशन: अपना डेटा अंदर या बाहर कैसे ले जाएं

“brevo data export migration to another platform” जैसे वाक्यांशों का सर्च वॉल्यूम एक ही चिंता से चलता है: कि जो डेटा आपने जमा किया है, उसे अंदर डालना बाहर निकालने से आसान है. Brevo के लिए ईमानदार जवाब यह है कि उसका ज़्यादातर हिस्सा साफ़-सुथरे तरीक़े से बाहर आ जाता है, कुछ हिस्सा ऐसी शक्ल में आता है जिसे आपको दोबारा बनाना पड़ता है, और एक छोटा लेकिन अहम हिस्सा बिल्कुल भी नहीं जा सकता.

यह गाइड दोनों दिशाएं कवर करती है. इसमें ठीक-ठीक बताया गया है कि क्या एक्सपोर्ट होता है, क्या नहीं, इंटरफ़ेस के लिए बहुत बड़े अकाउंट के वास्ते कौन सी API कॉल हैं, और एक माइग्रेशन चेकलिस्ट जो सप्रेशन लिस्ट और सेंडिंग प्रतिष्ठा को बाद की सोच नहीं, बल्कि पहली प्राथमिकता मानती है.

Brevo से आप असल में क्या एक्सपोर्ट कर सकते हैं

कॉन्टैक्ट और एट्रिब्यूट

इंटरफ़ेस का रास्ता है CRM, फिर Contacts. पूरा डेटाबेस एक्सपोर्ट करने के लिए सुनिश्चित करें कि कोई लिस्ट या सेगमेंट लोड न हो और कोई फ़िल्टर लागू न हो. किसी एक लिस्ट या सेगमेंट को एक्सपोर्ट करने के लिए पहले “Load a list or segment” पर क्लिक करके उसे चुनें.

फिर आप चुनते हैं कि कौन से स्टैंडर्ड और कस्टम एट्रिब्यूट शामिल करने हैं. EMAIL, आख़िरी बदलाव की तारीख़ और बनने की तारीख़ डिफ़ॉल्ट रूप से चुने होते हैं, और बाक़ी आप ख़ुद जोड़ते हैं, और यही वह क़दम है जिसमें लोग सबसे ज़्यादा चूकते हैं. अपना CSV फ़ील्ड सेपरेटर चुनें, सेमीकोलन या कॉमा, और चाहें तो “Send export by email” चालू करें ताकि डाउनलोड लिंक अकाउंट मालिक के पते पर जाए. “Start export” पर क्लिक करें, फिर अपने अकाउंट नाम के बगल वाली नोटिफ़िकेशन घंटी से फ़ाइल डाउनलोड करें.

लिस्ट और सेगमेंट

लिस्ट सदस्यता के रूप में एक्सपोर्ट होती हैं: हर लिस्ट के लिए एक एक्सपोर्ट चलाएं, या एक ही पूर्ण एक्सपोर्ट में _listIds मेटाडेटा शामिल करें और बाद में फ़ाइल बांट लें. GET /v3/contacts/lists आपको लिस्ट के नाम, आईडी और फ़ोल्डर आईडी देता है ताकि आप दूसरी तरफ़ वही संरचना दोबारा बना सकें.

सेगमेंट अलग हैं, और यही पहली असली कमी है. GET /v3/contacts/segments सिर्फ़ id, segmentName, categoryName और updatedAt लौटाता है. जो फ़िल्टर शर्तें किसी सेगमेंट को परिभाषित करती हैं, वे उजागर नहीं होतीं. आप किसी समय-बिंदु पर सेगमेंट के सदस्य एक्सपोर्ट कर सकते हैं, लेकिन जिस नियम ने उन्हें बनाया, उसे स्क्रीन से पढ़कर नए टूल में हाथ से दोबारा बनाना पड़ता है. अकाउंट कैंसल करने से पहले हर सेगमेंट का स्क्रीनशॉट ले लें.

कैम्पेन आंकड़े

कैम्पेन रिपोर्ट से आप डेटा CSV के रूप में एक्सपोर्ट कर सकते हैं, और ईमेल तथा SMS रिपोर्ट साझा करने या छापने के लिए PDF वर्ज़न भी देती हैं. पूरा ऐतिहासिक डेटा खींचने के लिए GET /v3/emailCampaigns एक statistics पैरामीटर स्वीकार करता है जिसकी वैल्यू globalStats, linksStats या statsByDomain हो सकती है, और startDate तथा endDate की जोड़ी दो साल तक की अवधि कवर कर सकती है.

ट्रांज़ैक्शनल लॉग

दो रास्ते, अलग-अलग समय-खिड़कियों के साथ.

GET /v3/smtp/statistics/events टाइप (delivered, opened, clicks, hardBounces, spam, unsubscribed और अन्य) के आधार पर छांटे गए अलग-अलग इवेंट लौटाता है. तारीख़ की सीमा 90 दिन से ज़्यादा नहीं हो सकती, और अगर आप न कोई रेंज दें और न days पैरामीटर, तो यह डिफ़ॉल्ट रूप से पिछले 30 दिन लेता है.

बल्क के लिए, POST /v3/webhooks/export पिछले 7 दिनों के कच्चे इवेंट पर एक एक्सपोर्ट जॉब बनाता है, जो 7 दिन की अवधि में अधिकतम 20 एक्सपोर्ट जॉब तक सीमित है. यह processId लौटाता है, ख़त्म होने पर आपके notify URL को कॉल करता है, और CSV देता है जिसमें date, email, event, message-id, reason, sending_ip, subject, tag और template_id जैसे कॉलम होते हैं. बड़ा वॉल्यूम कई CSV फ़ाइलों के संपीड़ित आर्काइव के रूप में आता है.

व्यावहारिक नतीजा यह है: अगर आपको 90 दिन से ज़्यादा का ट्रांज़ैक्शनल इतिहास चाहिए, तो आपको उसे शुरू से ही नियमित रूप से एक्सपोर्ट करते रहना चाहिए था. वह जॉब अभी सेट करें, उस हफ़्ते नहीं जब आप जाने का फ़ैसला करें.

आपके साथ क्या नहीं आता

यही वह हिस्सा है जिसे ज़्यादातर माइग्रेशन गाइड छोड़ देती हैं.

• ऑटोमेशन वर्कफ़्लो की संरचना. API इवेंट के ज़रिए ऑटोमेशन ट्रिगर कर सकता है, लेकिन ऐसा कोई दस्तावेज़ीकृत एंडपॉइंट नहीं है जो किसी वर्कफ़्लो की शाखाएं, देरियां और शर्तें वापस पढ़ सके. हर वर्कफ़्लो नए प्लेटफ़ॉर्म में हाथ से दोबारा बनता है.
• सेगमेंट फ़िल्टर की परिभाषाएं. जैसा ऊपर कहा, सिर्फ़ नाम और मौजूदा सदस्य ही निकाले जा सकते हैं.
• प्रति कॉन्टैक्ट पूरा एंगेजमेंट इतिहास. एक्सपोर्ट एंडपॉइंट पर customContactFilter इस्तेमाल करके आप किसी ख़ास कैम्पेन के ओपनर, क्लिकर, न खोलने वाले, अनसब्सक्राइबर, हार्ड बाउंस या सॉफ़्ट बाउंस एक्सपोर्ट कर सकते हैं. जो आप नहीं खींच सकते, वह है “इस कॉन्टैक्ट ने अब तक जितने भी ओपन और क्लिक किए” वाली एक साफ़-सुथरी फ़ाइल, क्योंकि कच्चे इवेंट एंडपॉइंट 90 दिन तक सीमित हैं.
• टेम्पलेट रेंडरिंग की सटीकता. htmlContent साफ़ एक्सपोर्ट होता है, लेकिन ड्रैग एंड ड्रॉप ब्लॉक, मर्ज टैग सिंटैक्स और अनसब्सक्राइब लिंक प्लेसहोल्डर प्लेटफ़ॉर्म पर निर्भर होते हैं. आप जो HTML एक्सपोर्ट करते हैं वह शुरुआती बिंदु है, तैयार टेम्पलेट नहीं. नए एडिटर में हर टेम्पलेट दोबारा टेस्ट करने के लिए समय रखें.
• डिलिवरेबिलिटी प्रतिष्ठा. सेंडर प्रतिष्ठा सेंडिंग IP और ऑथेंटिकेट किए गए डोमेन पर रहती है. नया प्लेटफ़ॉर्म, नया IP पूल, नया वॉर्म अप. वही डोमेन और वही DKIM कॉन्फ़िगरेशन रखने से प्रतिष्ठा का डोमेन वाला पक्ष बचा रहता है, जिससे सचमुच मदद मिलती है, लेकिन IP वाला पक्ष साथ नहीं जाता.
• फ़ॉर्म, लैंडिंग पेज और ट्रैकिंग पहचानकर्ता. साइनअप फ़ॉर्म, लैंडिंग पेज और ट्रैकिंग स्क्रिप्ट, सबकी आईडी प्लेटफ़ॉर्म पर निर्भर होती हैं. आपकी साइट पर एम्बेड की गई हर चीज़ बदलनी पड़ेगी, और उन आईडी से जुड़ा कोई भी एनालिटिक्स कटओवर पर टूट जाएगा.

बड़े अकाउंट के लिए स्क्रिप्ट से एक्सपोर्ट

लगभग एक लाख कॉन्टैक्ट से ऊपर इंटरफ़ेस वाला एक्सपोर्ट धीमा और असुविधाजनक हो जाता है, और वैसे भी आपको एक दोहराने योग्य जॉब चाहिए. कॉन्टैक्ट एक्सपोर्ट एंडपॉइंट असिंक्रोनस है: यह एक फ़िल्टर स्वीकार करता है, एक प्रोसेस आईडी लौटाता है, और पूरा होने पर आपको CSV सौंप देता है.

curl --request POST \
  --url https://api.brevo.com/v3/contacts/export \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'api-key: YOUR_API_KEY' \
  --data '{
    "customContactFilter": { "actionForContacts": "allContacts" },
    "exportMandatoryAttributes": true,
    "exportAttributes": ["FIRSTNAME", "LASTNAME", "SMS", "COUNTRY"],
    "exportMetadata": ["_listIds", "ADDED_TIME", "MODIFIED_TIME"],
    "exportSubscriptionStatus": ["email_marketing", "sms_marketing"],
    "exportDateInUTC": true,
    "notifyUrl": "https://example.com/hooks/brevo-export"
  }'

सफल कॉल HTTP 202 और processId वाली बॉडी लौटाती है. exportMandatoryAttributes डिफ़ॉल्ट रूप से true होता है और EMAIL, ADDED_TIME तथा MODIFIED_TIME कवर करता है, इसलिए exportAttributes वह जगह है जहां आप अपने कस्टम फ़ील्ड नाम से बताते हैं. exportSubscriptionStatus सेट करने से ही ईमेल और SMS की मार्केटिंग ऑप्ट इन स्थिति फ़ाइल में आती है, और इसे छोड़ देना ऐसा एक्सपोर्ट बनाने का सबसे आम तरीक़ा है जो अनुपालन वाले माइग्रेशन के लिए बेकार होता है.

अगर आप किसी जॉब का इंतज़ार करने के बजाय रिकॉर्ड पर पेजिंग करना चाहें, तो GET /v3/contacts offset के साथ 1000 तक limit स्वीकार करता है, साथ ही इन्क्रीमेंटल पुल के लिए modifiedSince और createdSince भी. हर कॉन्टैक्ट के साथ emailBlacklisted, smsBlacklisted, listIds, listUnsubscribed और consentGroups वापस आते हैं, जो सहमति की स्थिति दोबारा बनाने के लिए ज़रूरी सब कुछ है.

इसकी स्क्रिप्ट लिखते समय रेट लिमिट पर नज़र रखें. स्टैंडर्ड प्लान पर कॉन्टैक्ट एंडपॉइंट 36,000 रिक्वेस्ट प्रति घंटे और 10 प्रति सेकंड की इजाज़त देते हैं, जो Professional और Enterprise टियर पर दोगुनी हो जाती हैं, जबकि बाक़ी ज़्यादातर एंडपॉइंट 100 रिक्वेस्ट प्रति घंटे पर बैठते हैं. दस लाख कॉन्टैक्ट को 1000 प्रति पेज के हिसाब से पेज करना 1000 रिक्वेस्ट है, जो कॉन्टैक्ट बजट के भीतर आराम से आ जाता है, लेकिन लूप में कैम्पेन या टेम्पलेट एंडपॉइंट पीटना उस बजट में नहीं आता.

आपकी सप्रेशन लिस्ट सबसे पहले क्यों माइग्रेट होनी चाहिए

बाक़ी कुछ भी हटाने से पहले ऑप्ट आउट हटाएं.

क़ानूनी तर्क सीधा है. जिस कॉन्टैक्ट ने अनसब्सक्राइब किया, उसने आपके ब्रांड से सहमति वापस ली. वेंडर बदलने से वह वापसी रीसेट नहीं होती. GDPR के तहत सहमति और उसकी वापसी का रिकॉर्ड नियंत्रक के रूप में आपकी ज़िम्मेदारी है, और CAN-SPAM के तहत ऑप्ट आउट का पालन दस कार्यदिवस के भीतर होना चाहिए और अनिश्चित काल तक बना रहता है. माइग्रेशन में वह लिस्ट खो देना कोई तकनीकी दुर्घटना नहीं है, यह अनुपालन की विफलता है जिसका काग़ज़ी सबूत आपकी ओर इशारा करता है.

व्यवहार में डिलिवरेबिलिटी वाला तर्क और भी बुरा है. सप्रेस किए गए पते असमान रूप से उन लोगों के होते हैं जिन्होंने शिकायत की, जिनका हार्ड बाउंस हुआ, या जो सचमुच बाहर निकलना चाहते थे. बिना किसी प्रतिष्ठा वाले बिल्कुल नए IP से उन्हें मेल करना नए सेंडिंग सेटअप को पहले ही हफ़्ते में थ्रॉटल या ब्लॉक करवाने का सबसे जाना-माना तरीक़ा है. कुछ हज़ार पुनर्चक्रित स्पैम ट्रैप और शिकायतकर्ता एक महीने की सावधान वॉर्म अप मेहनत पर पानी फेर सकते हैं.

इसलिए यह उम्मीद करने के बजाय कि वे अपने आप शामिल हो जाएंगे, सप्रेस किए गए समूहों को स्पष्ट रूप से एक्सपोर्ट करें. एक्सपोर्ट एंडपॉइंट पर actionForContacts किसी भी तरीक़े से ब्लॉकलिस्ट किए गए कॉन्टैक्ट के लिए unsubscribed और किसी एक ख़ास लिस्ट से ऑप्ट आउट किए कॉन्टैक्ट के लिए unsubscribedPerList स्वीकार करता है. प्रति कैम्पेन hardBounces के लिए एक अलग पास चलाएं. नए प्लेटफ़ॉर्म में जाते समय उस फ़ाइल को मेल भेजने योग्य लिस्ट में नहीं, उसकी सप्रेशन लिस्ट में इम्पोर्ट करें.

Brevo उल्टा मामला भी संभालता है: यह ब्लॉकलिस्ट किए गए कॉन्टैक्ट की लिस्ट इम्पोर्ट करने का समर्थन करता है, और इम्पोर्ट API emailBlacklist तथा smsBlacklist बूलियन लेता है ताकि इम्पोर्ट की गई फ़ाइल सप्रेस के रूप में उतरे. उस असंतुलन पर ध्यान दें जिसे लागू करना Brevo के लिए सही है: कॉन्टैक्ट को थोक में ब्लॉकलिस्ट से नहीं हटाया जा सकता, क्योंकि जिसने अकेला छोड़ देने को कहा हो उसे थोक में दोबारा सब्सक्राइब करना ग़ैरक़ानूनी होगा. सप्रेशन जोड़ना आसान है और हटाना जानबूझकर मुश्किल. इसे रुकावट नहीं, सही व्यवहार मानें.

माइग्रेशन चेकलिस्ट, Brevo से बाहर

1. ऑडिट करें. कॉन्टैक्ट, लिस्ट, सेगमेंट, सक्रिय ऑटोमेशन, टेम्पलेट और इंटीग्रेशन गिनें. लिख लें कि कौन से इंटीग्रेशन Brevo में लिखते हैं, क्योंकि वही पाइप आपको दोबारा जोड़ने होंगे.
2. एक्सपोर्ट करें. सभी एट्रिब्यूट और सब्सक्रिप्शन स्थिति के साथ कॉन्टैक्ट, प्रति लिस्ट एक फ़ाइल या _listIds ढोने वाली एक ही फ़ाइल, अलग फ़ाइलों के रूप में सप्रेशन समूह, कैम्पेन आंकड़े, 90 दिन की खिड़की जितना पीछे तक जा सके उतने ट्रांज़ैक्शनल इवेंट, और टेम्पलेट HTML.
3. जो समाप्त हो जाता है उसे संग्रहित करें. समय से बंधी हर चीज़ (कच्चे इवेंट, लॉग) खिड़की सरकते ही चली जाती है. उसे अभी अपने वेयरहाउस या ऑब्जेक्ट स्टोरेज में रखें.
4. साफ़ करें और मैप करें. डुप्लिकेट हटाएं, तारीख़ और फ़ोन के फ़ॉर्मैट सामान्य करें, और नए प्लेटफ़ॉर्म के लिए कॉलम से फ़ील्ड की स्पष्ट मैपिंग लिखें. यही वह स्वाभाविक मौक़ा भी है जब उन पतों को हटा दिया जाए जिन्होंने साल भर में कोई प्रतिक्रिया नहीं दी, जो बेकार बोझ को वॉर्म अप कराने के लिए भुगतान करने से सस्ता है. हमारी ईमेल लिस्ट सफ़ाई गाइड में सीमाएं दी गई हैं.
5. सप्रेशन पहले लोड करें. ऑप्ट आउट और हार्ड बाउंस नए प्लेटफ़ॉर्म की सप्रेशन लिस्ट में इम्पोर्ट करें, जांचें कि गिनती आपके एक्सपोर्ट से मेल खाती है, और उसके बाद ही मेल भेजने योग्य कॉन्टैक्ट लोड करें.
6. वॉर्म अप करें. अपने सबसे सक्रिय सेगमेंट से शुरू करें, वॉल्यूम धीरे-धीरे बढ़ाएं, और बाउंस तथा शिकायत दर पर रोज़ नज़र रखें. हमारी ईमेल डिलिवरेबिलिटी गाइड में यह क्रम विस्तार से है.
7. समानांतर चलाएं. Brevo को चालू रखें और अपना अहम ट्रांज़ैक्शनल मेल उसी से भेजते रहें, जबकि नया प्लेटफ़ॉर्म मार्केटिंग सेंड का बढ़ता हुआ हिस्सा संभाले. दोनों एक साथ न पलटें.
8. सत्यापित करें. कॉन्टैक्ट की गिनती मिलाएं, बीस कॉन्टैक्ट को फ़ील्ड दर फ़ील्ड जांचें, टेस्ट सेंड की कोशिश करके पुष्टि करें कि सप्रेस किए गए कॉन्टैक्ट सचमुच सप्रेस हैं, और एक हफ़्ते के सेंड वॉल्यूम की तुलना पुराने प्लेटफ़ॉर्म से करें.
9. कटओवर करें और रोलबैक रखें. DNS और इंटीग्रेशन एंडपॉइंट ऐसे समय में बदलें जब कोई देख रहा हो. कटओवर के बाद कम से कम एक पूरे बिलिंग चक्र तक Brevo अकाउंट चालू और भुगतान किया हुआ रखें, और एक्सपोर्ट की गई फ़ाइलें दोनों प्लेटफ़ॉर्म के बाहर संग्रहित रखें. आपकी असली रोलबैक योजना वही है, किसी वेंडर का वादा नहीं.

किसी दूसरे प्लेटफ़ॉर्म से Brevo में माइग्रेट करना

यही चेकलिस्ट उल्टी दिशा में चलती है, तीन Brevo से जुड़ी बातों के साथ.

मौजूदा वेंडर से असली एक्सपोर्ट लें. ज़्यादातर प्लेटफ़ॉर्म आपको कॉन्टैक्ट और उनके कस्टम फ़ील्ड CSV के रूप में दे देंगे. सप्रेशन लिस्ट और बाउंस लिस्ट ख़ास तौर पर मांगें, जो अक्सर अलग एक्सपोर्ट में होती हैं और लोग उन्हें मांगना भूल जाते हैं. अगर आप प्रति कॉन्टैक्ट प्राइसिंग मॉडल से आ रहे हैं, तो हमारी Brevo प्राइसिंग गाइड के साथ तुलना करें कि आने पर आप असल में कितना चुकाएंगे.

अपलोड से पहले फ़ील्ड मैप करें. Brevo के एट्रिब्यूट के टाइप होते हैं (टेक्स्ट, नंबर, तारीख़, बूलियन, कैटेगरी), और टेक्स्ट एट्रिब्यूट में उतरी तारीख़ बाद में फ़िल्टर करने लायक नहीं रहेगी. पहले सही टाइप के साथ एट्रिब्यूट बनाएं, फिर इम्पोर्ट करें.

किसी भी बड़े काम के लिए API से इम्पोर्ट करें. POST /v3/contacts/import fileBody में इनलाइन CSV, jsonBody में JSON ऐरे, दोनों लगभग 10 MB तक सीमित, या fileUrl के ज़रिए रिमोट फ़ाइल स्वीकार करता है, साथ ही listIds या एक newList ऑब्जेक्ट भी. updateExistingContacts डिफ़ॉल्ट रूप से true होता है और ईमेल पर मिलान करता है. अपनी सप्रेशन फ़ाइल के लिए emailBlacklist को true रखकर एक इम्पोर्ट चलाएं, फिर मेल भेजने योग्य कॉन्टैक्ट के लिए दूसरा इम्पोर्ट. पूरी चलती हुई स्क्रिप्ट हमारी गाइड स्क्रिप्ट से Brevo में CSV कॉन्टैक्ट इम्पोर्ट करना में हैं.

फिर वह सब दोबारा बनाएं जो ट्रांसफ़र नहीं हुआ: ऑटोमेशन, सेगमेंट, फ़ॉर्म और टेम्पलेट. किसी असली व्यक्ति को भेजने से पहले मुट्ठी भर इनबॉक्स प्रोवाइडर को सीड टेस्ट भेजें.

अगले माइग्रेशन को खाई न बनने दें

प्लेटफ़ॉर्म माइग्रेशन खाई जैसा इसलिए लगता है क्योंकि प्लेटफ़ॉर्म ही रिकॉर्ड का सिस्टम बन चुका होता है. ऑर्डर इतिहास, सब्सक्राइबर की स्थिति और कैम्पेन के नतीजे एक ही वेंडर के भीतर रहते हैं, और उन्हें हटाने का मतलब पलायन होता है.

इसका विकल्प यह है कि सत्य का अपना स्रोत रखें और सेंडिंग प्लेटफ़ॉर्म को तिजोरी नहीं, गंतव्य बनने दें. अगर आपका स्टोर डेटा, सहमति की स्थिति और एंगेजमेंट इवेंट लगातार आपके अपने सिस्टम में सिंक होते रहें, तो चैनल बदलना या जोड़ना एक प्रोजेक्ट नहीं, बस एक कॉन्फ़िगरेशन बदलाव रह जाता है. यही काम Tajo Brevo और किसी मर्चेंट के स्टैक के बीच करता है: डेटा को दोनों दिशाओं में बहता रखना ताकि प्लेटफ़ॉर्म कभी इकलौती प्रति न हो.

जो भी हो, ऊपर बताए गए एक्सपोर्ट जॉब अभी नियमित रूप से चलाने लायक हैं, चाहे आप जाने की योजना बना रहे हों या नहीं. सबसे सस्ता माइग्रेशन वही है जिसमें फ़ैसला लेते समय डेटा पहले से प्लेटफ़ॉर्म के बाहर मौजूद हो.