Sign inGet started

संपर्क

संपर्कों को डैशबोर्ड में संपर्क > सभी संपर्क में, टर्मिनल से bird contacts के साथ, संपर्क API के ज़रिए, या उपलब्ध SDKs में से किसी के साथ प्रबंधित करें।

संपर्कों तक पहुँचना

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

संपर्क पेज

संपर्क पेज संपर्क का नाम, पहचानकर्ता, ऑडियंस सदस्यता और बनाए जाने की जानकारी दिखाता है। नाम, ईमेल या फ़ोन से खोजें, फिर संपर्क खोलने के लिए उसकी पंक्ति चुनें। एक संपर्क जोड़ने या कई संपर्क इम्पोर्ट करने के लिए हेडर में मौजूद कार्रवाइयों का इस्तेमाल करें। देखने के लिए email_marketing की पढ़ने की अनुमति चाहिए। जोड़ने, संपादित करने और हटाने के लिए लिखने की अनुमति चाहिए।
डैशबोर्ड का संपर्क पेज, जिसमें सहेजे गए संपर्क ईमेल, नाम, बाहरी ID और बनाने की तारीख के साथ सूचीबद्ध हैं। साथ में खोज और प्रॉपर्टी, इम्पोर्ट व संपर्क जोड़ें बटन हैं

संपर्क में क्या सहेजा जाता है

हर संपर्क में ईमेल पता, फ़ोन नंबर या दोनों होते हैं। इनमें से प्रत्येक आपके वर्कस्पेस में अनन्य होता है। साथ में वैकल्पिक रूप से नाम और उसके लिए आपका अपना पहचानकर्ता भी हो सकता है:
फ़ील्डविवरण
emailपता, जो आपके वर्कस्पेस में अनन्य होता है। हम शुरुआत और अंत की खाली जगहें हटाकर और अक्षरों को लोअरकेस में बदलकर इसे सहेजते हैं, इसलिए Sam@Acme.com और sam@acme.com सामान्यीकृत होकर एक ही पहचानकर्ता बनते हैं।
phone_numberफ़ोन नंबर, जो आपके वर्कस्पेस में अनन्य होता है। फ़ॉर्मैट को अंतरराष्ट्रीय रूप में सामान्यीकृत किया जाता है। सहेजने से नंबरिंग-प्लान मेटाडेटा, स्वामित्व, संपर्क तक पहुँच पाने या सहमति का सत्यापन नहीं होता।
first_nameवैकल्पिक पहला नाम, जिसका इस्तेमाल भेजे जाने वाले संदेश को वैयक्तिकृत करने में होता है।
last_nameवैकल्पिक उपनाम।
external_idवैकल्पिक। व्यक्ति के लिए आपकी अपनी प्राइमरी की (आपके डेटाबेस का यूज़र ID), जो सेट होने पर आपके वर्कस्पेस में अनन्य होती है। इससे आप ईमेल पर निर्भर हुए बिना संपर्क का अपने रिकॉर्ड से मिलान करते हैं।
dataकस्टम प्रॉपर्टी के मान, हर पंजीकृत संपर्क प्रॉपर्टी के लिए एक मान।
डैशबोर्ड मौजूद पहचानकर्ताओं से ईमेल और SMS लेबल बनाता है। API में email और phone_number मिलते हैं; इसमें channels फ़ील्ड नहीं मिलता। इन लेबल से भेजने की अनुमति या चैनल पर संपर्क तक पहुँच पाने की पुष्टि नहीं होती।
हर संपर्क में con_ प्रीफ़िक्स वाला ID और उसे बनाने व अपडेट करने के टाइमस्टैम्प भी होते हैं। फ़ील्ड का पूरा अनुबंध API संदर्भ में है।

संपर्क प्रॉपर्टी

