प्रमाणन
बेरर टोकन के रूप में एक API कुंजी भेजें। कुंजी के पास livechat.manage अनुमति होनी चाहिए; इसके बिना एक कुंजी को 404 के बजाय 403 के साथ अस्वीकार कर दिया जाता है।
जहां आपकी संगठन आईडी आती है
यह एंडपॉइंट JSON बॉडी में एक फ़ील्ड के रूप में org_id लेता है।
आपकी ऑर्गनाइजेशन आईडी आपके डैशबोर्ड पर एपीआई कीज़ स्क्रीन पर, की के ठीक बगल में मौजूद है। यह आपके द्वारा की जाने वाली हर कॉल में समान आईडी होती है।
इसे आज़माएँ
कोणार्कित ब्रैकेट्स में दी गई किसी भी चीज़ को अपने मानों से बदलें, और की प्लेसहोलर को अपने डैशबोर्ड की एक की से बदलें।
curl -X POST https://api.zinndigital.com/v1/chat/widgets \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "name": <string> }'साइन इन हैं? आपके डैशबोर्ड में मौजूद API कंसोल आपकी वास्तविक संगठन आईडी और आपकी अपनी कुंजी स्वतः भर देता है, और लाइव API के विरुद्ध अनुरोध चलाता है ताकि आप वास्तविक प्रतिक्रिया देख सकें। इस एंडपॉइंट को API कंसोल में खोलें
विवरण
Requires `livechat.manage`. The new widget is created **switched off**: a chat window that starts talking to a customer's visitors before they have asked for one is a consent problem, not a feature.
अनुरोध बॉडी
| नाम | प्रकार | आवश्यक | यह क्या है |
|---|---|---|---|
org_id | string | नहीं | — |
site_id | string | नहीं | — |
name | string | हाँ | — |
team_name | string | नहीं | — |
allowed_origins | string[] | नहीं | — |
प्रतिक्रिया
| नाम | प्रकार | आवश्यक | यह क्या है |
|---|---|---|---|
id | string | हाँ | — |
site_id | string | हाँ | — |
name | string | हाँ | — |
public_key | string | हाँ | — |
enabled | boolean | हाँ | Whether the chat renders. Created FALSE always: the plugin ships in the deploy footprint of every WordPress site we host, so a widget may exist for a customer who never asked fo… |
allowed_origins | string[] | हाँ | Origins the widget may be embedded on. An EMPTY list refuses every page rather than allowing any — this is the only control stopping somebody else's site opening conversations a… |
tier | string | हाँ | — |
greeting | string | हाँ | — |
team_name | string | हाँ | — |
accent_colour | string | हाँ | — |
position | string<left, right> | हाँ | — |
hide_branding | boolean | हाँ | — |
ai_enabled | boolean | हाँ | — |
offline_email | string | हाँ | — |
business_hours | object | नहीं | — |
open_now | boolean | हाँ | — |
ai_allowance | ChatAiAllowance | हाँ | — |
limits | object | हाँ | — |
premium_extra_code | string | हाँ | The catalogue code to buy for the premium tier. |
त्रुटियाँ जो यह एंडपॉइंट लौटा सकता है
401 · 403 · 422