డాక్యుమెంటేషన్

యాప్‌లు & ఇంటిగ్రేషన్‌లు

మీ టీమ్ ఇప్పటికే వాడుతున్న సాధనాలను కనెక్ట్ చేయండి — Stripe, Shopify, Mailchimp, MailerLite, Jira, Tracio. ఇన్‌స్టాల్ చేసిన యాప్‌లు ఇన్‌బాక్స్ సంభాషణ ప్యానెల్‌లో, చాట్ పక్కనే, లైవ్ కస్టమర్ డేటాను కార్డులుగా చూపిస్తాయి.

అవలోకనం#

యాప్ మార్కెట్‌ప్లేస్ Settings → Apps లో ఉంటుంది. యాప్‌లు ఒక్కసారి, మొత్తం వర్క్‌స్పేస్ కోసం ఇన్‌స్టాల్ అవుతాయి: అడ్మిన్ వర్క్‌స్పేస్ సొంత క్రెడెన్షియల్స్‌తో సర్వీస్‌ను కనెక్ట్ చేస్తారు, ఇన్‌బాక్స్ యాక్సెస్ ఉన్న ప్రతి టీమ్ సభ్యుడు ఆ కార్డును సంభాషణ ప్యానెల్‌లో చూస్తారు. ఆపరేటర్లు తామే ఏమీ ఇన్‌స్టాల్ చేయరు — AI ఏజెంట్లు కూడా ఏమీ ఇన్‌స్టాల్ చేయవు.

వర్క్‌స్పేస్ స్థాయి ఇన్‌స్టాల్

వర్క్‌స్పేస్‌కు ఒకే సెట్ క్రెడెన్షియల్స్. యాప్‌ను ఇన్‌స్టాల్ చేయడం, సవరించడం, తీసివేయడం అందరిపైనా ఒకేసారి ప్రభావం చూపుతాయి.

ఇన్‌బాక్స్‌లో కార్డులు

ఇన్‌స్టాల్ చేసిన ప్రతి యాప్ సంభాషణ ప్యానెల్‌లో మీరు మాట్లాడుతున్న వ్యక్తి గురించి లైవ్ డేటాతో ఒక కార్డును గీస్తుంది.

ఫిల్లర్ లేదు

కేటలాగ్‌లో ఉన్న ప్రతిదీ ఈరోజే ఇన్‌స్టాల్ చేయవచ్చు — "త్వరలో వస్తుంది" సెక్షన్ లేదు. ఏ సర్వీస్ లోపించిందో మాకు చెప్పడానికి ఒక రిక్వెస్ట్ టైల్ ఉంది.

యాప్‌ల నిర్వహణకు Install and configure apps అనుమతి అవసరం (Owner, Admin పాత్రల్లో డిఫాల్ట్‌గా ఉంటుంది; కస్టమ్ పాత్రలకు ఇవ్వవచ్చు). అది లేని టీమ్ సభ్యులు కూడా సంభాషణల్లో యాప్ కార్డులను చూస్తారు — వారు ఇన్‌స్టాల్ లేదా రీకాన్ఫిగర్ మాత్రం చేయలేరు.

యాప్ కేటలాగ్#

ఈరోజు ఆరు యాప్‌లు అందుబాటులో ఉన్నాయి:

యాప్కేటగిరీసంభాషణలో ఆపరేటర్లు ఏమి చూస్తారు
Stripeపేమెంట్లుమీరు మాట్లాడుతున్న వ్యక్తి సబ్‌స్క్రిప్షన్, ఇటీవలి పేమెంట్లు
Shopifyకామర్స్పేమెంట్, ఫుల్‌ఫిల్‌మెంట్ స్టేటస్‌తో ఇటీవలి ఆర్డర్లు
Mailchimpమార్కెటింగ్మీరు మాట్లాడుతున్న వ్యక్తి సబ్‌స్క్రిప్షన్ స్టేటస్, ఆడియన్స్, ట్యాగ్‌లు
MailerLiteమార్కెటింగ్మీరు మాట్లాడుతున్న వ్యక్తి సబ్‌స్క్రిప్షన్ స్టేటస్, గ్రూప్‌లు, సైన్అప్ తేదీ
Jiraఇష్యూ ట్రాకింగ్ఈ సంభాషణకు లింక్ అయిన ఇష్యూలు, మరొకటి సృష్టించడానికి ఒక్క క్లిక్
Tracioభద్రతమనిషా లేక బాట్: చాట్-విడ్జెట్ సందర్శకుడిపై Tracio తీర్పు

