Dokumentasyon

Mga App at Integrasyon

Ikonekta ang mga tool na ginagamit na ng koponan ninyo — Stripe, Shopify, Mailchimp, MailerLite, Jira, at Tracio. Ang mga naka-install na app ay nagpapakita ng live na datos ng customer bilang mga card sa panel ng usapan sa Inbox, katabi mismo ng chat.

Pangkalahatang-ideya#

Nasa Mga Setting → Mga App ang marketplace ng mga app. Isang beses lang ini-install ang mga app, para sa buong workspace: ikinokonekta ng isang admin ang serbisyo gamit ang sariling kredensyal ng workspace, at makikita ng bawat kasamahang may access sa inbox ang nabubuong card sa panel ng usapan. Walang ini-install ang mga agent nang mag-isa — at wala ring ini-install ang mga ahente ng AI.

Install sa antas ng workspace

Isang set ng kredensyal bawat workspace. Ang pag-install, pag-edit, o pagtanggal ng app ay nakakaapekto sa lahat nang sabay-sabay.

Mga card sa Inbox

Ang bawat naka-install na app ay gumuguhit ng card sa panel ng usapan na may live na datos tungkol sa taong kausap ninyo.

Walang palamuti

Lahat ng nakalista sa catalog ay maaaring i-install ngayon — walang seksyong "paparating pa lang". May request tile para sabihin sa amin kung anong serbisyo ang kulang.

Ang pamamahala ng mga app ay nangangailangan ng pahintulot na Mag-install at mag-configure ng mga app (kasama na sa mga role na Owner at Admin bilang default, at maibibigay sa mga custom na role). Makikita pa rin ng mga kasamahang wala nito ang mga app card sa mga usapan — hindi lang sila makakapag-install o makakapag-reconfigure ng kahit ano.

Ang catalog ng mga app#

Anim na app ang available ngayon:

AppKategoryaAno ang nakikita ng mga agent sa usapan
StripeMga bayadSubscription at mga kamakailang bayad ng taong kausap ninyo
ShopifyCommerceMga kamakailang order na may status ng bayad at fulfilment
MailchimpMarketingStatus ng subscription, audience, at mga tag ng taong kausap ninyo
MailerLiteMarketingStatus ng subscription, mga grupo, at petsa ng pag-signup ng taong kausap ninyo
JiraIssue trackingMga issue na naka-link sa usapang ito, at isang click para gumawa ng panibago
TracioSeguridadTao o bot: ang hatol ng Tracio sa bisita ng chat widget

Naghahanap ng simpleng link papunta sa sarili ninyong back-office? Hindi iyon nangangailangan ng account o token, kaya nasa Mga Setting → Pangkalahatan → Mga link sa mga sistema ninyo ito, hindi sa catalog ng mga app.

Pag-install ng app#

Buksan ang Mga Setting → Mga App, pumili ng tile, at punan ang mga kredensyal na hinihingi ng app. Ang bawat field ay naka-link sa eksaktong pahina sa dashboard ng vendor kung saan ginagawa o makikita ang halaga.

HakbangPaglalarawan
1. Suriin ang previewBago kayo mag-paste ng kahit ano, ipinapakita ng pahina ng configuration ang sample ng eksaktong card na makikita ng mga agent ninyo — gawa sa imbentong datos, para alam ninyo kung ano ang ibinabahagi ninyo sa workspace bago pa maimbak ang kredensyal.
2. Ilagay ang mga kredensyalI-paste ang API key o token. Awtomatikong tini-trim ang mga halaga — hindi masisira ang install ng sumunod na espasyo o newline mula sa copy-paste.
3. I-save at i-testAng pag-save ay nag-iimbak ng configuration; ang pag-test ng koneksyon ay gumagawa ng totoong tawag sa vendor at ito ang nagpapaberde sa status chip.

Ang bawat app tile ay may status chip na nagsasabi kung nasaan na ang pag-install:

StatusKahulugan
Hindi pa na-testNakaimbak na ang mga kredensyal, pero hindi pa nakakasagot ang app sa totoong request.
KonektadoTunay nang sumagot ang vendor — beripikado ang koneksyon, hindi lang naka-save.
Kailangan ng atensyonTinanggihan ng vendor ang nakaimbak na kredensyal (binawi o nag-expire na key). Titigil ang mga card sa pagtawag sa vendor hangga't hindi nagse-save o muling nagte-test ng app ang isang admin.
ErrorMay ibang pumalpak — tingnan ang tooltip.
Naka-disablePinatay ng isang admin ang app. Mawawala ang card sa Inbox nang hindi binubura ang mga kredensyal.

Mga kredensyal at seguridad#

