Dokumentatsioon

Dokumentatsioon sisaldab vidinat 1.2.0, CMS-i pistikprogramme 1.1.0 ja API versiooni 1.2.0. Viimati värskendatud: juuli 2026.

Kiire algus

CallFlow on tasuta tagasihelistamisvidin koos automaatse kõnejärjekorraga. Teie veebisaidi külastaja jätab telefoninumbri ja päring läheb kohe teie telefoni CallFlow rakendusse. Käivitamine võtab paar minutit ja koosneb kolmest etapist:

1. Looge konto – CallFlow rakenduses Androidile või uuemale versioonile veebipaneel. Konto on tasuta.
2. Lisage leht – jaotises „Paketid ja lehed” lisage oma veebisaidi aadress ja kopeerige lühiklahv, mis algab CF-. To publiczny klucz strony (PUBLIC_SITE_KEY) — pozwala wyłącznie wysyłać nowe zgłoszenia, nie daje dostępu do Twojego konta.
3. Kleepige skript – asetage järgmine kood vahetult märgendi ette </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>

Sellest piisab. Veebisaidile ilmub ujuv nupp ja iga aruanne käivitab rakenduses tõuketeatise.

HTML/JS vidin

CallFlow 1.2.0 vidin on tavaliste HTML-lehtede tootmisskript. See ei nõua raamistikku ega väliseid teeke. Vorm töötab isoleeritud Shadow DOM-is – see ei sega teie saidi CSS-i – ja saab saata uusi päringuid ainult avaliku CallFlow API kaudu.

Põhiinstallimine (ujuv vidin)

Kleebi skript enne </body> — dokładnie tak jak w Kiire algus. Vaikevariant floating wyświetla pływający przycisk w rogu ekranu, który otwiera formularz.

Sisu manustatud variant

Kui soovite vormi paigutada lehel kindlasse kohta (nt kontakti alamlehel), lisage tühi konteiner ja märkige see atribuudiga 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>

Saadaolevad variandid

• 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.

Kõiki variante saate otseülekandena vaadata veebisaidil Vidina demo.

Täieliku konfiguratsiooni atribuutide tabel

Kiireloomulisuse ja privaatsuspoliitika seaded tuuakse lisaks CallFlow'st. Veebisaidi kasutaja ei saa lubada funktsiooni, mille konto omanik on keelanud.

Turvalisus ja privaatsus

• skript ei loe konto andmeid ega piletite loendit;
• saidi võti võimaldab teil luua ainult pileti;
• edastamine toimub HTTPS-i kaudu;
• vorm sisaldab meepotti ja nõuab ühenduse võtmiseks selgesõnalist nõusolekut;
• vidin ei salvesta küpsiseid ega kasuta kohalikku salvestusruumi;
• number normaliseerib ja kinnitab uuesti API;
• päringul on 15-sekundiline ajalõpp ja duplikaatide eest kaitsmiseks idempotentsusvõti.

Välimuse kohandamine

Alates versioonist 1.2.0 pärib vidin fondi vaikimisi veebisaidilt (inherit, awaryjnie system-ui), a wygląd można dopasować na dwóch poziomach: Lihtne (lihtsad atribuudid) i Täpsem (täisspektri CSS). Märgendile saab paigutada isikupärastamise atribuute <script> või poolt määratud sihtmärgil data-target (atrybut na elemencie docelowym ma pierwszeństwo). Bez tych atrybutów widget wygląda tak jak dotychczas.

Lihtne tase – värvid, mõõtmed, font

Iga atribuut on valikuline ja vastendatakse CSS-i muutujaga, mis on määratud vidina hostielemendis (.callflow-widget-host):

Näide vidina sobitamisest kuldsete aktsentidega tumeda poolega:

<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>

Samad muutujad läbivad CSS-i pärimise kaudu Shadow DOM-i, nii et atribuutide asemel saate kasutada puhast lehe CSS-i (leht või <style>):

#moj-kontener {

  --callflow-accent: #b8860b;

  --callflow-radius: 4px;

  --callflow-max-width: 460px;

}

Tähise järjekord: atribuut data-* na elemencie docelowym → atrybut data-* na tagu <script> → zmienna CSS strony → starsze atrybuty data-*-color → wartości domyślne.

Kõrgtase – CSS-i täielik spekter

::part() – olulistel vormielementidel on atribuudid 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 – toores CSS, mis sisestatakse Shadow DOM-i pärast põhistiile (võidab kaskaad, mõjutab sisemisi vidina valijaid):

<div id="callback"

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

data-css-href – Shadow DOM-i laaditud välise lehe aadress. Turvakaalutlustel aktsepteeritakse ainult aadresse 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>

Shadow DOM stiilide järjestus: baaslaadid → z-leht data-css-href → data-custom-css. Personalizacja jest w pełni opcjonalna i wstecznie kompatybilna — istniejące osadzenia działają bez zmian.

