Τεκμηρίωση

Η τεκμηρίωση περιλαμβάνει γραφικό στοιχείο 1.2.0, προσθήκες CMS 1.1.0 και έκδοση API 1.2.0. Τελευταία ενημέρωση: Ιούλιος 2026.

Γρήγορη εκκίνηση

Το CallFlow είναι ένα δωρεάν widget επανάκλησης με αυτόματη ουρά κλήσεων. Ένας επισκέπτης στον ιστότοπό σας αφήνει έναν αριθμό τηλεφώνου και το αίτημα πηγαίνει αμέσως στην εφαρμογή CallFlow στο τηλέφωνό σας. Η εκκίνηση διαρκεί λίγα λεπτά και αποτελείται από τρία βήματα:

1. Δημιουργήστε έναν λογαριασμό - στην εφαρμογή CallFlow για Android ή νεότερη έκδοση web panel. Ο λογαριασμός είναι δωρεάν.
2. Προσθήκη σελίδας - Στην ενότητα "Πακέτα και Σελίδες", προσθέστε τη διεύθυνση του ιστότοπού σας και αντιγράψτε το κλειδί συντόμευσης ξεκινώντας με CF-. To publiczny klucz strony (PUBLIC_SITE_KEY) — pozwala wyłącznie wysyłać nowe zgłoszenia, nie daje dostępu do Twojego konta.
3. Επικολλήστε το σενάριο - Τοποθετήστε τον ακόλουθο κώδικα αμέσως πριν από την ετικέτα </body> swojej strony i podmień klucz oraz adres polityki prywatności.

<script

  src="https://callflowdesk.com/widget/widget.js"

  data-site-key="CF-TWOJ-KLUCZ"

  data-variant="floating"

  data-privacy-url="https://twoja-strona.pl/polityka-prywatnosci/">

</script>

Αυτό είναι αρκετό. Ένα αιωρούμενο κουμπί θα εμφανιστεί στον ιστότοπο και κάθε αναφορά θα ενεργοποιεί μια ειδοποίηση push στην εφαρμογή.

Γραφικό στοιχείο HTML/JS

CallFlow 1.2.0 είναι ένα σενάριο παραγωγής για κανονικές σελίδες HTML. Δεν απαιτεί πλαίσιο ή εξωτερικές βιβλιοθήκες. Η φόρμα εκτελείται σε ένα απομονωμένο Shadow DOM - δεν παρεμβαίνει στο CSS του ιστότοπού σας - και μπορεί να στείλει νέα αιτήματα μόνο μέσω του δημόσιου CallFlow API.

Βασική εγκατάσταση (Κινούμενο γραφικό στοιχείο)

Επικόλληση σεναρίου πριν </body> — dokładnie tak jak w Γρήγορη εκκίνηση. Προεπιλεγμένη παραλλαγή floating wyświetla pływający przycisk w rogu ekranu, który otwiera formularz.

Ενσωματωμένη παραλλαγή στο περιεχόμενο

Εάν θέλετε να τοποθετήσετε τη φόρμα σε ένα συγκεκριμένο μέρος της σελίδας (π.χ. στην υποσελίδα επαφής), προσθέστε ένα κενό κοντέινερ και υποδείξτε το με το χαρακτηριστικό data-target:

<div id="callback"></div>

<script

  src="https://callflowdesk.com/widget/widget.js"

  data-site-key="CF-TWOJ-KLUCZ"

  data-target="#callback"

  data-variant="box">

</script>

Διαθέσιμες παραλλαγές

• floating — pływający przycisk otwierający formularz (domyślny);
• box — pełny formularz w miejscu osadzenia;
• compact — mniejszy formularz do stopki lub sidebara;
• sticky — pasek przy dolnej krawędzi ekranu;
• ecommerce — pływający formularz przeznaczony dla karty produktu.

Μπορείτε να παρακολουθήσετε όλες τις παραλλαγές ζωντανά στον ιστότοπο Επίδειξη γραφικού στοιχείου.

Πίνακας χαρακτηριστικών πλήρους διαμόρφωσης

Οι ρυθμίσεις επείγουσας ανάγκης και πολιτικής απορρήτου ανακτώνται επιπλέον από το CallFlow. Ο χρήστης του ιστότοπου δεν μπορεί να ενεργοποιήσει μια λειτουργία που έχει απενεργοποιηθεί από τον κάτοχο του λογαριασμού.