Pag-aari ng workspace ang mga kredensyal ng app, at ilang patakaran ang nag-iingat sa kanila:

  • Naka-encrypt sa imbakan. Ang mga lihim na field (API key, token) ay naka-encrypt bawat key sa imbakan at hindi na muling ipinapakita pagkatapos i-save.
  • Pinakamababang pribilehiyo kung pinapayagan ng vendor. Ang Stripe ay dapat ikonekta gamit ang restricted key na nakakabasa ng Customers, Subscriptions, Charges, at Invoices — dagdag ang write access sa Refunds kung dapat lang makapag-refund ang mga agent mula sa usapan. Kung mag-paste kayo ng full-access key, gagana pa rin ito, pero papayuhan kayo ng pahina ng mga setting na palitan ito.
  • Ang paglipat ng destinasyon ay muling hihingi ng sikreto. Ang pag-edit ng field na nakatali sa kredensyal — ang store domain ng Shopify, ang site URL ng Jira — ay nangangailangang ilagay muli ang token, para ang naka-save na kredensyal ay hinding- hindi mailihis sa host na hindi para sa kanya.
  • Ang pagbawi ay nakakaapekto sa buong workspace. Isang install lang bawat app bawat workspace: kung i-rotate o bawiin ninyo ang key sa vendor, titigil ang card ng bawat kasamahan hangga't hindi ito ina-update ng isang admin sa Mga Setting → Mga App.

Mga app card sa Inbox#

Kapag naka-install na, lumilitaw ang bawat app bilang widget sa detail panel ng usapan sa Inbox. Ang pagbukas ng usapan ay kumukuha ng live na card mula sa vendor: kung sino ang customer na ito sa Stripe, ang mga kamakailang Shopify order nila, ang status nila sa newsletter, ang mga Jira issue na naka-link sa thread, o ang hatol ng Tracio sa bisita. Karamihan sa mga card ay naka-link din palabas sa katugmang record sa sariling dashboard ng vendor — ang hatol ng Tracio ay buong nasa panel lang.

Tapat ang mga card kapag wala silang maipapakita. Kung hindi mahanap ang customer — o walang magagamit na identity ang usapan — sinasabi iyon ng card at ipinapaliwanag kung bakit, sa halip na mag-render ng walang lamang kahon. Panandaliang naka-cache ang mga sagot at may rate budget bawat app, kaya hindi uubusin ng nakabukas na inbox ang mga limitasyon ng API ng vendor.

Sinusunod ng mga card ang beripikadong identity#

Hinahanap ng Stripe, Shopify, Mailchimp, at MailerLite ang customer ayon sa email address — at ayon lang sa address na tunay na beripikado: isang saklaw ng pirmadong identity ng widget (pagpapatunay ng identity), o ang From address ng usapan sa channel ng email. Ang address na tinipa lang ng bisita sa chat ay hindi ginagamit sa paghahanap — kung hindi, kahit sino ay makakapag-type ng email ng totoong customer at makikita ang kasaysayan ng bayad nila. Sa ganoong kaso, ipinapaliwanag ng card na ang address ay walang suporta ng beripikadong identity.

Hindi email ang susi ng Jira at Tracio — ang mga Jira card ay pag-aari ng mga naka-link na issue ng usapan, at ang Tracio ay sa bisita ng widget — kaya gumagana sila kahit walang beripikadong address.

Kung walang mahanap ang sariling address ng usapan, sinusubukan din ng Respondo ang isa pang kilalang address ng contact (halimbawa pagkatapos ng contact merge), at nilalagyan ng label ang card ng address na ginamit nito.

Ano ang ipinapakita ng bawat app#

Stripe#

Isang read-only na bintana sa billing ng customer: pangalan, email, balanse ng account, at nakokopyang customer ID, dagdag ang subscription — status badge, plano, buwanang halaga, at petsa ng simula — at mga kamakailang bayad na may mga numero ng invoice. Ang refund ang nag-iisang opsyonal na write: kailangang buksan ng isang admin ang Payagan ang mga refund mula sa panel ng usapan sa mga setting ng app (nakapatay bilang default), kailangan ng operator ang pahintulot na Magpatakbo ng mga refund at kanselasyon, at ang bawat refund ay dapat kumpirmahin sa pagta-type ng REFUND — hindi na mababawi ng Stripe ang refund kapag naipadala na.

Shopify#

Read-only na mga kamakailang order — numero ng order, petsa, kabuuan, status ng bayad at fulfilment — na may mga link sa bawat order at sa record ng customer sa Shopify admin ninyo. Ikinokonekta gamit ang domain ng store ninyo at isang Admin API token mula sa custom app na may mga scope na read_customers at read_orders.

Mailchimp#

Ang subscriber ayon sa pagkakakita ng Mailchimp: status badge, audience, mga tag, engagement, at kamakailang aktibidad sa campaign (mga send, open, click). Isang aksyon ang available: Mag-unsubscribe, para tuparin ang hiling na "itigil ang pag-email sa akin" nang hindi umaalis sa usapan. Hindi ito maibabalik sa pamamagitan ng API — pinapayagan lang ng Mailchimp na muling mag-opt in ang tao mismo sa pamamagitan ng signup form — kaya kailangan ito ng tinipang kumpirmasyon. Tandaan na walang scope ang mga API key ng Mailchimp: ang key na ikinonekta ninyo ay nakakabasa at nakakasulat sa lahat ng nasa account.

