Oblic

ಸಂಪರ್ಕ ಪಟ್ಟಿಗಳು

ಸಂಪರ್ಕ ಪಟ್ಟಿಗಳನ್ನು ರಚಿಸಿ, ಹುಡುಕಿ ಮತ್ತು ನಿಮ್ಮ ವ್ಯವಸ್ಥೆಗಳು ಸಂಗ್ರಹಿಸುವ ನೋಂದಣಿದಾರರು ಹಾಗೂ ಗ್ರಾಹಕರನ್ನು ಸೇರಿಸಿ, ಇದರಿಂದ Oblic ಅಭಿಯಾನಗಳು ಮತ್ತು ಸ್ವಯಂಚಾಲನೆಗಳು ಅವರನ್ನು ತಲುಪಬಹುದು. ಈ ಮಾರ್ಗಗಳಿಗೆ contacts:manage ಹೊಂದಿರುವ ಕೀ ಅಗತ್ಯವಿದೆ ಮತ್ತು ಅವು ನಿಮ್ಮ ಸಂಸ್ಥೆಯ ಪೂರ್ವನಿಯೋಜಿತ ಕಾರ್ಯಕ್ಷೇತ್ರದಲ್ಲಿ ಕೆಲಸ ಮಾಡುತ್ತವೆ.


POST/external/contact-list/v1/{contactListId}/add

ಪಟ್ಟಿಗೆ ಸಂಪರ್ಕಗಳನ್ನು ಸೇರಿಸುವುದು

ವಿನಂತಿಯ ಬಾಡಿ ಸಂಪರ್ಕಗಳ ಅರೇ ಆಗಿದೆ. ಪ್ರತಿಯೊಂದು ಸಂಪರ್ಕಕ್ಕೂ ಹೆಸರು ಮತ್ತು ಇಮೇಲ್ ವಿಳಾಸ, ಫೋನ್ ಸಂಖ್ಯೆ ಅಥವಾ 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ಯಾವಾಗ
400BAD_REQUEST ಅಥವಾ ಫೀಲ್ಡ್ ಹೆಸರುಅರೇ ಖಾಲಿಯಾಗಿದೆ, ಪುಟೀಕರಣ ಅಮಾನ್ಯವಾಗಿದೆ ಅಥವಾ ಸಂಪರ್ಕದ ಮೌಲ್ಯಮಾಪನ ವಿಫಲವಾಗಿದೆ. ಸಂದೇಶಗಳು ವಿನಂತಿಯ ಭಾಷೆಯನ್ನು ಅವಲಂಬಿಸಿವೆ.
400INVALID_CONTACT_LISTಕಾರ್ಯಕ್ಷೇತ್ರದಲ್ಲಿ ಆ ಐಡಿಯ ಪಟ್ಟಿಯಿಲ್ಲ

ತಿರಸ್ಕಾರವನ್ನು ವರ್ಗೀಕರಿಸಲು ಸಂದೇಶದ ಪದಗಳ ಬದಲು cd ಬಳಸಿ. ಪ್ರತಿಕ್ರಿಯೆಯ ಸ್ವರೂಪಕ್ಕಾಗಿ ದೋಷಗಳು ನೋಡಿ.


GET/external/contact-list/v1/{nextIndex}/{limit}

ಸಂಪರ್ಕ ಪಟ್ಟಿಗಳನ್ನು ನೋಡುವುದು

ಕಾರ್ಯಕ್ಷೇತ್ರದ ಪಟ್ಟಿಗಳು ಹೊಸದರಿಂದ ಹಳೆಯದಕ್ಕೆ, ಒಂದು ಬಾರಿ 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 ಮುಂದಿನ ಪುಟದ ಆರಂಭವನ್ನು ಸೂಚಿಸುತ್ತದೆ.

POST/external/contact-list/v1/add

ಸಂಪರ್ಕ ಪಟ್ಟಿಯನ್ನು ರಚಿಸುವುದು

ಪಟ್ಟಿಯನ್ನು ರಚಿಸುವುದು

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}. ಮೊದಲ ಮಾರ್ಗದಿಂದ ಅದಕ್ಕೆ ಸಂಪರ್ಕಗಳನ್ನು ಸೇರಿಸಿ. ಹಲವು ಪಟ್ಟಿಗಳು ಒಂದೇ ಹೆಸರನ್ನು ಹೊಂದಿರಬಹುದು.

ಈ ಪುಟವು ಸಹಾಯಕವಾಗಿದೆಯೇ?