Ασφάλεια και Απόρρητο

• δεν διαβάζει δεδομένα λογαριασμού ή λίστα εισιτηρίων.
• σάς επιτρέπει μόνο να δημιουργήσετε ένα εισιτήριο.
• πραγματοποιείται μέσω HTTPS.
• η φόρμα περιέχει ένα honeypot και απαιτεί ρητή συγκατάθεση για επικοινωνία.
• το γραφικό στοιχείο δεν αποθηκεύει cookies και δεν χρησιμοποιεί τοπικό χώρο αποθήκευσης.
• κανονικοποιείται και επικυρώνεται εκ νέου από το API. Απαντήσεις μορφής
• έχει χρονικό όριο 15 δευτερολέπτων και ένα κλειδί ανικανότητας για προστασία από διπλότυπα.

Προσαρμογή εμφάνισης

Από την έκδοση 1.2.0, το γραφικό στοιχείο κληρονομεί τη γραμματοσειρά από τον ιστότοπο από προεπιλογή (inherit, awaryjnie system-ui), a wygląd można dopasować na dwóch poziomach: Εύκολο (απλά χαρακτηριστικά) i Για προχωρημένους (CSS πλήρους φάσματος). Τα χαρακτηριστικά εξατομίκευσης μπορούν να τοποθετηθούν στην ετικέτα <script> ή στον στόχο που καθορίζεται από data-target (atrybut na elemencie docelowym ma pierwszeństwo). Bez tych atrybutów widget wygląda tak jak dotychczas.

Εύκολο επίπεδο - χρώματα, διαστάσεις, γραμματοσειρά

Κάθε χαρακτηριστικό είναι προαιρετικό και αντιστοιχίζεται σε ένα σύνολο μεταβλητών CSS στο στοιχείο κεντρικού υπολογιστή γραφικού στοιχείου (.callflow-widget-host):

Παράδειγμα αντιστοίχισης του γραφικού στοιχείου στη σκοτεινή πλευρά με χρυσούς τόνους:

<div id="callback"

  data-accent="#c8953f"

  data-accent-text="#0b0b09"

  data-bg="#11181d"

  data-text="#f4f4f1"

  data-muted="#a9b0b4"

  data-border-color="rgba(255,255,255,.14)"

  data-radius="0px"

  data-shadow="none"></div>

<script

  src="https://callflowdesk.com/widget/widget.js"

  data-site-key="CF-TWOJ-KLUCZ"

  data-target="#callback"

  data-variant="box">

</script>

Οι ίδιες μεταβλητές διαπερνούν το Shadow DOM μέσω κληρονομικότητας CSS, επομένως αντί για χαρακτηριστικά μπορείτε να χρησιμοποιήσετε καθαρό CSS σελίδας (φύλλο ή <style>):

#moj-kontener {

  --callflow-accent: #b8860b;

  --callflow-radius: 4px;

  --callflow-max-width: 460px;

}

Σειρά προτεραιότητας: χαρακτηριστικό data-* na elemencie docelowym → atrybut data-* na tagu <script> → zmienna CSS strony → starsze atrybuty data-*-color → wartości domyślne.

Προηγμένο επίπεδο - πλήρες φάσμα CSS

::part() - Τα σημαντικά στοιχεία φόρμας έχουν χαρακτηριστικά part, więc strona może je stylować dowolnym CSS bez ograniczeń Shadow DOM. Dostępne nazwy części:

container, title, subtitle, form, field, label, phone-label, input, phone-input, urgent-field, urgent-checkbox, urgent-reason-label, urgent-reason-input, checkbox, checkbox-input, consent, consent-input, link, privacy-link, button, submit-button, status, close-button, floating-trigger, launch-button, sticky-bar, sticky-copy, action-button, config-error.