మీ సొంత బ్యాక్-ఆఫీస్‌కి సాదా లింక్ కావాలా? దానికి ఖాతా, టోకెన్ అవసరం లేదు కాబట్టి అది యాప్ కేటలాగ్‌లో కాకుండా Settings → General → Links to your systems లో ఉంటుంది.

యాప్ ఇన్‌స్టాల్ చేయడం#

Settings → Apps తెరిచి, ఒక టైల్ ఎంచుకుని, యాప్ అడిగే క్రెడెన్షియల్స్ నింపండి. ప్రతి ఫీల్డ్ ఆ విలువను సృష్టించే లేదా కనుగొనే వెండర్ డాష్‌బోర్డ్‌లోని ఖచ్చితమైన పేజీకి లింక్ చేస్తుంది.

దశవివరణ
1. ప్రివ్యూ చూడండిమీరు ఏదైనా పేస్ట్ చేసే ముందు, కాన్ఫిగరేషన్ పేజీ మీ ఆపరేటర్లు చూడబోయే కార్డు నమూనాను చూపిస్తుంది — కల్పిత డేటాతో నిర్మించి — క్రెడెన్షియల్ నిల్వ కాకముందే మీరు వర్క్‌స్పేస్‌తో ఏమి పంచుకుంటున్నారో తెలుస్తుంది.
2. క్రెడెన్షియల్స్ నమోదుAPI కీ లేదా టోకెన్ పేస్ట్ చేయండి. విలువలు ఆటోమేటిక్‌గా ట్రిమ్ అవుతాయి — కాపీ-పేస్ట్‌లో వచ్చిన చివరి స్పేస్ లేదా న్యూలైన్ ఇన్‌స్టాల్‌ను విరగ్గొట్టదు.
3. సేవ్ & టెస్ట్సేవ్ చేయడం కాన్ఫిగరేషన్‌ను నిల్వ చేస్తుంది; కనెక్షన్ టెస్ట్ వెండర్‌కి నిజమైన కాల్ చేస్తుంది — స్టేటస్ చిప్‌ను పచ్చగా మార్చేది అదే.

ప్రతి యాప్ టైల్‌పై ఇన్‌స్టాలేషన్ ఎక్కడ ఉందో చెప్పే స్టేటస్ చిప్ ఉంటుంది:

స్టేటస్అర్థం
Not testedక్రెడెన్షియల్స్ నిల్వ అయ్యాయి, కానీ యాప్ ఇంకా నిజమైన రిక్వెస్ట్‌కు జవాబివ్వలేదు.
Connectedవెండర్ నిజంగా జవాబిచ్చారు — కనెక్షన్ కేవలం సేవ్ కాలేదు, ధ్రువీకరించబడింది.
Needs attentionనిల్వ అయిన క్రెడెన్షియల్స్‌ను వెండర్ తిరస్కరించారు (రద్దయిన లేదా గడువు ముగిసిన కీ). అడ్మిన్ యాప్‌ను సేవ్ లేదా రీ-టెస్ట్ చేసేవరకు కార్డులు వెండర్‌ను కాల్ చేయడం ఆపేస్తాయి.
Errorవేరే ఏదో విఫలమైంది — టూల్‌టిప్ చూడండి.
Disabledఅడ్మిన్ యాప్‌ను ఆఫ్ చేశారు. క్రెడెన్షియల్స్ తొలగించబడకుండానే కార్డు ఇన్‌బాక్స్ నుంచి మాయమవుతుంది.

క్రెడెన్షియల్స్ & భద్రత#

