Dokumentasi

Aplikasi & Integrasi

Sambungkan alatan yang sudah digunakan pasukan anda — Stripe, Shopify, Mailchimp, MailerLite, Jira, dan Tracio. Aplikasi yang dipasang memaparkan data pelanggan secara langsung sebagai kad dalam panel perbualan Peti Masuk, betul-betul di sebelah sembang.

Gambaran Keseluruhan#

Pasaran aplikasi berada di Tetapan → Aplikasi. Aplikasi dipasang sekali sahaja, untuk seluruh ruang kerja: seorang admin menyambungkan perkhidmatan dengan kelayakan ruang kerja itu sendiri, dan setiap ahli pasukan dengan akses peti masuk melihat kad yang terhasil dalam panel perbualan. Ejen tidak pernah memasang apa-apa sendiri — dan ejen AI juga tidak pernah memasang apa-apa.

Pemasangan peringkat ruang kerja

Satu set kelayakan bagi setiap ruang kerja. Memasang, menyunting, atau membuang aplikasi memberi kesan kepada semua orang serentak.

Kad dalam Peti Masuk

Setiap aplikasi yang dipasang memaparkan kad dalam panel perbualan dengan data langsung tentang orang yang sedang anda hubungi.

Tiada pengisi

Semua yang disenaraikan dalam katalog boleh dipasang hari ini — tiada bahagian "akan datang". Jubin permintaan membolehkan anda memberitahu kami perkhidmatan mana yang belum ada.

Mengurus aplikasi memerlukan kebenaran Pasang dan konfigurasi aplikasi (disertakan dalam peranan Owner dan Admin secara lalai, dan boleh diberikan kepada peranan tersuai). Ahli pasukan tanpanya masih melihat kad aplikasi dalam perbualan — mereka cuma tidak boleh memasang atau mengkonfigurasi semula apa-apa.

Katalog aplikasi#

Enam aplikasi tersedia hari ini:

AplikasiKategoriApa yang dilihat ejen dalam perbualan
StripePembayaranLangganan dan pembayaran terkini orang yang sedang anda hubungi
ShopifyPerdaganganPesanan terkini dengan status pembayaran dan penunaian
MailchimpPemasaranStatus langganan, audiens, dan tag orang yang sedang anda hubungi
MailerLitePemasaranStatus langganan, kumpulan, dan tarikh pendaftaran orang yang sedang anda hubungi
JiraPenjejakan isuIsu yang dipautkan ke perbualan ini, dan satu klik untuk membuka isu baharu
TracioKeselamatanManusia atau bot: keputusan Tracio tentang pelawat widget sembang

Mahukan pautan biasa ke back-office anda sendiri? Ia tidak memerlukan akaun mahupun token, jadi ia berada di Tetapan → Umum → Pautan ke sistem anda dan bukannya dalam katalog aplikasi.

Memasang aplikasi#

Buka Tetapan → Aplikasi, pilih satu jubin, dan isikan kelayakan yang diminta oleh aplikasi itu. Setiap medan memautkan ke halaman tepat dalam papan pemuka vendor tempat nilai itu dicipta atau ditemui.

LangkahPenerangan
1. Semak pratontonSebelum anda menampal apa-apa, halaman konfigurasi memaparkan sampel kad sebenar yang akan dilihat ejen anda — dibina dengan data rekaan, supaya anda tahu apa yang anda kongsikan dengan ruang kerja sebelum sebarang kelayakan disimpan.
2. Masukkan kelayakanTampal kunci API atau token. Nilai dipangkas secara automatik — ruang atau baris baharu di hujung akibat salin-tampal tidak akan merosakkan pemasangan.
3. Simpan & ujiMenyimpan akan menyimpan konfigurasi; menguji sambungan membuat panggilan sebenar ke vendor dan itulah yang menukar cip status menjadi hijau.

Setiap jubin aplikasi membawa cip status yang memberitahu anda kedudukan pemasangan:

StatusMaksud
Belum diujiKelayakan telah disimpan, tetapi aplikasi belum menjawab permintaan sebenar.
DisambungkanVendor benar-benar telah menjawab — sambungan disahkan, bukan sekadar disimpan.
Perlu perhatianVendor menolak kelayakan yang disimpan (kunci ditarik balik atau tamat tempoh). Kad berhenti menghubungi vendor sehingga admin menyimpan atau menguji semula aplikasi.
RalatSesuatu yang lain gagal — lihat petua alat.
DilumpuhkanSeorang admin mematikan aplikasi. Kad hilang daripada Peti Masuk tanpa kelayakan dipadamkan.

Kelayakan & keselamatan#