.callflow-widget-host::part(submit-button) {

  background: linear-gradient(135deg, #e0b96f, #c8953f);

  text-transform: uppercase;

  letter-spacing: .06em;

}

.callflow-widget-host::part(title) {

  font-weight: 500;

}

data-custom-css - ακατέργαστο CSS που εισάγεται στο Shadow DOM μετά από βασικά στυλ (καταρράκτες κερδίζει, επηρεάζει τους εσωτερικούς επιλογείς γραφικών στοιχείων):

<div id="callback"

  data-custom-css=".cf-panel{border:0;padding:14px} .cf-submit{letter-spacing:.06em}"></div>

data-css-href - Διεύθυνση του εξωτερικού φύλλου που έχει φορτωθεί στο Shadow DOM. Για λόγους ασφαλείας, γίνονται δεκτές μόνο διευθύνσεις https:// oraz ścieżki względne; http://, javascript: i inne schematy są odrzucane.

<script

  src="https://callflowdesk.com/widget/widget.js"

  data-site-key="CF-TWOJ-KLUCZ"

  data-css-href="https://twoja-strona.pl/assets/callflow-theme.css">

</script>

Σειρά στυλ σκιάς DOM: βασικά στυλ → φύλλο z data-css-href → data-custom-css. Personalizacja jest w pełni opcjonalna i wstecznie kompatybilna — istniejące osadzenia działają bez zmian.

Συμβάντα JavaScript

Το γραφικό στοιχείο εκπέμπει συμβάντα στο στοιχείο κεντρικού υπολογιστή και τα διαδίδει στο έγγραφο, ώστε να μπορείτε, για παράδειγμα, να στείλετε μια μετατροπή στο σύστημα ανάλυσης μετά από μια επιτυχημένη αναφορά:

document.addEventListener('callflow:submitted', (event) => {

  console.log(event.detail.receiptId);

});



document.addEventListener('callflow:error', (event) => {

  console.warn(event.detail.code);

});

Διαθέσιμα συμβάντα:

• callflow:open — formularz został otwarty;
• callflow:close — formularz został zamknięty;
• callflow:submitted — zgłoszenie zostało przyjęte (w event.detail.receiptId znajdziesz identyfikator potwierdzenia);
• callflow:error — wysyłka się nie powiodła (w event.detail.code znajdziesz kod błędu).

Προσθήκη WordPress

CallFlow 1.1.0 προσθέτει ένα γραφικό στοιχείο σε ολόκληρο τον ιστότοπό σας στο WordPress χωρίς επεξεργασία του προτύπου. Υποστηρίζει παραλλαγές floating, box, sticky i compact oraz osadzanie formularza w treści przez shortcode.

Απαιτήσεις

• WordPress 6.0 ή νεότερη έκδοση.
• PHP 7.4 ή νεότερη έκδοση (δοκιμασμένο σε PHP 7.4 και 8.3).
• Το κλειδί τοποθεσίας CF-… utworzony w aplikacji CallFlow.

Εγκατάσταση βήμα προς βήμα

1. Κάντε λήψη της προσθήκης - αρχείο callflow-wordpress-1.1.0.zip znajdziesz w sekcji Λήψη.
2. Εγκατάσταση στον πίνακα ελέγχου του WordPress - μεταβείτε στο Προσθήκες → Προσθήκη νέας προσθήκης → Μεταφόρτωση προσθήκης στον διακομιστή, τοποθετήστε το δείκτη στο ληφθέν αρχείο ZIP, κάντε κλικ Εγκατάστασηκαι μετά την εγκατάσταση Ενεργοποίηση.
3. Διαμόρφωση - μεταβείτε στο Ρυθμίσεις → CallFlow και:
   • επικολλήστε το κλειδί στο πλαίσιο PUBLIC_SITE_KEY (μορφή CF-XXXX-XXXX);
   • επιλέξτε Απαιτείται Παραλλαγή (προεπιλογή floating);
   • εισάγετε τη διεύθυνση Πολιτική απορρήτου του ιστότοπού σας.
   • Ενεργοποιήστε το γραφικό στοιχείο καθολικά και κάντε κλικ Αποθήκευση αλλαγών.

Ενσωμάτωση σε περιεχόμενο (σύντομος κώδικας)

Για να εμφανίσετε μια φόρμα μέσα σε μια ανάρτηση ή σελίδα, χρησιμοποιήστε τον σύντομο κωδικό:

[callflow variant="box"]

Η χρήση του συντόμου απενεργοποιεί αυτόματα το δεύτερο, καθολικό γραφικό στοιχείο σε αυτήν την υποσελίδα - η φόρμα δεν θα αντιγραφεί ποτέ.

Συνήθη προβλήματα

• Το κλειδί δεν αποθηκεύεται - Η προσθήκη επικυρώνει τη μορφή: το κλειδί πρέπει να ξεκινά με CF- i zawierać wyłącznie wielkie litery, cyfry i myślniki. Skopiuj go ponownie z aplikacji, bez spacji.
• Το γραφικό στοιχείο δεν εμφανίζεται στη σελίδα - πεδίο ελέγχου Ενεργοποιήστε το γραφικό στοιχείο καθολικά είναι επιλεγμένο και το κλειδί δεν είναι κενό. Εάν χρησιμοποιείτε μια προσθήκη προσωρινής μνήμης (π.χ. LiteSpeed, WP Super Cache), διαγράψτε την προσωρινή μνήμη αφού αποθηκεύσετε τις ρυθμίσεις σας.
• Το γραφικό στοιχείο εμφανίζεται δύο φορές - έχετε επίσης ενεργή την προσθήκη CallFlow for WooCommerce. βλέπε ενότητα WooCommerce.

Προσθήκη WooCommerce

Το CallFlow for WooCommerce 1.1.0 είναι μια προσθήκη προσαρμοσμένη για καταστήματα - χρησιμοποιεί την παραλλαγή ecommerce z nagłówkiem zachęcającym do pytania o produkt. Wersja 1.1.0 jest publiczną betą przeznaczoną do testów na sklepie stagingowym.

Απαιτήσεις

• WordPress 6.0 ή νεότερη έκδοση, PHP 7.4 ή νεότερη έκδοση (δοκιμασμένο σε PHP 7.4 και 8.3).
• ενεργό πρόσθετο WooCommerce (απαιτείται - χωρίς αυτό το γραφικό στοιχείο δεν θα εμφανίζεται).
• Το κλειδί τοποθεσίας CF-… z aplikacji CallFlow.

Εγκατάσταση βήμα προς βήμα

1. Κάντε λήψη της προσθήκης - αρχείο callflow-woocommerce-1.1.0.zip z sekcji Λήψη.
2. Εγκατάσταση — Προσθήκες → Προσθήκη νέας προσθήκης → Μεταφόρτωση προσθήκης στον διακομιστή, επιλέξτε ZIP, Εγκατάσταση, Ενεργοποίηση.
3. Διαμόρφωση - μεταβείτε στο Ρυθμίσεις → CallFlow WooCommerce και:
   • PUBLIC_SITE_KEY;
   • επιλέξτε Απαιτείται Παραλλαγή: ecommerce (domyślny), floating lub sticky;
   • ορίστε το δικό σας Ρύθμιση σελίδας Κεφαλίδα φόρμα (προεπιλογή "Έχετε μια ερώτηση σχετικά με το προϊόν;");
   • Ενεργοποιήστε το γραφικό στοιχείο αποθήκευσης και αποθηκεύστε.

Λειτουργεί με τη βασική προσθήκη CallFlow

Και οι δύο προσθήκες μπορούν να είναι ενεργές ταυτόχρονα. Όταν το γραφικό στοιχείο WooCommerce είναι ενεργοποιημένο, απενεργοποιεί αυτόματα το καθολικό γραφικό στοιχείο της υποκείμενης προσθήκης, επομένως η φόρμα δεν θα εμφανίζεται ποτέ δύο φορές. Εάν αφήσετε κενό το πεδίο κλειδιού στις ρυθμίσεις WooCommerce, η προσθήκη θα χρησιμοποιήσει το κλειδί από τη βασική προσθήκη CallFlow.

Συνήθη προβλήματα

• Το γραφικό στοιχείο δεν εμφανίζεται - βεβαιωθείτε ότι το WooCommerce είναι εγκατεστημένο και ενεργό. το πρόσθετο εμφανίζει το γραφικό στοιχείο μόνο όταν εκτελείται το WooCommerce.
• Δύο γραφικά στοιχεία ταυτόχρονα - ενημερώστε και τα δύο πρόσθετα στην έκδοση 1.1.0. Οι παλαιότερες εκδόσεις δεν συντόνιζαν την ορατότητα. Εναλλακτικά, καταργήστε την επιλογή "Ενεργοποίηση γραφικού στοιχείου παγκοσμίως" στην υποκείμενη προσθήκη.
• Αυτό είναι beta - δοκιμάστε το πρόσθετο πρώτα σε ένα αντίγραφο σταδιοποίησης του καταστήματος πριν το ενεργοποιήσετε στην παραγωγή.

Ενότητα PrestaShop 8

Η μονάδα CallFlow 1.1.0 beta ενσωματώνει ένα γραφικό στοιχείο παραγωγής στο υποσέλιδο του καταστήματος PrestaShop (άγκιστρο displayFooter). Obsługuje warianty ecommerce, floating i sticky.

Απαιτήσεις

• PrestaShop 8.0 ή νεότερη έκδοση.
• Το κλειδί τοποθεσίας CF-… z aplikacji CallFlow;
• εγκαταστήστε την έκδοση beta πρώτα στο κατάστημα εγκατάστασης.

Εγκατάσταση βήμα προς βήμα

1. Λήψη ενότητας - αρχείο callflow-prestashop8-1.1.0.zip z sekcji Λήψη.
2. Εγκατάσταση στον πίνακα - μεταβείτε στο Modules → Module Manager → Load Module και τοποθετήστε το δείκτη του ποντικιού στο ZIP που κατεβάσατε. Θα βρείτε την ενότητα στην κατηγορία "Διαφήμιση και μάρκετινγκ".
3. Διαμόρφωση - κάντε κλικ Διαμόρφωση για τη μονάδα CallFlow και: κανονισμούς
   • PUBLIC_SITE_KEY;
   • επιλέξτε Απαιτείται Παραλλαγή: Ηλεκτρονικό εμπόριο (προεπιλογή), Κυμαινόμενο ή Κολλώδες.
   • Κεφαλίδα γραφικού στοιχείου (προεπιλογή "Έχετε μια ερώτηση σχετικά με αυτό το προϊόν;" - πληκτρολογήστε τη δική σας στα πολωνικά).
   • διευκρινίστε διεύθυνση πολιτικής απορρήτου κατάστημα; Το σενάριο
   • ρύθμιση διακόπτη Ενεργοποιήθηκε στο "Ναι" και κάντε κλικ κεφαλίδα Αποθήκευση.

Συνήθη προβλήματα

• Σφάλμα "Το κλειδί CallFlow πρέπει να ξεκινά με CF-" - η ενότητα επικυρώνει τη μορφή κλειδιού. αντιγράψτε το από την εφαρμογή χωρίς κενά.
• Το γραφικό στοιχείο δεν εμφανίζεται μετά την αποθήκευση - διαγραφή της προσωρινής μνήμης αποθήκευσης (Για προχωρημένους → Απόδοση → Εκκαθάριση προσωρινής μνήμης) και ελέγξτε ότι ο διακόπτης Enabled έχει οριστεί σε "Ναι".
• Το θέμα δεν καλεί το υποσέλιδο - το γραφικό στοιχείο είναι συνδεδεμένο στο άγκιστρο displayFooter; jeśli Twój motyw go nie renderuje, podepnij moduł do innego hooka w Εμφάνιση → Είδη.

Άλλες πλατφόρμες

Οι ακόλουθες ενσωματώσεις είναι τεχνικές beta εκδόσεις της 1.1.0 - εγκαταστήστε τις πρώτα στο περιβάλλον σταδιακής λειτουργίας σας. Θα βρείτε όλα τα πακέτα στην ενότητα Λήψη.

Drupal 10/11

Αφού εγκαταστήσετε τη λειτουργική μονάδα, μεταβείτε στο Διαμόρφωση → Υπηρεσίες δικτύου → CallFlow, επικολλήστε το δημόσιο κλειδί του ιστότοπου και επιλέξτε μια παραλλαγή.

Joomla 4/5

Μετά την εγκατάσταση, ενεργοποιήστε την προσθήκη Σύστημα - CallFlow (v Σύστημα → Πρόσθετα), επικόλληση PUBLIC_SITE_KEY, wybierz wariant i podaj adres polityki prywatności.

Magento 2 / Adobe Commerce

Αντιγραφή ενότητας σε app/code/CallFlow/Callback, uruchom bin/magento setup:upgrade i skonfiguruj go w Stores → Configuration → General → CallFlow. Η λειτουργική μονάδα περιέχει μια λευκή λίστα CSP για το σενάριο και το API samael.pl, więc nie musisz ręcznie modyfikować polityki bezpieczeństwa treści.

e107 2.3

Μετά την εγκατάσταση, ανοίξτε τη διαμόρφωση CallFlow, επικολλήστε το κλειδί CF-…, wybierz wariant i włącz widget.

Στράπη 4/5

παρέχει δημόσια διαμόρφωση pod /api/callflow/config (endpoint nie ujawnia żadnych danych konta ani zgłoszeń). Ustaw zmienne środowiskowe CALLFLOW_SITE_KEY oraz opcjonalnie CALLFLOW_VARIANT, a we frontendzie użyj:

import {mountCallFlow} from 'strapi-plugin-callflow/client';

await mountCallFlow();

Shopify

Το πακέτο περιλαμβάνει πηγαίος κώδικας Επέκταση εφαρμογής θέματος (ενσωμάτωση εφαρμογής για κινούμενο γραφικό στοιχείο και μπλοκ εφαρμογών με μια φόρμα ενσωματωμένη στην ενότητα) - δεν πρόκειται για πρόγραμμα εγκατάστασης καταστήματος. Η ανάπτυξη απαιτεί την εφαρμογή Shopify Partner και το κατάστημα προγραμματιστών:

shopify app dev

shopify app deploy

Μετά την εγκατάσταση, ο πωλητής ενεργοποιεί το CallFlow στο Ρυθμίσεις θέματος → Ενσωματώσεις εφαρμογών ή προσθέτει ένα μπλοκ φόρμας σε μια ενότητα θέματος.

API για προγραμματιστές

CallFlow παρέχει REST API έκδοση 1.2.0 - το ίδιο συμβόλαιο εξουσιοδοτεί την εφαρμογή για κινητά και τα δημόσια γραφικά στοιχεία.

Βασικά στοιχεία

• Βασική διεύθυνση URL: https://callflowdesk.com/api/v1
• Έλεγχος ταυτότητας: Ο αριθμός Authorization: Bearer <access_token> (JWT). Token uzyskasz przez POST /auth/login, a odświeżysz przez POST /auth/refresh z refresh_token.
• Χωρίς διακριτικό λειτουργεί μόνο: /auth/register, /auth/login, /auth/refresh oraz /public/leads.
• Σφάλματα: application/problem+json z polami type, title, status, code, detail, trace_id i (dla walidacji) errors.
• Σελιδοποίηση: επιστρέφουν next_cursor; kolejną stronę pobierzesz parametrem zapytania cursor.

Auth - Εγγραφή και κύκλος ζωής περιόδου σύνδεσης

Λογαριασμός - Κύριος λογαριασμός, δευτερεύοντες λογαριασμοί και στατιστικά στοιχεία

Πηγές - Ιστότοποι και πακέτα επαφών

Δυνητικοί πελάτες - αιτήματα επανάκλησης και η κατάστασή τους

Χρονοδιάγραμμα - προγραμματισμός κλήσεων

Συσκευές - συσκευές push

Δημόσιο - τελικά σημεία για γραφικά στοιχεία

Παράδειγμα: σύνδεση

curl -X POST https://callflowdesk.com/api/v1/auth/login \

  -H "Content-Type: application/json" \

  -d '{"email":"jan@firma.pl","password":"TwojeBezpieczneHaslo"}'

Απάντηση 200 zawiera access_token (przekazuj go w nagłówku Authorization: Bearer …), refresh_token, czas życia expires_in (w sekundach) oraz obiekt user. Przykład żądania uwierzytelnionego:

curl https://callflowdesk.com/api/v1/leads?status=new \

  -H "Authorization: Bearer ACCESS_TOKEN"

Παράδειγμα: δημόσια αποστολή δυνητικού πελάτη

Τελικό σημείο POST /public/leads nie wymaga tokenu — identyfikuje stronę po publicznym kluczu CF-…. Nagłówek Idempotency-Key jest σήμα (16-128 χαρακτήρες, π.χ. UUID): Εάν δοκιμάσετε ξανά το αίτημα με το ίδιο κλειδί, δεν θα δημιουργηθεί διπλό αίτημα.

curl -X POST https://callflowdesk.com/api/v1/public/leads \

  -H "Content-Type: application/json" \

  -H "Idempotency-Key: 4b1f2c62-9e0a-4d7c-8f5e-6a3d2b1c0e9f" \

  -d '{

    "site_public_key": "CF-TWOJ-KLUCZ",

    "phone": "+48601234567",

    "consent": true,

    "language": "pl",

    "widget_variant": "box",

    "source_url": "https://twoja-strona.pl/kontakt",

    "urgent": false,

    "website": ""

  }'