యాప్ క్రెడెన్షియల్స్ వర్క్‌స్పేస్‌కు చెందుతాయి; కొన్ని నియమాలు వాటిని సురక్షితంగా ఉంచుతాయి:

  • నిల్వలో ఎన్‌క్రిప్ట్ చేయబడతాయి. రహస్య ఫీల్డ్‌లు (API కీలు, టోకెన్లు) స్టోరేజ్‌లో కీ-వారీగా ఎన్‌క్రిప్ట్ అవుతాయి, సేవ్ చేశాక తిరిగి ఎప్పుడూ చూపబడవు.
  • వెండర్ అనుమతించిన చోట కనీస హక్కులు. Stripe‌ను Customers, Subscriptions, Charges, Invoices చదవగలిగే పరిమిత కీతో కనెక్ట్ చేయాలి — సంభాషణ నుంచి రీఫండ్ చేయాలంటే మాత్రమే Refunds రైట్ యాక్సెస్ కలపండి. ఫుల్-యాక్సెస్ కీ పేస్ట్ చేసినా పనిచేస్తుంది, కానీ సెట్టింగ్‌ల పేజీ దాన్ని మార్చమని సలహా ఇస్తుంది.
  • గమ్యాన్ని మారిస్తే రహస్యం మళ్లీ అడుగుతుంది. క్రెడెన్షియల్ బైండ్ అయిన ఫీల్డ్‌ను — Shopify స్టోర్ డొమైన్, Jira సైట్ URL — సవరించాలంటే టోకెన్ మళ్లీ నమోదు చేయాలి; అలా సేవ్ అయిన క్రెడెన్షియల్ ఉద్దేశించని హోస్ట్‌కు ఎప్పుడూ మళ్లించబడదు.
  • రద్దు మొత్తం వర్క్‌స్పేస్‌పై ప్రభావం చూపుతుంది. ఒక్కో యాప్‌కు ఒక్కో వర్క్‌స్పేస్‌లో ఒకే ఇన్‌స్టాలేషన్ ఉంటుంది: వెండర్ దగ్గర కీని రొటేట్ లేదా రద్దు చేస్తే, అడ్మిన్ Settings → Apps లో అప్‌డేట్ చేసేవరకు ప్రతి టీమ్ సభ్యుడి కార్డు పనిచేయడం ఆగిపోతుంది.

ఇన్‌బాక్స్‌లో యాప్ కార్డులు#

ఇన్‌స్టాల్ అయ్యాక, ప్రతి యాప్ ఇన్‌బాక్స్ సంభాషణ డీటెయిల్ ప్యానెల్‌లో విడ్జెట్‌గా కనిపిస్తుంది. సంభాషణ తెరిస్తే వెండర్ నుంచి లైవ్ కార్డు వస్తుంది: ఈ కస్టమర్ Stripe‌లో ఎవరు, వారి ఇటీవలి Shopify ఆర్డర్లు, వారి న్యూస్‌లెటర్ స్టేటస్, థ్రెడ్‌కు లింక్ అయిన Jira ఇష్యూలు, లేదా సందర్శకుడిపై Tracio తీర్పు. చాలా కార్డులు వెండర్ డాష్‌బోర్డ్‌లోని సంబంధిత రికార్డుకూ లింక్ చేస్తాయి — Tracio తీర్పు మాత్రం పూర్తిగా ప్యానెల్‌లోనే ఉంటుంది.

చూపించడానికి ఏమీ లేకపోతే కార్డులు నిజాయితీగా చెబుతాయి. కస్టమర్ కనబడకపోతే — లేదా సంభాషణకు వాడదగిన గుర్తింపు లేకపోతే — ఖాళీ పెట్టె చూపే బదులు కార్డు అదే విషయం చెప్పి కారణం వివరిస్తుంది. రెస్పాన్స్‌లు కొద్దిసేపు కాష్ అవుతాయి, యాప్-వారీగా రేట్-బడ్జెట్ ఉంటుంది — తెరిచి ఉన్న ఇన్‌బాక్స్ వెండర్ API పరిమితులను ఖర్చు చేయదు.

కార్డులు ధ్రువీకరించిన గుర్తింపునే అనుసరిస్తాయి#