MailerLite#

Status ng subscription, mga grupo, petsa ng pag-signup, engagement, at kamakailang aktibidad sa campaign. Dalawang aksyon: Mag-unsubscribe (maibabalik — sinusuportahan ng API ng MailerLite ang muling pag-subscribe) at Muling mag-subscribe, para ibalik ang isang tao sa listahan sa sarili nilang hiling.

Jira#

Isang two-way na link sa pagitan ng mga usapan at mga issue sa Jira Cloud. Nakalista sa card ang mga issue na naka-link sa usapang ito kasama ang kasalukuyang status nila, at inaalok nito ang Gumawa ng issue (inihahain sa napili ninyong project, awtomatikong naka-link) at I-link ang umiiral / I-unlink para sa mga issue na umiiral na. Ang mga pagbabago sa status na ginawa sa Jira ay bumabalik sa pamamagitan ng webhook: ipinapakita ng pahina ng mga setting ng app ang lihim na webhook address na ipa-paste sa Jira site ninyo, at mula noon ay sinasalamin ng card ang live na status ng issue. Ginagawa ang mga issue bilang ang Atlassian account na ikinonekta ninyo, at nakikita ng card ang eksaktong nakikita ng account na iyon.

Ang bawat aksyong pinapatakbo mula sa panel ay hinaharangan ng mga pahintulot ng role — Gumamit ng mga aksyon ng app para sa unsubscribe, resubscribe, at mga Jira issue, at Magpatakbo ng mga refund at kanselasyon para sa mga refund. Kung ang app ay may toggle din ng kakayahan sa antas ng workspace — sa ngayon iyon ay ang Payagan ang mga refund mula sa panel ng usapan ng Stripe — ang toggle ang nagpapasya kung umiiral man ang kakayahan, at ang pagpatay dito ay humaharang sa lahat, kasama na ang owner ng workspace.

Tracio: tao o bot#

Sinasagot ng Tracio ang isang tanong tungkol sa bisita ng chat widget: tao ba ito o bot? Ang pag-install ng app ay nagbubukas ng detection SDK ng Tracio sa loob ng Respondo chat widget ninyo — awtomatikong nakakakuha ng hatol ang mga bagong usapan sa widget, na ipinapakita bilang chip sa Tracio card sa panel ng usapan.

ChipKahulugan
TaoWalang nakitang senyales ng bot ang server-side check ng Tracio para sa bisitang ito.
Bot · 93%May natukoy na bot, kasama ang kumpiyansa ng Tracio. Nakalista rin sa card ang mga senyales sa likod ng hatol.
Hindi na-checkHindi available ngayon ang server-side check ng Tracio — bumabalik ang card sa hatol na iniulat ng browser at sinasabi iyon.
Pekeng IDHindi kilala ng Tracio ang visitor ID na ipinadala ng browser — mukhang peke ang pahayag.

Dalawang key ang ikinokonekta: isang public key na nagbubukas ng SDK sa widget, at isang lihim na Data API key na ginagamit sa server-side check ng hatol. Kung walang server-side check, hindi mapagkakatiwalaan nang mag-isa ang pahayag ng browser na "hindi bot" — at kapag hindi tugma ang pahayag ng browser sa hatol ng server, ipinapakita ng card ang dalawa.

Gumagana ang Tracio sa mga usapan sa chat widget lang. Ang email, Telegram, at iba pang channel ay walang bisitang masisiyasat, kaya ipinapaliwanag ng Tracio card nila na walang mache-check. Ang kawalan ng hatol ay hindi paghihinala: pinuputol ng mga ad blocker ang SDK para sa mga totoong tao sa lahat ng oras, at ang mga mas lumang usapang nagsimula bago ikonekta ang Tracio ay wala ring hatol.
Kinukunan ng fingerprint ng Tracio SDK ang mga bisita ng site ninyo. Responsibilidad ninyo bilang may-ari ng site ang pagkuha ng pahintulot ng bisita (sa pamamagitan ng CMP / cookie banner ninyo).

Mga limitasyon#

  • Ang mga card ng Stripe at Shopify ay read-only — ang nag-iisang write saanman sa Stripe app ay ang opsyonal at tahasang binuksang aksyon ng refund.
  • Ang mga app na naka-key sa email (Stripe, Shopify, Mailchimp, MailerLite) ay nangangailangan ng beripikadong email address. Ang mga usapan mula sa mga anonymous na bisita ng widget o mga channel na walang address ay nagpapakita ng tapat na card na "walang mahahanap".
  • Jira Cloud lang ang saklaw ng suporta sa Jira.
  • Walang resubscribe ang Mailchimp: kapag naka-unsubscribe na, ang tao mismo lang ang makakapag-opt in muli sa pamamagitan ng signup form. Gamitin ang resubscribe ng MailerLite kung mahalaga sa inyo ang daloy na iyon.
  • May hatol ng Tracio ang mga usapan sa widget lang na may naka-load na SDK — hindi kailanman para sa email o mga messenger channel.