Απαιτούμενα πεδία: site_public_key, phone, consent (musi być true), language i widget_variant. Pole website to honeypot antyspamowy — musi pozostać puste. Odpowiedź 202 zawiera receipt_id, accepted, message_key oraz opcjonalnie queue_position i estimated_callback_at.

Εφαρμογή Android

Η εφαρμογή CallFlow είναι το κέντρο εντολών για τις κλήσεις σας: εδώ πηγαίνουν όλες οι αναφορές από γραφικά στοιχεία, εδώ διαχειρίζεστε σελίδες, κλειδιά και το ημερολόγιο επανάκλησης. Η εφαρμογή θα εμφανιστεί σύντομα στο Google Play - μέχρι τότε, θα βρείτε το πακέτο εγκατάστασης στην ενότητα Λήψη.

Βασικά χαρακτηριστικά

• Ουρά κλήσεων - τα νέα αιτήματα αποστέλλονται αυτόματα στο κατάλληλο έργο και τοποθετούνται στην ουρά ανάλογα με τις ώρες εργασίας και τον αναμενόμενο χρόνο συνομιλίας. καταστάσεις (νέες, σε εξέλιξη, χειρισμοί, χαμένες, ανεπιθύμητες) οργανώνουν την εργασία.
• Πρόγραμμα - ημερολόγιο επανάκλησης με αυτόματο προγραμματισμό του επόμενου διαθέσιμου ραντεβού με ένα άγγιγμα.
• Push notifications - κάθε νέα αναφορά ενεργοποιεί αμέσως μια ειδοποίηση. Διαχειρίζεστε τη λίστα των εγγεγραμμένων συσκευών στις ρυθμίσεις και μπορείτε να ανακαλέσετε την πρόσβαση για ένα χαμένο τηλέφωνο.
• Υπολογαριασμοί - ως κάτοχος λογαριασμού (κύριος ρόλος), προσκαλείτε συναδέλφους (υπορόλος) μέσω e-mail και τους αναθέτετε επιλεγμένες σελίδες. βλέπουν μόνο πηγές και αναφορές που τους έχουν ανατεθεί.
• Εξαγωγή δεδομένων - πλήρης εξαγωγή δεδομένων λογαριασμού (σελίδες, αναφορές, χρονοδιάγραμμα, συναινέσεις) σε αρχείο JSON, σύμφωνα με τον GDPR.
• Διαγραφή λογαριασμού - μόνιμη διαγραφή του λογαριασμού με όλα τα δεδομένα απευθείας από την εφαρμογή (απαιτείται επιβεβαίωση κωδικού πρόσβασης και για λογαριασμούς Google - η φράση "ΔΙΑΓΡΑΦΗ ΛΟΓΑΡΙΑΣΜΟΥ"). λεπτομέρειες στην ενότητα Διαγράψτε τον λογαριασμό σας.