Stripe, Shopify, Mailchimp, MailerLite కస్టమర్‌ను ఇమెయిల్ చిరునామాతో వెతుకుతాయి — అది నిజంగా ధ్రువీకరించబడిన చిరునామా అయితేనే: విడ్జెట్ సంతకం చేసిన గుర్తింపు (identity verification) కవర్ చేసేది, లేదా ఇమెయిల్-ఛానెల్ సంభాషణ From చిరునామా. సందర్శకుడు చాట్‌లో కేవలం టైప్ చేసిన చిరునామా లుక్అప్‌లకు అస్సలు వాడబడదు — లేకపోతే ఎవరైనా నిజమైన కస్టమర్ ఇమెయిల్ టైప్ చేసి వారి పేమెంట్ చరిత్రను చూడగలరు. ఆ సందర్భంలో కార్డు ఆ చిరునామాకు ధ్రువీకరించిన గుర్తింపు మద్దతు లేదని వివరిస్తుంది.

Jira, Tracio ఇమెయిల్‌పై ఆధారపడవు — Jira కార్డులు సంభాషణకు లింక్ అయిన ఇష్యూలవి, Tracio విడ్జెట్ సందర్శకుడిది — కాబట్టి ధ్రువీకరించిన చిరునామా లేకపోయినా అవి పనిచేస్తాయి.

సంభాషణ సొంత చిరునామాకు ఏమీ దొరకకపోతే, Respondo కాంటాక్ట్ యొక్క మరో తెలిసిన చిరునామానూ ప్రయత్నిస్తుంది (ఉదాహరణకు కాంటాక్ట్ మెర్జ్ తర్వాత), వాడిన చిరునామాతో కార్డుకు లేబుల్ వేస్తుంది.

ప్రతి యాప్ ఏమి చూపిస్తుంది#

Stripe#

కస్టమర్ బిల్లింగ్‌లోకి రీడ్-ఓన్లీ కిటికీ: పేరు, ఇమెయిల్, ఖాతా బ్యాలెన్స్, కాపీ చేయదగిన కస్టమర్ ID, సబ్‌స్క్రిప్షన్ — స్టేటస్ బ్యాడ్జ్, ప్లాన్, నెలవారీ విలువ, ప్రారంభ తేదీ — ఇన్వాయిస్ నంబర్లతో ఇటీవలి పేమెంట్లు. రీఫండ్‌లు ఒక్కటే ఆప్షనల్ రైట్: అడ్మిన్ యాప్ సెట్టింగ్‌లలో Allow refunds from the conversation panel ఆన్ చేయాలి (డిఫాల్ట్‌గా ఆఫ్), ఆపరేటర్‌కు Run refunds and cancellations అనుమతి ఉండాలి, ప్రతి రీఫండ్‌ను REFUND టైప్ చేసి నిర్ధారించాలి — పంపిన రీఫండ్‌ను Stripe వెనక్కి తీసుకోలేదు.

Shopify#

రీడ్-ఓన్లీ ఇటీవలి ఆర్డర్లు — ఆర్డర్ నంబర్, తేదీ, మొత్తం, పేమెంట్ మరియు ఫుల్‌ఫిల్‌మెంట్ స్టేటస్ — ప్రతి ఆర్డర్‌కీ, మీ Shopify అడ్మిన్‌లోని కస్టమర్ రికార్డుకీ లింక్‌లతో. మీ స్టోర్ డొమైన్ మరియు read_customers, read_orders స్కోప్‌లు ఉన్న కస్టమ్ యాప్ Admin API టోకెన్‌తో కనెక్ట్ అవుతుంది.

Mailchimp#

