დოკუმენტაცია

Perla-ს დაკავშირება კლინიკის საიტთან

რეგისტრაციიდან მომუშავე ჩატამდე თქვენს საიტზე. ნაბიჯ-ნაბიჯ, ეკრანის სურათებითა და მაგალითებით ყველა გავრცელებული პლატფორმისთვის.

≈ 10 წუთიდეველოპერი არ არის საჭირო

როგორ მუშაობს

სამი რამ, რისი გაგებაც ღირს სანამ რამეს ჩასვამთ.

კლინიკის პროფილი არის ჭეშმარიტების წყარო

საათები, მისამართი, ექიმები, სერვისები ფასებით, სადაზღვევოები და გადაცემის წესები. Perla პაციენტებს მხოლოდ ამ მონაცემებიდან პასუხობს და არაფერს იგონებს. რაც უფრო სრულია პროფილი, მით უფრო ზუსტია პასუხები.

გასაღები აკავშირებს ვიჯეტს თქვენს კლინიკასთან

თითოეული კლინიკა იღებს საკუთარ გასაღებს სახით pk_live_… ის საჯაროა: ის თქვენი საიტის კოდშია და ეს ნორმალურია. გასაღები იძლევა ზუსტად ერთ უფლებას — თქვენი კლინიკის სახელით საუბარს, მეტს არაფერს.

ვიჯეტი იზოლირებულია თქვენი საიტისგან

ჩატი იტვირთება საკუთარ ფანჯარაში (iframe), რომელსაც getperla.eu ემსახურება. ამიტომ თქვენი საიტის CSS ვერასდროს გატეხავს ჩატს, ხოლო ჩატის CSS ვერასდროს შეეხება თქვენს საიტს. ერთი ხაზი კოდი და მორჩა.

ნაბიჯ-ნაბიჯ

ეკრანის სურათები რეალური ინტერფეისიდან. ნარინჯისფერი აჩვენებს, სად დააჭიროთ.

დააჭირეთ „უფასოდ დაწყება“

გახსენით getperla.eu და დააჭირეთ ღილაკს მარჯვენა ზედა კუთხეში. დასაწყებად ბარათი არ არის საჭირო.

შექმენით კლინიკის ანგარიში

შეიყვანეთ კლინიკის სახელი, სამუშაო ფოსტა და პაროლი მინიმუმ 8 სიმბოლოთი. სახელი გამოჩნდება ჩატის სათაურში, რომელსაც პაციენტები ხედავენ — ამიტომ დაწერეთ ისე, როგორც გინდათ რომ წაიკითხონ.

შეავსეთ პროფილი და დააკოპირეთ გასაღები

შესვლის შემდეგ მოხვდებით მთავარ გვერდზე. გაიარეთ ოთხივე პუნქტი — პროფილი, სამუშაო საათები, ექიმები, სერვისები და ფასები. შემდეგ ჩადით გვერდის ბოლოში: იქ არის ბლოკი „ინტეგრაციის გასაღები“. დააჭირეთ „კოპირება“.

შეავსეთ პროფილი გაშვებამდე

თუ ფასების სია ან საათები ცარიელია, Perla პატიოსნად ეტყვის პაციენტს, რომ რეგისტრატურა დააზუსტებს — ციფრის მოგონების ნაცვლად. ეს სწორი ქცევაა, მაგრამ სრული პროფილით შედეგი ბევრად უკეთესი იქნება.

კოდის ჩასმა თქვენს საიტზე

აირჩიეთ პლატფორმა და გაჩვენებთ, ზუსტად სად ჩაისმება.

თქვენი პლატფორმა

1გახსენით გვერდის ფაილი — ჩვეულებრივ index.html ან საერთო შაბლონი (footer, layout).
2ჩასვით კოდი უშუალოდ დამხურავ </body> ტეგამდე.
3თუ რამდენიმე გვერდი გაქვთ და საერთო შაბლონი არ არის, დაამატეთ კოდი თითოეულ გვერდზე.
4შეინახეთ და ატვირთეთ ფაილები სერვერზე.
თუ საერთო footer ფაილი გაქვთ, ჩასვით იქ ერთხელ და ჩატი ყველგან გამოჩნდება.

index.html

<!-- Perla -->
<script
  src="https://getperla.eu/widget.js"
  data-perla-key="pk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
  defer
></script>

pk_live_… ჩაანაცვლეთ კაბინეტიდან აღებული გასაღებით. იგივე კოდი ემატება საიტის ყველა გვერდზე.

ვიჯეტის პარამეტრები