Αντιμετώπιση προβλημάτων

Το γραφικό στοιχείο δεν εμφανίζεται καθόλου

Η πιο κοινή αιτία είναι ένα μη έγκυρο κλειδί. Ελέγξτε το χαρακτηριστικό data-site-key: klucz musi zaczynać się od CF- i składać się wyłącznie z wielkich liter, cyfr i myślników (bez spacji na początku i końcu). Otwórz konsolę przeglądarki (F12) — widget zgłasza tam problemy z konfiguracją. Upewnij się też, że skrypt jest wklejony przed </body> i że adres src nie został zmieniony.

Το γραφικό στοιχείο εμφανίζει το μήνυμα "Μη έγκυρη διαμόρφωση"

Το κλειδί είναι στη σωστή μορφή αλλά δεν είναι ενεργό. Αυτό συμβαίνει όταν έχει δημιουργηθεί ένα νέο κλειδί (η περιστροφή ακυρώνει αμέσως το παλιό) ή η σελίδα έχει αρχειοθετηθεί. Μεταβείτε στις λεπτομέρειες του ιστότοπου στην εφαρμογή και αντιγράψτε τρέχον και αντικαταστήστε το στις ρυθμίσεις του κώδικα ή της προσθήκης. κλειδί τοποθεσίας

