ಸಂಪರ್ಕ ಪಟ್ಟಿಗಳು
ಸಂಪರ್ಕ ಪಟ್ಟಿಗಳನ್ನು ರಚಿಸಿ, ಹುಡುಕಿ ಮತ್ತು ನಿಮ್ಮ ವ್ಯವಸ್ಥೆಗಳು ಸಂಗ್ರಹಿಸುವ ನೋಂದಣಿದಾರರು ಹಾಗೂ ಗ್ರಾಹಕರನ್ನು ಸೇರಿಸಿ, ಇದರಿಂದ Oblic ಅಭಿಯಾನಗಳು ಮತ್ತು ಸ್ವಯಂಚಾಲನೆಗಳು ಅವರನ್ನು ತಲುಪಬಹುದು. ಈ ಮಾರ್ಗಗಳಿಗೆ contacts:manage ಹೊಂದಿರುವ ಕೀ ಅಗತ್ಯವಿದೆ ಮತ್ತು ಅವು ನಿಮ್ಮ ಸಂಸ್ಥೆಯ ಪೂರ್ವನಿಯೋಜಿತ ಕಾರ್ಯಕ್ಷೇತ್ರದಲ್ಲಿ ಕೆಲಸ ಮಾಡುತ್ತವೆ.
ಪಟ್ಟಿಗೆ ಸಂಪರ್ಕಗಳನ್ನು ಸೇರಿಸುವುದು
ವಿನಂತಿಯ ಬಾಡಿ ಸಂಪರ್ಕಗಳ ಅರೇ ಆಗಿದೆ. ಪ್ರತಿಯೊಂದು ಸಂಪರ್ಕಕ್ಕೂ ಹೆಸರು ಮತ್ತು ಇಮೇಲ್ ವಿಳಾಸ, ಫೋನ್ ಸಂಖ್ಯೆ ಅಥವಾ WhatsApp ಸಂಖ್ಯೆಯಲ್ಲಿ ಕನಿಷ್ಠ ಒಂದು ಅಗತ್ಯ.
- ಹೆಸರು
name- ಟೈಪ್ ಮಾಡಿ
- string
- ವಿವರಣೆ
ಅಗತ್ಯ: ಸಂಪರ್ಕದ ಹೆಸರು; ಇದರಲ್ಲಿ ಅಕ್ಷರಗಳು, ಅಂಕೆಗಳು, ಖಾಲಿ ಜಾಗಗಳು,
',,ಮತ್ತು-ಇರಬಹುದು. A ಇಂದ Z ಹೊರಗಿನ ಅಕ್ಷರಗಳನ್ನು, ಉದಾಹರಣೆಗೆé, ತಿರಸ್ಕರಿಸಲಾಗುತ್ತದೆ.
- ಹೆಸರು
email- ಟೈಪ್ ಮಾಡಿ
- string
- ವಿವರಣೆ
ಸಂಪರ್ಕದ ಇಮೇಲ್ ವಿಳಾಸ.
- ಹೆಸರು
phone- ಟೈಪ್ ಮಾಡಿ
- string
- ವಿವರಣೆ
ದೇಶದ ಕೋಡ್ ಹೊಂದಿರುವ ಮತ್ತು
+ಇಲ್ಲದ ಫೋನ್ ಸಂಖ್ಯೆ; ಕನಿಷ್ಠ 10 ಅಂಕೆಗಳು, ಉದಾಹರಣೆಗೆ919812345678.
- ಹೆಸರು
whatsApp- ಟೈಪ್ ಮಾಡಿ
- string
- ವಿವರಣೆ
ದೇಶದ ಕೋಡ್ ಹೊಂದಿರುವ ಮತ್ತು
+ಇಲ್ಲದ WhatsApp ಸಂಖ್ಯೆ; 10 ರಿಂದ 15 ಅಂಕೆಗಳು.
- ಹೆಸರು
source- ಟೈಪ್ ಮಾಡಿ
- string
- ವಿವರಣೆ
ಸಂಪರ್ಕಗಳು ಬಂದ ಮೂಲ, ಉದಾಹರಣೆಗೆ
Website. ಮೊದಲ ಸಂಪರ್ಕದ ಮೌಲ್ಯವು ವಿನಂತಿಯ ಎಲ್ಲ ಸಂಪರ್ಕಗಳಿಗೆ ಅನ್ವಯಿಸುತ್ತದೆ; ಅದನ್ನು ಬಿಡಿದರೆCustomಬಳಸಲಾಗುತ್ತದೆ.
ಈ ಕರೆ ಪಟ್ಟಿಗೆ ಸೇರಿಸುವ ಪ್ರತಿಯೊಂದು ಸಂಪರ್ಕಕ್ಕೂ ಈ ಪಟ್ಟಿಯ «ಪ್ರೇಕ್ಷಕರ ಗುಂಪಿಗೆ ಸೇರುತ್ತದೆ» ಪ್ರಚೋದಕ ಹೊಂದಿರುವ ಸ್ವಯಂಚಾಲನೆಗಳು ಮತ್ತು ಜರ್ನಿಗಳನ್ನು ಆರಂಭಿಸಲು ?startJourneys=true ಸೇರಿಸಿ. ಅದು ಇಲ್ಲದಿದ್ದರೆ source ಏನೇ ಇದ್ದರೂ ಕರೆ ಯಾವುದನ್ನೂ ಆರಂಭಿಸುವುದಿಲ್ಲ; ನಿಮ್ಮ ವ್ಯವಸ್ಥೆಗಳು ಕಳುಹಿಸುವ ಸಂಪರ್ಕಗಳನ್ನು ಹೊಸ ನೋಂದಣಿಗಳೆಂದು ಪರಿಗಣಿಸಲಾಗುವುದಿಲ್ಲ. ಈಗಾಗಲೇ ಪಟ್ಟಿಯಲ್ಲಿರುವ ಸಂಪರ್ಕ ಯಾವುದನ್ನೂ ಆರಂಭಿಸುವುದಿಲ್ಲ; ಪಟ್ಟಿಯನ್ನು ತೊರೆದು ಮತ್ತೆ ಸೇರಿಸಲಾದ ಸಂಪರ್ಕ ಅವುಗಳನ್ನು ಮರುಪ್ರಾರಂಭಿಸುತ್ತದೆ.
ಎರಡು ಸಂಪರ್ಕಗಳನ್ನು ಸೇರಿಸುವುದು
curl -X POST https://api.oblic.app/external/contact-list/v1/CLT000R7ZM4Q2VXH00/add \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '[
{ "name": "Asha Rao", "email": "asha@example.org", "source": "Website" },
{ "name": "Ravi Kumar", "phone": "919812345678", "whatsApp": "919812345678" }
]'
ಪ್ರತಿಕ್ರಿಯೆ 200 ಆಗಿದ್ದು, data ಮೌಲ್ಯ null ಆಗಿರುತ್ತದೆ. ಇಮೇಲ್ ವಿಳಾಸಗಳನ್ನು ಸಣ್ಣಕ್ಷರಗಳಲ್ಲಿ ಉಳಿಸಲಾಗುತ್ತದೆ.
| ತಿರಸ್ಕಾರ | cd | ಯಾವಾಗ |
|---|---|---|
| 400 | BAD_REQUEST ಅಥವಾ ಫೀಲ್ಡ್ ಹೆಸರು | ಅರೇ ಖಾಲಿಯಾಗಿದೆ, ಪುಟೀಕರಣ ಅಮಾನ್ಯವಾಗಿದೆ ಅಥವಾ ಸಂಪರ್ಕದ ಮೌಲ್ಯಮಾಪನ ವಿಫಲವಾಗಿದೆ. ಸಂದೇಶಗಳು ವಿನಂತಿಯ ಭಾಷೆಯನ್ನು ಅವಲಂಬಿಸಿವೆ. |
| 400 | INVALID_CONTACT_LIST | ಕಾರ್ಯಕ್ಷೇತ್ರದಲ್ಲಿ ಆ ಐಡಿಯ ಪಟ್ಟಿಯಿಲ್ಲ |
ತಿರಸ್ಕಾರವನ್ನು ವರ್ಗೀಕರಿಸಲು ಸಂದೇಶದ ಪದಗಳ ಬದಲು cd ಬಳಸಿ. ಪ್ರತಿಕ್ರಿಯೆಯ ಸ್ವರೂಪಕ್ಕಾಗಿ ದೋಷಗಳು ನೋಡಿ.
ಸಂಪರ್ಕ ಪಟ್ಟಿಗಳನ್ನು ನೋಡುವುದು
ಕಾರ್ಯಕ್ಷೇತ್ರದ ಪಟ್ಟಿಗಳು ಹೊಸದರಿಂದ ಹಳೆಯದಕ್ಕೆ, ಒಂದು ಬಾರಿ limit ಪಟ್ಟಿಗಳಂತೆ ಬರುತ್ತವೆ. ಆರಂಭದ ಸ್ಥಾನ nextIndex ಆಗಿದ್ದು, ಅದರ ಆರಂಭಿಕ ಮೌಲ್ಯ 0 ಆಗಿದೆ. search ಪಠ್ಯವನ್ನು ಹೆಸರಿನಲ್ಲಿ ಹೊಂದಿರುವ ಪಟ್ಟಿಗಳಿಗೆ ಫಲಿತಾಂಶಗಳನ್ನು ಸೀಮಿತಗೊಳಿಸುತ್ತದೆ; ದೊಡ್ಡಕ್ಷರ ಮತ್ತು ಸಣ್ಣಕ್ಷರದ ಭೇದವಿಲ್ಲ. limit ಕನಿಷ್ಠ 1 ಆಗಿರಬೇಕು.
ಮೊದಲ 50 ಪಟ್ಟಿಗಳು
curl -G https://api.oblic.app/external/contact-list/v1/0/50 \
-H 'Authorization: Bearer YOUR_API_KEY' \
-d search=newsletter
ಪ್ರತಿಕ್ರಿಯೆ
{
"status": "success",
"data": {
"contacts": [
{ "id": "CLT000R7ZM4Q2VXH00", "name": "Newsletter", "count": 1284 }
],
"moreIndicator": "N",
"nextIndex": ""
},
"errors": null
}
contactsಪಟ್ಟಿಗಳನ್ನು ಹೊಂದಿರುತ್ತದೆ; ಪ್ರತಿಯೊಂದರ ಸಂಪರ್ಕಗಳ ಸಂಖ್ಯೆcountನಲ್ಲಿರುತ್ತದೆ.- ಇನ್ನಷ್ಟು ಪಟ್ಟಿಗಳು ಉಳಿದಿರುವವರೆಗೆ
moreIndicatorಮೌಲ್ಯYಆಗಿರುತ್ತದೆ ಮತ್ತುnextIndexಮುಂದಿನ ಪುಟದ ಆರಂಭವನ್ನು ಸೂಚಿಸುತ್ತದೆ.
ಸಂಪರ್ಕ ಪಟ್ಟಿಯನ್ನು ರಚಿಸುವುದು
ಪಟ್ಟಿಯನ್ನು ರಚಿಸುವುದು
curl -X POST https://api.oblic.app/external/contact-list/v1/add \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{ "name": "Website sign-ups" }'
ಪ್ರತಿಕ್ರಿಯೆಯಲ್ಲಿ ಹೊಸ ಪಟ್ಟಿ ದೊರೆಯುತ್ತದೆ, {"id": …, "name": "Website sign-ups", "count": 0}. ಮೊದಲ ಮಾರ್ಗದಿಂದ ಅದಕ್ಕೆ ಸಂಪರ್ಕಗಳನ್ನು ಸೇರಿಸಿ. ಹಲವು ಪಟ್ಟಿಗಳು ಒಂದೇ ಹೆಸರನ್ನು ಹೊಂದಿರಬಹುದು.