Dokumentacja

Aplikacje i integracje

Podłącz narzędzia, z których Twój zespół już korzysta — Stripe, Shopify, Mailchimp, MailerLite, Jira i Tracio. Zainstalowane aplikacje pokazują dane klientów na żywo jako karty w panelu rozmowy w skrzynce, tuż obok czatu.

Przegląd#

Marketplace aplikacji znajduje się w Ustawienia → Aplikacje. Aplikacje instaluje się raz, dla całej przestrzeni roboczej: administrator podłącza usługę poświadczeniami przestrzeni roboczej, a każdy członek zespołu z dostępem do skrzynki widzi powstałą kartę w panelu rozmowy. Agenci niczego nie instalują sami — agenci AI również niczego nie instalują.

Instalacja na poziomie przestrzeni roboczej

Jeden zestaw poświadczeń na przestrzeń roboczą. Instalacja, edycja lub usunięcie aplikacji dotyczy wszystkich naraz.

Karty w skrzynce

Każda zainstalowana aplikacja rysuje kartę w panelu rozmowy z danymi na żywo o osobie, z którą rozmawiasz.

Bez wypełniaczy

Wszystko, co widnieje w katalogu, można zainstalować już dziś — nie ma sekcji "wkrótce". Kafelek prośby pozwala powiedzieć nam, jakiej usługi brakuje.

Zarządzanie aplikacjami wymaga uprawnienia Instalowanie i konfigurowanie aplikacji (domyślnie zawartego w rolach Owner i Admin, z możliwością nadania rolom niestandardowym). Członkowie zespołu bez niego nadal widzą karty aplikacji w rozmowach — po prostu nie mogą niczego instalować ani rekonfigurować.

Katalog aplikacji#

Dostępnych jest dziś sześć aplikacji:

AplikacjaKategoriaCo agenci widzą w rozmowie
StripePłatnościSubskrypcja i ostatnie płatności osoby, z którą rozmawiasz
ShopifyHandelOstatnie zamówienia ze statusem płatności i realizacji
MailchimpMarketingStatus subskrypcji, odbiorcy i tagi osoby, z którą rozmawiasz
MailerLiteMarketingStatus subskrypcji, grupy i data zapisu osoby, z którą rozmawiasz
JiraŚledzenie zgłoszeńZgłoszenia powiązane z tą rozmową i jedno kliknięcie, by założyć kolejne
TracioBezpieczeństwoCzłowiek czy bot: werdykt Tracio o odwiedzającym widget czatu

Szukasz zwykłego linku do własnego back-office'u? Taki link nie potrzebuje konta ani tokenu, więc mieszka w Ustawienia → Ogólne → Linki do Twoich systemów, a nie w katalogu aplikacji.

Instalacja aplikacji#

Otwórz Ustawienia → Aplikacje, wybierz kafelek i wypełnij poświadczenia, o które prosi aplikacja. Każde pole linkuje do dokładnie tej strony w panelu dostawcy, gdzie dana wartość jest tworzona lub znajdowana.

KrokOpis
1. Obejrzyj podglądZanim cokolwiek wkleisz, strona konfiguracji pokazuje próbkę dokładnie takiej karty, jaką zobaczą Twoi agenci — zbudowaną z wymyślonych danych, więc wiesz, czym dzielisz się z przestrzenią roboczą, zanim poświadczenie zostanie zapisane.
2. Wprowadź poświadczeniaWklej klucz API lub token. Wartości są przycinane automatycznie — spacja czy znak nowej linii na końcu po kopiuj-wklej nie zepsuje instalacji.
3. Zapisz i przetestujZapisanie przechowuje konfigurację; test połączenia wykonuje prawdziwe wywołanie do dostawcy i to on zmienia chip statusu na zielony.

Każdy kafelek aplikacji ma chip statusu, który mówi, na jakim etapie jest instalacja:

StatusZnaczenie
NieprzetestowanaPoświadczenia są zapisane, ale aplikacja nie odpowiedziała jeszcze na żadne prawdziwe żądanie.
PołączonaDostawca faktycznie odpowiedział — połączenie jest zweryfikowane, a nie tylko zapisane.
Wymaga uwagiDostawca odrzucił zapisane poświadczenia (cofnięty lub wygasły klucz). Karty przestają dzwonić do dostawcy, dopóki administrator nie zapisze lub nie przetestuje aplikacji ponownie.
BłądZawiodło coś innego — zobacz podpowiedź.
WyłączonaAdministrator wyłączył aplikację. Karta znika ze skrzynki bez usuwania poświadczeń.

Poświadczenia i bezpieczeństwo#