Mailchimp చూసే విధంగా సబ్‌స్క్రైబర్: స్టేటస్ బ్యాడ్జ్, ఆడియన్స్, ట్యాగ్‌లు, ఎంగేజ్‌మెంట్, ఇటీవలి క్యాంపెయిన్ యాక్టివిటీ (సెండ్‌లు, ఓపెన్‌లు, క్లిక్‌లు). ఒకే ఒక్క యాక్షన్ అందుబాటులో ఉంది: Unsubscribe — సంభాషణ వదలకుండా "నాకు ఇమెయిల్ ఆపండి" అభ్యర్థనను గౌరవించడానికి. API ద్వారా అది తిరిగి మార్చలేనిది — Mailchimp లో వ్యక్తి స్వయంగా సైన్అప్ ఫారమ్ ద్వారానే తిరిగి చేరగలరు — కాబట్టి టైప్ చేసిన నిర్ధారణ అవసరం. గమనిక: Mailchimp API కీలకు స్కోప్ ఉండదు — కనెక్ట్ చేసిన కీ ఖాతాలోని ప్రతిదాన్నీ చదవగలదు, రాయగలదు.

MailerLite#

సబ్‌స్క్రిప్షన్ స్టేటస్, గ్రూప్‌లు, సైన్అప్ తేదీ, ఎంగేజ్‌మెంట్, ఇటీవలి క్యాంపెయిన్ యాక్టివిటీ. రెండు యాక్షన్లు: Unsubscribe (వెనక్కి తీసుకోగలిగేది — MailerLite API రీ-సబ్‌స్క్రైబ్‌కు మద్దతిస్తుంది), Resubscribe — వ్యక్తి స్వయంగా కోరితే వారిని లిస్ట్‌లోకి తిరిగి చేర్చడానికి.

Jira#

సంభాషణలకూ Jira Cloud ఇష్యూలకూ మధ్య రెండు-వైపుల లింక్. ఈ సంభాషణకు లింక్ అయిన ఇష్యూలను వాటి ప్రస్తుత స్టేటస్‌తో కార్డు జాబితా చేస్తుంది; Create issue (మీరు ఎంచుకున్న ప్రాజెక్ట్‌లో ఫైల్ అవుతుంది, ఆటోమేటిక్‌గా లింక్ అవుతుంది), ఇప్పటికే ఉన్న ఇష్యూల కోసం Link existing / Unlink అందిస్తుంది. Jira లో జరిగిన స్టేటస్ మార్పులు వెబ్‌హుక్ ద్వారా వెనక్కి ప్రవహిస్తాయి: యాప్ సెట్టింగ్‌ల పేజీ మీ Jira సైట్‌లో పేస్ట్ చేయాల్సిన రహస్య వెబ్‌హుక్ చిరునామాను చూపుతుంది; అప్పటినుంచి కార్డు ఇష్యూ లైవ్ స్టేటస్‌ను ప్రతిబింబిస్తుంది. ఇష్యూలు మీరు కనెక్ట్ చేసిన Atlassian ఖాతా పేరుతో సృష్టించబడతాయి; ఆ ఖాతా చూసేదే కార్డూ చూస్తుంది.

ప్యానెల్ నుంచి నడిపే ప్రతి యాక్షన్‌కూ పాత్ర అనుమతుల గేట్ ఉంది — unsubscribe, resubscribe, Jira ఇష్యూలకు Use app actions; రీఫండ్‌లకు Run refunds and cancellations. యాప్ వర్క్‌స్పేస్ స్థాయి కెపాబిలిటీ టోగుల్ కూడా అందిస్తే — ఈరోజు అది Stripe యొక్క Allow refunds from the conversation panel — ఆ కెపాబిలిటీ అసలు ఉందా లేదా అనేది టోగులే నిర్ణయిస్తుంది; ఆఫ్ చేస్తే వర్క్‌స్పేస్ ఓనర్‌తో సహా అందరూ బ్లాక్ అవుతారు.

Tracio: మనిషా లేక బాట్#

చాట్-విడ్జెట్ సందర్శకుడి గురించి Tracio ఒకే ప్రశ్నకు జవాబిస్తుంది: ఇది మనిషా లేక బాట్? యాప్ ఇన్‌స్టాల్ చేస్తే మీ Respondo చాట్ విడ్జెట్ లోపల Tracio డిటెక్షన్ SDK ఎనేబుల్ అవుతుంది — కొత్త విడ్జెట్ సంభాషణలకు ఆటోమేటిక్‌గా తీర్పు వస్తుంది, సంభాషణ ప్యానెల్‌లోని Tracio కార్డుపై చిప్‌గా కనిపిస్తుంది.