संपर्क प्रॉपर्टी, संपर्क के कस्टम फ़ील्ड के प्रकार निर्धारित करने वाला स्कीमा हैं। अपने वर्कस्पेस के लिए प्रॉपर्टी पंजीकृत करें। इसके बाद हर संपर्क में data के अंतर्गत उसका मान हो सकता है। स्कीमा पहले से घोषित करने से वैयक्तिकरण और सेगमेंटेशन भरोसेमंद होते हैं: मान हमेशा आपके घोषित प्रकार में आता है, इसलिए टेम्पलेट या फ़िल्टर उस पर भरोसा कर सकता है।
डैशबोर्ड का संपर्क प्रॉपर्टी पेज, जिसमें छह प्रॉपर्टी उनकी की, प्रकार, फ़ॉलबैक मान और बनाने की तारीख के साथ सूचीबद्ध हैं। इनमें से एक पर आर्काइव किया गया बैज है
इन्हें संपर्क > संपर्क प्रॉपर्टी में प्रबंधित करें। हर प्रॉपर्टी में एक की, एक प्रकार और वैकल्पिक फ़ॉलबैक होता है:
  • की वह नाम है जिससे आप मान का संदर्भ देते हैं, जैसे plan_tier। यह लोअरकेस में होनी चाहिए और अक्षर से शुरू होनी चाहिए (^[a-z][a-z0-9_]*$)। बनने के बाद इसे बदला नहीं जा सकता।
  • प्रकार string, number, boolean, या datetime में से एक होता है और बनने के बाद इसे भी बदला नहीं जा सकता। datetime में स्पष्ट ऑफ़सेट वाला RFC 3339 टाइमस्टैम्प देना होता है, जैसे 2026-01-15T11:30:00+02:00। हम इसे सेकंड की परिशुद्धता के साथ UTC में सामान्यीकृत करते हैं, इसलिए यह मान 2026-01-15T09:30:00Z के रूप में सहेजा और लौटाया जाता है। बिना समय के केवल तारीख अस्वीकार की जाती है। डैशबोर्ड में इनके लेबल टेक्स्ट, संख्या, सही / गलत और तारीख व समय हैं।
  • फ़ॉलबैक मान उस संपर्क को पढ़ने पर मिलता है जिसका अपना मान नहीं है। इसलिए plan_tier मौजूद न होने पर खाली मान की जगह free मिल सकता है।
प्रॉपर्टी हटाने के बजाय आर्काइव की जाती हैं। आर्काइव करने से उस की पर नए मान लिखना बंद हो जाता है, लेकिन पहले से सहेजे सभी मान बने रहते हैं। की आरक्षित रहती है, इसलिए उसे कभी किसी दूसरे प्रकार में दोबारा इस्तेमाल नहीं किया जा सकता। उसे वापस सक्रिय करने के लिए अनआर्काइव करें। की आरक्षित रहने के कारण ही प्रकार भी अपरिवर्तनीय है: सहेजे गए number को कभी string की तरह नहीं पढ़ा जाना चाहिए। एक वर्कस्पेस में अधिकतम 200 प्रॉपर्टी पंजीकृत की जा सकती हैं। आर्काइव की गई प्रॉपर्टी भी इस सीमा में गिनी जाती हैं, क्योंकि उनकी की अब भी आरक्षित हैं।
जहाँ भी आप संपर्क संपादित करते हैं, वहाँ प्रॉपर्टी के मान सेट करें। डैशबोर्ड के संपर्क फ़ॉर्म में हर सक्रिय प्रॉपर्टी के लिए उसके प्रकार के अनुसार एक इनपुट दिखता है। CLI और API में भी data के अंतर्गत वही की दी जाती हैं।

संपर्क इम्पोर्ट करना और सिंक करना