JavaScripti sündmused

Vidin väljastab hostelemendil sündmusi ja edastab need dokumenti, nii et saate pärast edukat aruannet saata näiteks analüütikasüsteemi teisenduse:

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

  console.log(event.detail.receiptId);

});



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

  console.warn(event.detail.code);

});

Saadaolevad sündmused:

• 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).

WordPressi pistikprogramm

CallFlow 1.1.0 pistikprogramm lisab vidina kogu teie WordPressi saidile ilma malli muutmata. Toetab variante floating, box, sticky i compact oraz osadzanie formularza w treści przez shortcode.

Nõuded

• WordPress 6.0 või uuem;
• PHP 7.4 või uuem (testitud PHP 7.4 ja 8.3 peal);
• saidi võti CF-… utworzony w aplikacji CallFlow.

Samm-sammult installimine

1. Laadige pistikprogramm alla - fail callflow-wordpress-1.1.0.zip znajdziesz w sekcji Laadige alla.
2. Installige WordPressi armatuurlauale – minge aadressile Pluginad → Lisa uus plugin → Laadi pistikprogramm serverisse üles, osutage allalaaditud ZIP-failile ja klõpsake Installigeja pärast installimist Luba.
3. Konfigureeri – minge aadressile Seaded → CallFlow ja:
   • kleepige võti kasti PUBLIC_SITE_KEY (vorming CF-XXXX-XXXX);
   • valige Variant (vaikimisi floating);
   • sisestage aadress Privaatsuspoliitika ;
   • märk Luba vidin globaalselt ja klõpsake Salvestage muudatused.

Sisu manustamine (lühikood)

Vormi kuvamiseks postituses või lehel kasutage lühikoodi:

[callflow variant="box"]

Lühikoodi kasutamine keelab automaatselt selle alamlehe teise globaalse vidina – vormi ei dubleerita kunagi.

Levinud probleemid

• Võti ei salvestata – Plugin kinnitab vormingu: võti peab algama tähega CF- i zawierać wyłącznie wielkie litery, cyfry i myślniki. Skopiuj go ponownie z aplikacji, bez spacji.
• Vidinat lehel ei kuvata – kontrolli väli Luba vidin globaalselt on märgitud ja võti pole tühi. Kui kasutate vahemälu pistikprogrammi (nt LiteSpeed, WP Super Cache), tühjendage vahemälu pärast seadete salvestamist.
• Vidin kuvatakse kaks korda - teil on aktiivne ka CallFlow for WooCommerce'i pistikprogramm; vaata jaotist WooCommerce.

WooCommerce'i pistikprogramm

CallFlow for WooCommerce 1.1.0 on kaupluste jaoks kohandatud pistikprogramm – see kasutab varianti 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.

Nõuded

• WordPress 6.0 või uuem, PHP 7.4 või uuem (testitud PHP 7.4 ja 8.3 peal);
• aktiivne pistikprogramm WooCommerce (nõutav – ilma selleta vidinat ei kuvata);
• saidi võti CF-… z aplikacji CallFlow.

Samm-sammult installimine

1. Laadige pistikprogramm alla - fail callflow-woocommerce-1.1.0.zip z sekcji Laadige alla.
2. Installige — Pluginad → Lisa uus plugin → Laadi pistikprogramm serverisse üles, valige ZIP, Installige, Luba.
3. Konfigureeri – minge aadressile Seaded → CallFlow WooCommerce ja:
   • kleepige PUBLIC_SITE_KEY;
   • valige Variant: ecommerce (domyślny), floating lub sticky;
   • määrake ise Päis vorm (vaikimisi "Kas teil on toote kohta küsimusi?");
   • märk Lubage poe vidin ja salvestage.

Töötab põhilise CallFlow pistikprogrammiga

Mõlemad pistikprogrammid võivad olla aktiivsed korraga. Kui WooCommerce'i vidin on lubatud, keelab see automaatselt aluseks oleva pistikprogrammi globaalse vidina, nii et vormi ei kuvata kunagi kaks korda. Kui jätate võtmevälja WooCommerce'i sätetes tühjaks, kasutab pistikprogramm CallFlow baasplugina võtit.

Levinud probleemid

• Vidinat ei kuvata - veenduge, et WooCommerce on installitud ja aktiivne; pistikprogramm kuvab vidina ainult siis, kui WooCommerce töötab.
• Kaks vidinat korraga - värskendage mõlemad pistikprogrammid versioonile 1.1.0; vanemad versioonid ei koordineerinud nähtavust. Teise võimalusena tühjendage aluseks olevas pistikprogrammis ruut "Luba vidin globaalselt".
• See on beetaversioon – testige pistikprogrammi esmalt poe etapikoopial, enne kui lubate selle tootmises.