Poświadczenia aplikacji należą do przestrzeni roboczej, a kilka reguł trzyma je w bezpieczeństwie:

  • Szyfrowane w spoczynku. Pola sekretne (klucze API, tokeny) są szyfrowane per klucz w magazynie i nigdy nie są pokazywane ponownie po zapisaniu.
  • Najmniejsze uprawnienia tam, gdzie dostawca na to pozwala. Stripe powinien być podłączony kluczem ograniczonym, który może czytać Customers, Subscriptions, Charges i Invoices — plus zapis Refunds tylko wtedy, gdy agenci mają zwracać pieniądze z poziomu rozmowy. Jeśli wkleisz klucz z pełnym dostępem, nadal zadziała, ale strona ustawień doradzi jego wymianę.
  • Zmiana miejsca docelowego pyta o sekret ponownie. Edycja pola, z którym poświadczenie jest związane — domeny sklepu Shopify, adresu witryny Jira — wymaga ponownego wpisania tokenu, więc zapisane poświadczenie nigdy nie może zostać przekierowane na hosta, dla którego nie było przeznaczone.
  • Cofnięcie dotyka całej przestrzeni roboczej. Na przestrzeń roboczą przypada jedna instalacja każdej aplikacji: jeśli zrotujesz lub cofniesz klucz u dostawcy, karta każdego członka zespołu przestaje działać, dopóki administrator nie zaktualizuje jej w Ustawienia → Aplikacje.

Karty aplikacji w skrzynce#

Po instalacji każda aplikacja pojawia się jako widget w panelu szczegółów rozmowy w skrzynce. Otwarcie rozmowy pobiera kartę na żywo od dostawcy: kim jest ten klient w Stripe, jego ostatnie zamówienia Shopify, status newslettera, zgłoszenia Jira powiązane z wątkiem albo werdykt Tracio o odwiedzającym. Większość kart linkuje też do pasującego rekordu w panelu samego dostawcy — werdykt Tracio żyje w całości w panelu.

Karty uczciwie mówią, gdy nie mają nic do pokazania. Jeśli klient nie został znaleziony — albo rozmowa nie ma użytecznej tożsamości — karta to komunikuje i wyjaśnia dlaczego, zamiast renderować puste pudełko. Odpowiedzi są krótko cache'owane i objęte budżetem zapytań per aplikacja, więc otwarta skrzynka nie przepala limitów API dostawcy.

Karty podążają za zweryfikowaną tożsamością#

Stripe, Shopify, Mailchimp i MailerLite wyszukują klienta po adresie e-mail — i tylko po adresie faktycznie zweryfikowanym: objętym podpisaną tożsamością widgetu (weryfikacja tożsamości) albo adresie From rozmowy z kanału e-mail. Adres, który odwiedzający jedynie wpisał w czacie, nie jest w ogóle używany do wyszukiwań — inaczej każdy mógłby wpisać e-mail prawdziwego klienta i zobaczyć jego historię płatności. W takim przypadku karta wyjaśnia, że adres nie jest poparty zweryfikowaną tożsamością.

Jira i Tracio nie kluczują po e-mailu — karty Jira należą do zgłoszeń powiązanych z rozmową, a Tracio do odwiedzającego widget — więc działają nawet wtedy, gdy nie istnieje żaden zweryfikowany adres.

Jeśli własny adres rozmowy niczego nie znajduje, Respondo próbuje też drugiego znanego adresu kontaktu (na przykład po scaleniu kontaktów) i oznacza kartę adresem, którego użył.

Co pokazuje każda aplikacja#

Stripe#

Okno tylko do odczytu na rozliczenia klienta: imię i nazwisko, e-mail, saldo konta i kopiowalne ID klienta, plus subskrypcja — odznaka statusu, plan, wartość miesięczna i data startu — oraz ostatnie płatności z numerami faktur. Zwroty to jedyny opcjonalny zapis: administrator musi włączyć Zezwalaj na zwroty z panelu rozmowy w ustawieniach aplikacji (domyślnie wyłączone), operator potrzebuje uprawnienia Wykonywanie zwrotów i anulowań, a każdy zwrot trzeba potwierdzić, wpisując REFUND — Stripe nie może cofnąć zwrotu po jego wysłaniu.

Shopify#

Ostatnie zamówienia tylko do odczytu — numer zamówienia, data, suma, status płatności i realizacji — z linkami do każdego zamówienia i do rekordu klienta w Twoim panelu Shopify. Podłączana domeną sklepu i tokenem Admin API z aplikacji niestandardowej z zakresami read_customers i read_orders.

Mailchimp#

Subskrybent takim, jakim widzi go Mailchimp: odznaka statusu, odbiorcy, tagi, zaangażowanie i ostatnia aktywność kampanii (wysyłki, otwarcia, kliknięcia). Dostępna jest jedna akcja: Wypisz, do honorowania prośby "przestańcie do mnie pisać" bez opuszczania rozmowy. Przez API jest nieodwracalna — Mailchimp pozwala osobie zapisać się z powrotem tylko samodzielnie przez formularz zapisu — więc wymaga wpisanego potwierdzenia. Zwróć uwagę, że klucze API Mailchimp nie mają zakresów: podłączony klucz może czytać i zapisywać wszystko na koncie.