संपर्क पेज से सूची इम्पोर्ट करने के लिए इम्पोर्ट चुनें और CSV, TSV या Excel फ़ाइल अपलोड करें। हर पंक्ति में एक संपर्क रखें और कॉलम के नाम वाली एक हेडर पंक्ति जोड़ें। एक फ़ाइल में अधिकतम 50,000 संपर्क हो सकते हैं। CSV फ़ाइलें अधिकतम 50 MB और स्प्रेडशीट फ़ाइलें अधिकतम 10 MB की हो सकती हैं।
हेडर पंक्ति हर संपर्क फ़ील्ड की पहचान करने में मदद करती है। "Email Address", "E-Mail", या "Correo electrónico" नाम वाले सभी कॉलम ईमेल फ़ील्ड से मैप होते हैं। एक ही कॉलम में पूरा नाम होने पर उसे पहले नाम और उपनाम में बाँटा जाता है। यदि दो कॉलम एक ही फ़ील्ड भर सकते हैं, तो वह कॉलम चुना जाता है जिसके मान उसके नाम की पुष्टि करते हैं। हर कॉलम अपने कुछ मान दिखाता है, ताकि आप उसकी सामग्री देख सकें। बाँटे जा रहे नाम के साथ वह मूल मान भी दिखता है जिससे वह लिया गया है। हर कॉलम के ड्रॉपडाउन से आप इनमें बदलाव कर सकते हैं। उसी इम्पोर्ट के हिस्से के रूप में फ़ाइल के सभी लोगों को एक या अधिक ऑडियंस में जोड़ा जा सकता है।
हर पंक्ति के पहचानकर्ताओं से मौजूदा संपर्क का मिलान करके उसे अपडेट किया जाता है, या नया होने पर संपर्क बनाया जाता है। इसलिए वही फ़ाइल दोबारा इम्पोर्ट करने पर डुप्लिकेट बनाने के बजाय अपसर्ट होता है। कुछ भी लिखे जाने से पहले डैशबोर्ड बताता है कि शुरुआती पंक्तियों में से कितनी मौजूदा मैपिंग के साथ इम्पोर्ट नहीं की जा सकतीं। प्रक्रिया के बाद हर छोड़ी गई पंक्ति के साथ उसकी स्रोत पंक्ति संख्या और त्रुटि दी जाती है।
अपने डेटाबेस से सिंक करने के लिए CLI की स्क्रिप्ट लिखें या बैच एंडपॉइंट को कॉल करें। bird contacts create <email> एक संपर्क जोड़ता है। bird contacts batch एक कॉल में अधिकतम 1,000 संपर्क अपसर्ट करता है। अपनी संपर्क सूची को अपने सिस्टम के साथ सिंक रखने के लिए हर व्यक्ति के लिए अलग अनुरोध भेजने के बजाय हर रन में एक बैच इस्तेमाल करें।
const contact = await bird.contacts.create({
  email: "jane@acme.com",
  first_name: "Jane",
});
console.log(contact.id); // "con_…"
हर बैच एंट्री का उसके दिए पहचानकर्ताओं (ईमेल पता, फ़ोन नंबर या बाहरी ID) से अपने आप मिलान होता है। वैकल्पिक match_on फ़ील्ड देने पर मिलान केवल उस एक पहचानकर्ता से होता है। एंट्री कस्टम प्रॉपर्टी के मान भी सेट कर सकती है और audience_ids के ज़रिए अनुरोध के हर संपर्क को सीधे ऑडियंस में जोड़ सकती है। हर एंट्री अलग-अलग सफल या विफल होती है, और प्रतिक्रिया में जमा करने के क्रम में हर एंट्री का एक परिणाम मिलता है:
कोड उदाहरण
{
  "data": [
    {
      "contact_id": "con_01ky7q5t51echr7mqj5c08423b",
      "entry": { "email": "alex@example.com", "phone_number": null, "external_id": null },
      "matched_on": "email",
      "status": "updated"
    },
    {
      "contact_id": "con_01ky7q6mxdfhe86c9dqyt866pz",
      "entry": { "email": "jamie@example.com", "phone_number": null, "external_id": null },
      "matched_on": null,
      "status": "created"
    },
    {
      "contact_id": "con_01ky7q7rv9e9pt4vkr0w0gxq5e",
      "entry": { "email": "casey@example.com", "phone_number": null, "external_id": "user_2214" },
      "matched_on": "external_id",
      "status": "updated"
    }
  ]
}
यदि एंट्री के पहचानकर्ता अलग-अलग मौजूदा संपर्कों की ओर संकेत करते हैं, तो एंट्री कॉन्फ़्लिक्ट के साथ विफल होती है और उसकी समीक्षा करनी होती है। फिर से प्रयास करने से पहले स्रोत रिकॉर्ड ठीक करें; बैच उन संपर्कों को मर्ज नहीं करता।
सिंक के लिए दो डिफ़ॉल्ट व्यवहार उपयोगी हैं। बैच data में दी गई की को मौजूदा संपर्क डेटा में मर्ज करता है, इसलिए एक एट्रिब्यूट बदलने वाला इम्पोर्ट बाकी एट्रिब्यूट नहीं मिटाता। एक की साफ़ करने के लिए null मान भेजें, या पूरा मैप ओवरराइट करने के लिए data_mode: "replace" सेट करें। हर संपर्क पर अपना external_id सेट करें, ताकि ईमेल बदलने के बाद भी अगला सिंक उसी व्यक्ति को ढूँढ़ सके। बैच के उदाहरण में user_2214 पहले से मौजूद है, इसलिए एंट्री उसी संपर्क से मेल खाती है और उसकी जगह नया ईमेल लिख देती है।

संपर्क हटाना

संपर्क हटाना स्थायी है: रिकॉर्ड और उसकी ऑडियंस सदस्यताएँ मिट जाती हैं और उन्हें वापस नहीं लाया जा सकता। हालाँकि, सप्रेशन और प्राथमिकताएँ नहीं बदलतीं। संपर्क हटाने के बाद भी हार्ड बाउंस वाला पता आपकी सप्रेशन सूची में रहता है, और अनसब्सक्राइब करने वाले पते की ऑप्ट-आउट प्राथमिकता बनी रहती है। इसलिए किसी को हटाने से वह चुपचाप फिर से ईमेल पाने के योग्य नहीं बन जाता।

अगले चरण

  • ऑडियंस: संपर्कों को दोबारा इस्तेमाल की जा सकने वाली सूचियों में व्यवस्थित करें
  • सप्रेशन: वर्कस्पेस में उन पतों की सूची जिन पर हम डिलीवरी नहीं करते; यह आपके संपर्कों से अलग रखी जाती है
  • बैच में भेजना: एक कॉल में कई प्राप्तकर्ताओं तक पहुँचना, प्रति अनुरोध अधिकतम 100 संदेश
  • CLI: bird कमांड से संपर्कों, प्रॉपर्टी और ऑडियंस के लिए स्क्रिप्ट लिखना
  • API संदर्भ: अनुरोध और प्रतिक्रिया के पूरे स्कीमा

संबंधित संसाधन

इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।

अभ्यास करें और इम्प्लीमेंटेशन ब्रीफ़ पाएँ