PrestaShop 8 moodul

CallFlow 1.1.0 beetamoodul manustab tootmisvidina PrestaShopi poe jalusesse (konks displayFooter). Obsługuje warianty ecommerce, floating i sticky.

Nõuded

• PrestaShop 8.0 või uuem;
• saidi võti CF-… z aplikacji CallFlow;
• installige esmalt lavastuspoodi beetaversioon.

Samm-sammult installimine

1. Laadige moodul alla - fail callflow-prestashop8-1.1.0.zip z sekcji Laadige alla.
2. Paigalda paneelile – minge aadressile Moodulid → Moodulihaldur → Laadi moodul ja osutage allalaaditud ZIP-failile. Mooduli leiate kategooriast "Reklaam ja turundus".
3. Konfigureeri – klõpsake Konfigureeri CallFlow mooduli jaoks ja:
   • kleepige PUBLIC_SITE_KEY;
   • valige Variant: e-kaubandus (vaikimisi), ujuv või kleepuv;
   • komplekt Vidina päis (vaikimisi "Kas teil on selle toote kohta küsimusi?" - sisestage oma poola keeles);
   • palun täpsustage privaatsuspoliitika aadress kauplus;
   • seadke lüliti Lubatud valikule "Jah" ja klõpsake Salvesta.

Levinud probleemid

• Viga "CallFlow klahv peab algama tähega CF-" - moodul kinnitab võtme vormingut; kopeerige see rakendusest ilma tühikuteta.
• Vidinat ei kuvata pärast salvestamist - poe vahemälu tühjendamine (Täpsem → Jõudlus → Tühjenda vahemälu) ja kontrollige, kas lüliti Lubatud on asendis "Jah".
• Teema ei kutsu jalust - vidin on konksuga ühendatud displayFooter; jeśli Twój motyw go nie renderuje, podepnij moduł do innego hooka w Välimus → Üksused.

Muud platvormid

Järgmised integratsioonid on versiooni 1.1.0 tehnilised beetaversioonid – installige need esmalt oma lavastuskeskkonda. Kõik paketid leiate jaotisest Laadige alla.

Drupal 11.10

Pärast mooduli installimist minge aadressile Konfiguratsioon → Võrguteenused → CallFlow, kleepige saidi avalik võti ja valige variant.

Joomla 4/5

Pärast installimist lubage pistikprogramm Süsteem – CallFlow (v Süsteem → Pluginad), kleepige PUBLIC_SITE_KEY, wybierz wariant i podaj adres polityki prywatności.

Magento 2 / Adobe Commerce

Kopeeri moodul asukohta app/code/CallFlow/Callback, uruchom bin/magento setup:upgrade i skonfiguruj go w Kauplused → Konfiguratsioon → Üldine → CallFlow. Moodul sisaldab skripti ja API jaoks CSP valget nimekirja samael.pl, więc nie musisz ręcznie modyfikować polityki bezpieczeństwa treści.

e107 2.3

Pärast installimist avage CallFlow konfiguratsioon, kleepige võti CF-…, wybierz wariant i włącz widget.

Strapi 4/5

Plugin pakub avaliku pod-konfiguratsiooni /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

Pakett sisaldab lähtekoodi Teemarakenduse laiendus (rakenduse manustamine ujuva vidina ja rakenduseploki jaoks koos jaotisesse manustatud vormiga) – see ei ole poe installiprogramm. Juurutamiseks on vaja Shopify Partneri rakendust ja arendajapoodi:

shopify app dev

shopify app deploy

Pärast installimist aktiveerib müüja CallFlow in Teema seaded → Rakenduste manused või lisab teemajaotisesse vormiploki.

API arendajatele

CallFlow pakub REST API versiooni 1.2.0 – sama leping juhib mobiilirakendust ja avalikke vidinaid.

Põhitõed

• Baas-URL: https://callflowdesk.com/api/v1
• Autentimine: päis Authorization: Bearer <access_token> (JWT). Token uzyskasz przez POST /auth/login, a odświeżysz przez POST /auth/refresh z refresh_token.
• Token puudub töötab ainult: /auth/register, /auth/login, /auth/refresh oraz /public/leads.
• Vead: vormingus vastused application/problem+json z polami type, title, status, code, detail, trace_id i (dla walidacji) errors.
• Leheküljed: loendid tagastavad next_cursor; kolejną stronę pobierzesz parametrem zapytania cursor.

Auth – registreerimine ja seansi elutsükkel

Konto – põhikonto, alamkontod ja statistika

Allikad – veebisaidid ja kontaktide paketid

Müügivihjed – tagasihelistamistaotlused ja nende olekud

Ajakava – kõnede ajastamine

Seadmed – tõukeseadmed

Avalik – vidinate lõpp-punktid