Kelayakan aplikasi adalah milik ruang kerja, dan beberapa peraturan memastikan ia selamat:

  • Disulitkan semasa disimpan. Medan rahsia (kunci API, token) disulitkan per kunci dalam storan dan tidak pernah dipaparkan semula selepas disimpan.
  • Keistimewaan paling rendah di mana vendor membenarkannya. Stripe patut disambungkan dengan kunci terhad yang boleh membaca Customers, Subscriptions, Charges, dan Invoices — serta akses tulis Refunds hanya jika ejen patut membuat bayaran balik dari perbualan. Jika anda menampal kunci akses penuh ia tetap berfungsi, tetapi halaman tetapan akan menasihatkan anda menggantikannya.
  • Menukar destinasi meminta rahsia semula. Menyunting medan yang terikat dengan kelayakan — domain kedai Shopify, URL laman Jira — memerlukan token dimasukkan semula, jadi kelayakan yang tersimpan tidak sekali-kali boleh dihalakan ke hos yang bukan untuknya.
  • Penarikan balik memberi kesan kepada seluruh ruang kerja. Terdapat satu pemasangan bagi setiap aplikasi setiap ruang kerja: jika anda memutar atau menarik balik kunci di pihak vendor, kad setiap ahli pasukan berhenti berfungsi sehingga admin mengemas kininya dalam Tetapan → Aplikasi.

Kad aplikasi dalam Peti Masuk#

Setelah dipasang, setiap aplikasi muncul sebagai widget dalam panel butiran perbualan Peti Masuk. Membuka perbualan mengambil kad langsung daripada vendor: siapa pelanggan ini dalam Stripe, pesanan Shopify terkini mereka, status surat berita mereka, isu Jira yang dipautkan ke bebenang, atau keputusan Tracio tentang pelawat. Kebanyakan kad juga memaut keluar ke rekod sepadan dalam papan pemuka vendor sendiri — keputusan Tracio berada sepenuhnya dalam panel.

Kad bersikap jujur apabila tiada apa untuk dipaparkan. Jika pelanggan tidak ditemui — atau perbualan tiada identiti yang boleh digunakan — kad menyatakannya dan menerangkan sebab, dan bukannya memaparkan kotak kosong. Respons dicache seketika dan dihadkan kadar bagi setiap aplikasi, jadi peti masuk yang terbuka tidak menghabiskan had API vendor.

Kad mengikut identiti yang disahkan#

Stripe, Shopify, Mailchimp, dan MailerLite mencari pelanggan melalui alamat e-mel — dan hanya alamat yang benar-benar disahkan: alamat yang dilindungi identiti bertandatangan widget (pengesahan identiti), atau alamat From perbualan saluran e-mel. Alamat yang sekadar ditaip pelawat ke dalam sembang langsung tidak digunakan untuk carian — jika tidak, sesiapa sahaja boleh menaip e-mel pelanggan sebenar dan melihat sejarah pembayaran mereka. Dalam kes itu kad menerangkan bahawa alamat tersebut tidak disokong oleh identiti yang disahkan.

Jira dan Tracio tidak berkunci pada e-mel — kad Jira adalah milik isu yang dipautkan ke perbualan, dan Tracio milik pelawat widget — jadi ia berfungsi walaupun tiada alamat yang disahkan.

Jika alamat perbualan itu sendiri tidak menemui apa-apa, Respondo turut mencuba alamat lain yang diketahui bagi kenalan itu (contohnya selepas gabungan kenalan), dan melabelkan kad dengan alamat yang digunakannya.

Apa yang dipaparkan setiap aplikasi#

Stripe#

Tetingkap baca sahaja ke pengebilan pelanggan: nama, e-mel, baki akaun, dan ID pelanggan yang boleh disalin, serta langganan — lencana status, pelan, nilai bulanan, dan tarikh mula — dan pembayaran terkini dengan nombor invois. Bayaran balik ialah satu-satunya tindakan tulis pilihan: admin perlu menghidupkan Benarkan bayaran balik dari panel perbualan dalam tetapan aplikasi (mati secara lalai), operator memerlukan kebenaran Jalankan bayaran balik dan pembatalan, dan setiap bayaran balik mesti disahkan dengan menaip REFUND — Stripe tidak boleh menarik balik bayaran balik setelah ia dihantar.

Shopify#

Pesanan terkini baca sahaja — nombor pesanan, tarikh, jumlah, status pembayaran dan penunaian — dengan pautan ke setiap pesanan dan ke rekod pelanggan dalam admin Shopify anda. Disambungkan dengan domain kedai anda dan token Admin API daripada aplikasi tersuai dengan skop read_customers dan read_orders.

Mailchimp#

Pelanggan sebagaimana Mailchimp melihatnya: lencana status, audiens, tag, penglibatan, dan aktiviti kempen terkini (penghantaran, pembukaan, klikan). Satu tindakan tersedia: Berhenti melanggan, untuk memenuhi permintaan "berhenti hantar e-mel kepada saya" tanpa meninggalkan perbualan. Ia tidak boleh diterbalikkan melalui API — Mailchimp hanya membenarkan seseorang melanggan semula melalui borang pendaftaran sendiri — jadi ia memerlukan pengesahan bertaip. Ambil perhatian bahawa kunci API Mailchimp tidak berskop: kunci yang anda sambungkan boleh membaca dan menulis segala-gala dalam akaun.