ყველაფერი იწერება უშუალოდ script ტეგზე.

ატრიბუტი	სავალდებულო	რას აკეთებს
`data-perla-key`	კი	თქვენი კლინიკის გასაღები კაბინეტიდან. მის გარეშე ვიჯეტი არ ჩაირთვება.
`data-perla-lang`	არა	ჩატის ინტერფეისის ენა: ka, uk, cs, en, ru ან de. თუ არ მიუთითებთ, გამოიყენება პირველი ენა თქვენი კლინიკის პროფილიდან. ეს არ მოქმედებს თავად პასუხებზე — Perla ყოველთვის პასუხობს იმ ენაზე, რომელზეც პაციენტი წერს.
`defer`	არა	დატოვეთ როგორც არის. ვიჯეტი მაშინ ძირითადი შიგთავსის შემდეგ იტვირთება და გვერდის ჩვენებას არ შეანელებს.

კონვერსიების თვალთვალი Google Analytics-ში

ჩატი მუშაობს iframe-ში Perla-ს საკუთარ დომენზე, ამიტომ თქვენი ანალიტიკა მის შიგნით ვერ იხედება. ამიტომ ვიჯეტი მნიშვნელოვან მოქმედებებს თავად თქვენს გვერდს ატყობინებს — dataLayer-ში და gtag-ში, თუ ის არსებობს. ჩვენს მხარეს ჩასართავი არაფერია; მოვლენები თავიდანვე მუშაობს.

`perla_chat_opened`	პაციენტმა გახსნა ჩატის ფანჯარა
`perla_message_sent`	პაციენტმა გააგზავნა პირველი შეტყობინება — ერთხელ საუბარზე, და არა ყოველ სტრიქონზე
`perla_booking_request`	პაციენტმა დატოვა სახელი და ტელეფონის ნომერი — ეს არის კონვერსია

GA4-ში დაყენება Google Tag Manager-ით

1GTM-ში შექმენით ტრიგერი: Trigger → New → Custom Event, Event name — perla_booking_request.
2შექმენით ტეგი: Tag → New → Google Analytics: GA4 Event, აირჩიეთ თქვენი კონფიგურაციის ტეგი, Event Name — perla_booking_request.
3მიამაგრეთ ტრიგერი ტეგს და გამოაქვეყნეთ კონტეინერი (Submit → Publish).
4GA4-ში გახსენით Admin → Events, დარწმუნდით, რომ მოვლენა პირველი მოთხოვნის შემდეგ ჩნდება, და მონიშნეთ ის მთავარ მოვლენად.

Google Ads-ში გადატანა

1მონიშნეთ perla_booking_request GA4-ში მთავარ მოვლენად — სხვაგვარად Ads მას ვერ დაინახავს.
2Google Ads-ში: Goals → Conversions → Import → Google Analytics 4 → აირჩიეთ perla_booking_request.
3დაელოდეთ პირველ რეალურ მოთხოვნას: სანამ ის არ მოხდება, მოვლენა იმპორტის სიაში არ გამოჩნდება.

მოვლენები არანაირ პერსონალურ მონაცემს არ ატარებს — არც სახელს, არც ტელეფონს, არც შეტყობინების ტექსტს. მხოლოდ მოვლენის სახელი და საუბრის იდენტიფიკატორი, რომ კონვერსია კაბინეტში მოთხოვნას დაუკავშიროთ.

შემოწმება, რომ მუშაობს

კოდის ჩასმიდან სამ წუთში.

1
ღილაკი გამოჩნდა
გახსენით კლინიკის საიტი ახალ ჩანართში. მარჯვენა ქვედა კუთხეში უნდა გამოჩნდეს მრგვალი ღილაკი რობოტით. თუ კოდი ახლა ჩასვით, განაახლეთ გვერდი Ctrl+Shift+R-ით (Mac-ზე Cmd+Shift+R).
2
ჩატი პასუხობს თქვენი მონაცემებით
დააჭირეთ ღილაკს და იკითხეთ ის, რაც პროფილშია: „რა ღირს ჰიგიენა?“ ან „შაბათს მუშაობთ?“. პასუხი უნდა ემთხვეოდეს იმას, რაც შეიყვანეთ.
3
საუბარი ჩანს კაბინეტში
დაბრუნდით კაბინეტში, განყოფილება „საუბრები“. თქვენი სატესტო ჩატი იქ უნდა იყოს. სცადეთ ჩაწერაც — მიუთითეთ სახელი და ტელეფონი, და იმავე ადგილას გამოჩნდება მოთხოვნა.