Näide: sisselogimine

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

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

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

Vasta 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"

Näide: müügivihje avalik saatmine

lõpp-punkt POST /public/leads nie wymaga tokenu — identyfikuje stronę po publicznym kluczu CF-…. Nagłówek Idempotency-Key jest nõutav (16–128 tähemärki, nt UUID): sama võtmega päringu uuesti proovimine ei loo duplikaatpäringut.

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": ""

  }'

Kohustuslikud väljad: 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.

Androidi rakendus

Rakendus CallFlow on teie kõnede käsukeskus: see on koht, kuhu lähevad kõik vidinate aruanded, siin saate hallata lehti, võtmeid ja tagasihelistamiskalendrit. Rakendus ilmub peagi Google Playsse – seni leiate installipaketi jaotisest Laadige alla.

Põhifunktsioonid

• Kõnejärjekord - uued päringud saadetakse automaatselt vastavasse projekti ja seatakse järjekorda vastavalt tööajale ja eeldatavale vestlusajale; olekud (uus, pooleli, käsitletud, vastamata, rämpspost) korraldavad tööd.
• Ajakava – tagasihelistamiskalender järgmise vaba kohtumise automaatse ajastamise ühe puudutusega.
• Tõukemärguanded - iga uus aruanne käivitab kohe teatise; Registreeritud seadmete loendit saate hallata seadetes ja kaotatud telefonile juurdepääsu tühistada.
• Alamkontod - konto omanikuna (pearoll) kutsute kolleegid (alamroll) e-posti teel ja määrate neile valitud lehed; nad näevad ainult neile määratud allikaid ja aruandeid.
• Andmete eksport – konto andmete (lehed, aruanded, ajakava, nõusolekud) täielik eksportimine JSON-faili vastavalt GDPR-ile.
• Konto kustutamine - konto lõplik kustutamine koos kõigi andmetega otse rakendusest (nõuab parooli kinnitamist ja Google'i kontode puhul - fraas "KUSUTA KONTO"); üksikasjad jaotises Kustutage oma konto.

Veaotsing

Vidinat ei kuvata üldse

Kõige tavalisem põhjus on kehtetu võti. Kontrollige atribuuti 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.

Vidin kuvab teade "Vale konfiguratsioon".

Võti on õiges vormingus, kuid pole aktiivne. See juhtub siis, kui on loodud uus võti (pööramine muudab vana kohe kehtetuks) või leht on arhiveeritud. Avage rakenduses veebisaidi üksikasjad ja kopeerige praegune võti ja asendage see oma koodi või pistikprogrammi seadetes.

Vorm töötab, kuid rakendused ei jõua rakendusse

Kontrollige saidi olekut rakenduses: ainult aktiivsed saidid aktsepteerivad rakendusi. Peatatud või arhiveeritud leht ei võta uusi müügivihjeid vastu. Samuti kontrollige, kas te ei vaata aruandeid olekufiltriga või alamkontol, millel pole juurdepääsu sellele lehele.

Vidin ilmub WooCommerce'iga WordPressis kaks korda

Teil on mõlemad aktiivsed pistikprogrammid: põhiline CallFlow ja CallFlow WooCommerce'i jaoks. Alates versioonist 1.1.0 keelab WooCommerce'i pistikprogramm globaalse baasvidina automaatselt – värskendage mõlemad versioonile 1.1.0. Kui probleem püsib, tühjendage ruut "Luba vidin globaalselt". Seaded → CallFlow. Pidage meeles ka seda lühikoodi [callflow] sam wyłącza widget globalny na danej podstronie.

Piirava CSP-ga pood blokeerib vidina

Kui teie sait saadab sisu-turvapoliitika päise, lisage domeen 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.

Vidin ei saada kohaliku hosti kohta aruandeid

See on tahtlik: väli 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.

Kuidas muuta vidina värve ilma lehe CSS-i muutmata?

Kasutage Easy-taseme atribuute otse sildil <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 Isikupärastamineja valmiskomplektid sisse demogalerii.

Kust ma leian oma saidi CF-võtme?

Avage CallFlow rakenduses "Paketid ja lehed", valige leht - klahv 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.

Ma ei saa uute aruannete kohta tõukemärguandeid

Kontrollige, kas rakendusel on Androidi seadetes luba märguannete jaoks ja kas teie seade on rakenduse seadmete loendis ja seda pole tühistatud. Keelake CallFlow aku optimeerimine, kui süsteem paneb rakenduse taustal magama.

Ma genereerisin uue võtme ja vidin lakkas töötamast

Võtme pööramine muudab eelmise kohe kehtetuks – see on turvafunktsioon. Pärast uue võtme genereerimist värskendage seda kõigis kohtades, kuhu vidin on manustatud: veebisaidi koodis ja iga CMS-i pistikprogrammi seadetes.