MailerLite#

Status langganan, kumpulan, tarikh pendaftaran, penglibatan, dan aktiviti kempen terkini. Dua tindakan: Berhenti melanggan (boleh diterbalikkan — API MailerLite menyokong langganan semula) dan Langgan semula, untuk memasukkan seseorang kembali ke senarai atas permintaan mereka sendiri.

Jira#

Pautan dua hala antara perbualan dan isu Jira Cloud. Kad menyenaraikan isu yang dipautkan ke perbualan ini dengan status semasanya, dan menawarkan Cipta isu (difailkan dalam projek pilihan anda, dipautkan secara automatik) serta Pautkan sedia ada / Nyahpaut untuk isu yang sudah wujud. Perubahan status yang dibuat dalam Jira mengalir kembali melalui webhook: halaman tetapan aplikasi memaparkan alamat webhook rahsia untuk ditampal ke laman Jira anda, dan kad mencerminkan status langsung isu itu sejak saat itu. Isu dicipta sebagai akaun Atlassian yang anda sambungkan, dan kad melihat tepat apa yang dilihat akaun itu.

Setiap tindakan yang dijalankan dari panel dikawal oleh kebenaran peranan — Guna tindakan aplikasi untuk berhenti melanggan, langgan semula, dan isu Jira, serta Jalankan bayaran balik dan pembatalan untuk bayaran balik. Apabila aplikasi turut menawarkan togol keupayaan peringkat ruang kerja — hari ini iaitu Benarkan bayaran balik dari panel perbualan milik Stripe — togol itu menentukan sama ada keupayaan itu wujud sama sekali, dan mematikannya menyekat semua orang, termasuk pemilik ruang kerja.

Tracio: manusia atau bot#

Tracio menjawab satu soalan tentang pelawat widget sembang: adakah ini manusia atau bot? Memasang aplikasi ini mengaktifkan SDK pengesanan Tracio dalam widget sembang Respondo anda — perbualan widget baharu menerima keputusan secara automatik, dipaparkan sebagai cip pada kad Tracio dalam panel perbualan.

CipMaksud
ManusiaSemakan di pihak pelayan Tracio tidak menemui sebarang isyarat bot bagi pelawat ini.
Bot · 93%Bot dikesan, dengan tahap keyakinan Tracio. Kad turut menyenaraikan isyarat di sebalik keputusan itu.
Tidak diperiksaSemakan di pihak pelayan Tracio tidak tersedia buat masa ini — kad berundur kepada keputusan yang dilaporkan pelayar dan menyatakannya.
ID dipalsukanID pelawat yang dihantar pelayar tidak dikenali oleh Tracio — dakwaan itu kelihatan dipalsukan.

Dua kunci disambungkan: kunci awam yang mengaktifkan SDK dalam widget, dan kunci Data API rahsia yang digunakan untuk semakan keputusan di pihak pelayan. Tanpa semakan di pihak pelayan, dakwaan "bukan bot" daripada pelayar tidak boleh dipercayai dengan sendirinya — dan apabila dakwaan pelayar bercanggah dengan keputusan pelayan, kad memaparkan kedua-duanya.

Tracio berfungsi hanya untuk perbualan widget sembang. E-mel, Telegram, dan saluran lain tiada pelawat untuk diperiksa, jadi kad Tracio mereka menerangkan tiada apa untuk disemak. Keputusan yang tiada bukanlah kecurigaan: penyekat iklan memotong SDK untuk manusia sebenar sepanjang masa, dan perbualan lama yang bermula sebelum Tracio disambungkan juga tiada keputusan.
SDK Tracio mengambil cap jari pelawat laman anda. Mendapatkan persetujuan pelawat (melalui CMP / sepanduk kuki anda) adalah tanggungjawab anda sebagai pemilik laman.

Had#

  • Kad Stripe dan Shopify adalah baca sahaja — satu-satunya tindakan tulis dalam aplikasi Stripe ialah tindakan bayaran balik pilihan yang diaktifkan secara eksplisit.
  • Aplikasi berkunci e-mel (Stripe, Shopify, Mailchimp, MailerLite) memerlukan alamat e-mel yang disahkan. Perbualan daripada pelawat widget tanpa nama atau saluran tanpa alamat memaparkan kad "tiada apa untuk dicari" yang jujur.
  • Sokongan Jira meliputi Jira Cloud sahaja.
  • Mailchimp tidak menawarkan langganan semula: setelah berhenti melanggan, hanya orang itu sendiri boleh melanggan semula melalui borang pendaftaran. Gunakan langganan semula MailerLite jika aliran itu penting bagi anda.
  • Keputusan Tracio hanya wujud untuk perbualan widget dengan SDK dimuatkan — tidak sekali-kali untuk saluran e-mel atau messenger.