Η φόρμα λειτουργεί, αλλά οι εφαρμογές δεν φτάνουν στην εφαρμογή

Ελέγξτε την κατάσταση του ιστότοπου στην εφαρμογή: μόνο οι ενεργοί ιστότοποι δέχονται εφαρμογές. Μια σελίδα σε παύση ή αρχειοθετημένη δεν δέχεται νέους δυνητικούς πελάτες. Βεβαιωθείτε επίσης ότι δεν προβάλλετε αναφορές με φίλτρο κατάστασης ή σε δευτερεύοντα λογαριασμό χωρίς πρόσβαση σε αυτήν τη σελίδα.

Το widget εμφανίζεται δύο φορές στο WordPress με το WooCommerce

Έχετε ενεργές και τις δύο προσθήκες: το βασικό CallFlow και το CallFlow για WooCommerce. Από την έκδοση 1.1.0, η προσθήκη WooCommerce απενεργοποιεί αυτόματα το γραφικό στοιχείο καθολικής βάσης - ενημερώστε και τα δύο σε 1.1.0. Εάν το πρόβλημα παραμένει, καταργήστε την επιλογή "Ενεργοποίηση γραφικού στοιχείου καθολικά" στο Ρυθμίσεις → CallFlow. Θυμηθείτε επίσης αυτόν τον σύντομο κωδικό [callflow] sam wyłącza widget globalny na danej podstronie.