რა შეუძლია Perla-ს და რა — არა

ვწერთ პირდაპირ, რომ პაციენტების წინაშე სიურპრიზი არ იყოს.

მუშაობს დღეს

პასუხობს კითხვებს ფასებზე, სამუშაო საათებზე, მისამართზე, ექიმებსა და სადაზღვევოებზე — თქვენი პროფილიდან
საუბრობს პაციენტის ენაზე: ქართული, ინგლისური, რუსული, უკრაინული, ჩეხური, გერმანული
აგროვებს ჩაწერის მოთხოვნას: სახელი, ტელეფონი და დაახლოებითი დრო, და აჩვენებს კაბინეტში
გადასცემს საუბარს რეგისტრატურას თქვენივე წესებით — მაგალითად, მწვავე ტკივილი ან პრეტენზია
მუშაობს დღე-ღამე, ღამითა და შაბათ-კვირას, როცა რეგისტრატურა დაკეტილია

შეგნებულად არ აკეთებს

არ წერს თქვენს კალენდარში — მოთხოვნას ტელეფონით ადამიანი ადასტურებს
არ სვამს დიაგნოზს და არ ურჩევს მკურნალობას: ეს ექიმის საქმეა, და არა რეგისტრატორის
არ ასახელებს ფასს, რომელიც თქვენს სიაში არ არის — ამბობს, რომ რეგისტრატურა დააზუსტებს
არ იღებს ონლაინ გადახდებს

ხშირი კითხვები

უსაფრთხოა გასაღების შენახვა საიტის კოდში?+

დიახ. pk_live_… საჯარო გასაღებია და სწორედ იმისთვისაა, რომ გვერდის კოდში ჩანდეს — ისევე, როგორც Google Maps-ის ან Stripe-ის საჯარო გასაღები. ის იძლევა ზუსტად ერთ უფლებას: თქვენი კლინიკის სახელით საუბარს. მას არ შეუძლია თქვენი საუბრების წაკითხვა, პროფილის შეცვლა ან კაბინეტში შესვლა. ასევე არსებობს შეტყობინებების ლიმიტი წუთში, რომ ვერავინ ბოროტად გამოიყენოს.

შეანელებს ვიჯეტი ჩემს საიტს?+

არა. ფაილი რამდენიმე კილობაიტია და იტვირთება defer ატრიბუტით — ანუ მას შემდეგ, რაც გვერდი ვიზიტორს უკვე გამოუჩნდა. თავად ჩატი ცალკე ფანჯარაში იტვირთება და თქვენს საიტს არასდროს აფერხებს.

ვიჯეტი არ გამოჩნდა. რა ვქნა?+

შეამოწმეთ სამი რამ. პირველი: კოდი უნდა იყოს დამხურავ </body> ტეგამდე და არა HEAD-ში. მეორე: Tilda-სა და Webflow-ზე კოდის შენახვის შემდეგ საიტი ცალკე უნდა გამოაქვეყნოთ. მესამე: განაახლეთ გვერდი Ctrl+Shift+R-ით. თუ არ დაეხმარა, გახსენით ბრაუზერის კონსოლი (F12) და მოძებნეთ შეტყობინება, რომელიც იწყება [Perla]-თი.

შემიძლია ღილაკის ფერის შეცვლა?+

დიახ. კაბინეტში გახსენით განყოფილება „ვიჯეტი“ და აირჩიეთ ფერი — პალიტრიდან ან თქვენი. ის მაშინვე გამოჩნდება საიტზე, კოდის შეცვლის გარეშე.

შემიძლია ვიჯეტის დადება რამდენიმე საიტზე ერთი კლინიკისთვის?+

დიახ, ერთი გასაღები მუშაობს ნებისმიერი რაოდენობის გვერდსა და დომენზე. ყველა საუბარი ერთ კაბინეტში ხვდება.

სად ინახება პაციენტების მონაცემები?+

საუბრები და ჩაწერის მოთხოვნები ინახება ევროკავშირის სერვერებზე. Perla პაციენტს არასდროს სთხოვს ბარათის ნომერს, პირადობის დოკუმენტებს ან სამედიცინო ისტორიას — მხოლოდ სახელსა და ტელეფონს დასარეკად.

რამე არ გამოგივიდათ?

მოგვწერეთ — ერთად გავარკვევთ და საჭიროების შემთხვევაში ვიჯეტს ჩვენ ჩაგირთავთ.

დაგვიკავშირდით მთავარ გვერდზე