చిప్అర్థం
HumanTracio సర్వర్-సైడ్ చెక్‌కు ఈ సందర్శకుడిపై బాట్ సంకేతాలు దొరకలేదు.
Bot · 93%బాట్ గుర్తించబడింది, Tracio నమ్మకంతో సహా. తీర్పు వెనుక ఉన్న సంకేతాలనూ కార్డు జాబితా చేస్తుంది.
UncheckedTracio సర్వర్-సైడ్ చెక్ ఇప్పుడు అందుబాటులో లేదు — కార్డు బ్రౌజర్ నివేదించిన తీర్పుకు ఫాల్‌బ్యాక్ అయి, అదే చెబుతుంది.
Forged IDబ్రౌజర్ పంపిన సందర్శక ID Tracio కు తెలియదు — ఆ దావా నకిలీలా కనిపిస్తోంది.

రెండు కీలు కనెక్ట్ అవుతాయి: విడ్జెట్‌లో SDK ను యాక్టివేట్ చేసే పబ్లిక్ కీ, తీర్పు సర్వర్-సైడ్ చెక్ కోసం వాడే రహస్య Data API కీ. సర్వర్-సైడ్ చెక్ లేకుండా బ్రౌజర్ యొక్క "బాట్ కాదు" దావాను ఒంటరిగా నమ్మలేం — బ్రౌజర్ దావా సర్వర్ తీర్పుతో విభేదిస్తే కార్డు రెండింటినీ చూపుతుంది.

Tracio చాట్-విడ్జెట్ సంభాషణలకు మాత్రమే పనిచేస్తుంది. ఇమెయిల్, Telegram, ఇతర ఛానెల్‌లలో పరిశీలించడానికి సందర్శకుడు లేడు, కాబట్టి వాటి Tracio కార్డు తనిఖీ చేయడానికి ఏమీ లేదని వివరిస్తుంది. తీర్పు లేకపోవడం అనుమానం కాదు: యాడ్ బ్లాకర్లు నిజమైన మనుషులకూ SDK ను ఎప్పుడూ కత్తిరిస్తాయి; Tracio కనెక్ట్ కాకముందు మొదలైన పాత సంభాషణలకూ తీర్పు ఉండదు.
Tracio SDK మీ సైట్ సందర్శకుల ఫింగర్‌ప్రింట్ తీసుకుంటుంది. సందర్శకుల సమ్మతి పొందడం (మీ CMP / కుకీ బ్యానర్ ద్వారా) సైట్ యజమానిగా మీ బాధ్యత.

పరిమితులు#

  • Stripe, Shopify కార్డులు రీడ్-ఓన్లీ — Stripe యాప్‌లో ఏకైక రైట్ ఆప్షనల్‌గా, స్పష్టంగా ఎనేబుల్ చేసిన రీఫండ్ యాక్షన్ మాత్రమే.
  • ఇమెయిల్-ఆధారిత యాప్‌లకు (Stripe, Shopify, Mailchimp, MailerLite) ధ్రువీకరించిన ఇమెయిల్ చిరునామా అవసరం. అనామక విడ్జెట్ సందర్శకులు లేదా చిరునామా లేని ఛానెల్‌ల సంభాషణలు నిజాయితీగా "వెతకడానికి ఏమీ లేదు" కార్డు చూపుతాయి.
  • Jira మద్దతు Jira Cloud కు మాత్రమే.
  • Mailchimp లో రీ-సబ్‌స్క్రైబ్ లేదు: అన్‌సబ్‌స్క్రైబ్ అయ్యాక వ్యక్తి స్వయంగా సైన్అప్ ఫారమ్ ద్వారానే తిరిగి చేరగలరు. ఆ ఫ్లో ముఖ్యమైతే MailerLite రీ-సబ్‌స్క్రైబ్ వాడండి.
  • Tracio తీర్పులు SDK లోడ్ అయిన విడ్జెట్ సంభాషణలకు మాత్రమే ఉంటాయి — ఇమెయిల్ లేదా మెసెంజర్ ఛానెల్‌లకు ఎప్పుడూ ఉండవు.