Ένα κατάστημα με περιοριστικό CSP αποκλείει το γραφικό στοιχείο

Εάν ο ιστότοπός σας στέλνει μια κεφαλίδα Content-Security-Policy, προσθέστε έναν τομέα https://samael.pl do dyrektyw script-src (skrypt widgetu) i connect-src (wysyłka zgłoszeń do API). W Magento 2 nie musisz nic robić — nasz moduł zawiera gotową whitelistę CSP.

Το γραφικό στοιχείο δεν στέλνει αναφορές στον localhost

Αυτό είναι σκόπιμα: πεδίο source_url zgłoszenia wymaga prawdziwej domeny z TLD (np. .pl, .com). Adresy typu localhost czy 127.0.0.1 nie przechodzą walidacji. Testuj widget na domenie stagingowej lub tymczasowej subdomenie — formularz i wygląd możesz oczywiście podejrzeć lokalnie.

Πώς να αλλάξετε τα χρώματα των γραφικών στοιχείων χωρίς να επεξεργαστείτε το CSS της σελίδας;

Χρησιμοποιήστε χαρακτηριστικά επιπέδου Easy απευθείας στην ετικέτα <script> (lub kontenerze data-target): data-accent zmienia kolor przewodni, data-bg tło, data-text kolor tekstu, data-radius zaokrąglenia. Pełna lista w sekcji Εξατομίκευσηκαι έτοιμα σετ δοκιμαστική γκαλερί.