MailerLite#

Status subskrypcji, grupy, data zapisu, zaangażowanie i ostatnia aktywność kampanii. Dwie akcje: Wypisz (odwracalna — API MailerLite obsługuje ponowny zapis) i Zapisz ponownie, do przywracania kogoś na listę na jego własną prośbę.

Jira#

Dwukierunkowy łącznik między rozmowami a zgłoszeniami Jira Cloud. Karta wymienia zgłoszenia powiązane z tą rozmową wraz z ich bieżącym statusem i oferuje Utwórz zgłoszenie (zakładane w wybranym projekcie, powiązane automatycznie) oraz Powiąż istniejące / Odłącz dla zgłoszeń, które już istnieją. Zmiany statusu w Jira wracają przez webhook: strona ustawień aplikacji pokazuje sekretny adres webhooka do wklejenia w Twojej witrynie Jira, a karta od tej pory odzwierciedla status zgłoszenia na żywo. Zgłoszenia są tworzone jako konto Atlassian, które podłączasz, a karta widzi dokładnie to, co widzi to konto.

Każda akcja uruchamiana z panelu jest bramkowana uprawnieniami roli — Używanie akcji aplikacji dla wypisu, ponownego zapisu i zgłoszeń Jira oraz Wykonywanie zwrotów i anulowań dla zwrotów. Tam, gdzie aplikacja oferuje też przełącznik możliwości na poziomie przestrzeni roboczej — dziś to Zezwalaj na zwroty z panelu rozmowy w Stripe — przełącznik decyduje, czy możliwość w ogóle istnieje, a wyłączenie go blokuje wszystkich, łącznie z właścicielem przestrzeni roboczej.

Tracio: człowiek czy bot#

Tracio odpowiada na jedno pytanie o odwiedzającego widget czatu: człowiek czy bot? Instalacja aplikacji włącza SDK detekcji Tracio w Twoim widgecie czatu Respondo — nowe rozmowy z widgetu dostają werdykt automatycznie, pokazywany jako chip na karcie Tracio w panelu rozmowy.

ChipZnaczenie
CzłowiekSerwerowa kontrola Tracio nie znalazła sygnałów bota dla tego odwiedzającego.
Bot · 93%Wykryto bota, z pewnością Tracio. Karta wymienia też sygnały stojące za werdyktem.
NiesprawdzonySerwerowa kontrola Tracio jest w tej chwili niedostępna — karta cofa się do werdyktu zgłoszonego przez przeglądarkę i to komunikuje.
Sfałszowane IDID odwiedzającego wysłane przez przeglądarkę jest nieznane Tracio — deklaracja wygląda na sfałszowaną.

Podłączane są dwa klucze: publiczny, który aktywuje SDK w widgecie, oraz sekretny klucz Data API używany do serwerowej kontroli werdyktu. Bez kontroli serwerowej deklaracji przeglądarki "to nie bot" nie można ufać samej w sobie — a gdy deklaracja przeglądarki nie zgadza się z werdyktem serwera, karta pokazuje oba.

Tracio działa tylko dla rozmów z widgetu czatu. E-mail, Telegram i inne kanały nie mają odwiedzającego do sprawdzenia, więc ich karta Tracio wyjaśnia, że nie ma czego kontrolować. Brak werdyktu to nie podejrzenie: blokery reklam regularnie odcinają SDK prawdziwym ludziom, a starsze rozmowy rozpoczęte przed podłączeniem Tracio też nie mają werdyktu.
SDK Tracio pobiera odciski (fingerprint) odwiedzających Twoją witrynę. Uzyskanie zgody odwiedzających (przez CMP / baner cookies) to Twoja odpowiedzialność jako właściciela witryny.

Ograniczenia#

  • Karty Stripe i Shopify są tylko do odczytu — jedynym zapisem w całej aplikacji Stripe jest opcjonalna, jawnie włączana akcja zwrotu.
  • Aplikacje kluczujące po e-mailu (Stripe, Shopify, Mailchimp, MailerLite) potrzebują zweryfikowanego adresu e-mail. Rozmowy anonimowych odwiedzających widget lub kanałów bez adresu pokazują uczciwą kartę "nie ma czego wyszukać".
  • Wsparcie Jira obejmuje wyłącznie Jira Cloud.
  • Mailchimp nie oferuje ponownego zapisu: po wypisaniu tylko sama osoba może zapisać się z powrotem przez formularz. Jeśli ten przepływ jest dla Ciebie ważny, użyj ponownego zapisu w MailerLite.
  • Werdykty Tracio istnieją tylko dla rozmów z widgetu z załadowanym SDK — nigdy dla kanałów e-mail czy komunikatorów.