Πού μπορώ να βρω το κλειδί CF του ιστότοπού μου;

Στην εφαρμογή CallFlow, ανοίξτε "Πακέτα και Σελίδες", επιλέξτε σελίδα - κλειδί CF-… jest w jej szczegółach razem z gotowym kodem instalacyjnym do skopiowania. Możesz też wysłać sobie instrukcję instalacji e-mailem prosto z aplikacji.

Δεν λαμβάνω ειδοποιήσεις push για νέες αναφορές

Ελέγξτε ότι η εφαρμογή έχει άδεια για ειδοποιήσεις στις ρυθμίσεις Android και ότι η συσκευή σας βρίσκεται στη λίστα των συσκευών της εφαρμογής και δεν έχει ανακληθεί. Απενεργοποιήστε τη βελτιστοποίηση μπαταρίας για το CallFlow εάν το σύστημα θέτει την εφαρμογή σε κατάσταση αναστολής λειτουργίας στο παρασκήνιο.

Δημιούργησα ένα νέο κλειδί και το γραφικό στοιχείο σταμάτησε να λειτουργεί

Η περιστροφή του κλειδιού ακυρώνει αμέσως το προηγούμενο - αυτό είναι ένα χαρακτηριστικό ασφαλείας. Αφού δημιουργήσετε ένα νέο κλειδί, ενημερώστε το σε όλα τα σημεία όπου είναι ενσωματωμένο το γραφικό στοιχείο: στον κώδικα του ιστότοπου και στις ρυθμίσεις κάθε προσθήκης CMS.