Dokumentācija

Viss, kas jums nepieciešams: no vienas rindiņas ielīmēšanas līdz pilnai API.

Dokumentācijā ir iekļauts logrīks 1.2.0, CMS spraudņi 1.1.0 un API versija 1.2.0. Pēdējo reizi atjaunināts: 2026. gada jūlijā.

Īss sākums

CallFlow ir bezmaksas atzvanīšanas logrīks ar automātisku zvanu rindu. Jūsu vietnes apmeklētājs atstāj tālruņa numuru, un pieprasījums nekavējoties nonāk jūsu tālruņa lietojumprogrammā CallFlow. Palaišana aizņem dažas minūtes un sastāv no trim soļiem:

  1. Izveidojiet kontu — lietotnē CallFlow operētājsistēmai Android vai jaunākai versijai tīmekļa panelis. Konts ir bezmaksas.
  2. Pievienojiet lapu — sadaļā "Pakas un lapas" pievienojiet savas vietnes adresi un nokopējiet īso taustiņu, kas sākas ar CF-. To publiczny klucz strony (PUBLIC_SITE_KEY) — pozwala wyłącznie wysyłać nowe zgłoszenia, nie daje dostępu do Twojego konta.
  3. Ielīmējiet skriptu — ievietojiet šo kodu tieši pirms taga </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>

Pietiek. Vietnē parādīsies peldoša poga, un katrs ziņojums aktivizēs push paziņojumu lietotnē.

Kontrolsaraksts pirms publicēšanas: pievienojiet pareizo konfidencialitātes politikas adresi, pārbaudiet vietnes atslēgu, nosūtiet vienu testa ziņojumu, apstipriniet ziņojumu un ievietojiet lietojumprogrammā, un visbeidzot izdzēsiet testa ziņojumu.
Logrīks sūta pārskatus tikai no vietnēm ar reālu domēnu (adrese ar TLD, piemēram, .pl, .com). Na localhost formularz się wyświetli, ale wysyłka nie przejdzie walidacji — testuj na domenie docelowej lub stagingowej.

HTML/JS logrīks

CallFlow 1.2.0 logrīks ir ražošanas skripts parastajām HTML lapām. Tam nav nepieciešams ietvars vai ārējās bibliotēkas. Veidlapa darbojas izolētā Shadow DOM — tā netraucē jūsu vietnes CSS — un var nosūtīt jaunus pieprasījumus, tikai izmantojot publisko CallFlow API.

Pamatinstalēšana (peldošais logrīks)

Ielīmējiet skriptu iepriekš </body> — dokładnie tak jak w Īss sākums. Noklusējuma variants floating wyświetla pływający przycisk w rogu ekranu, który otwiera formularz.

Saturā iegults variants

Ja vēlaties ievietot veidlapu noteiktā lapas vietā (piemēram, kontaktu apakšlapā), pievienojiet tukšu konteineru un norādiet to ar atribūtu 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>

Pieejamie varianti

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

Visus variantus varat skatīties tiešraidē vietnē Logrīka demonstrācija.

Pilna konfigurācijas atribūtu tabula

AtribūtsAprakstsNoklusējuma vērtība
data-site-keyLapas atslēga no lietojumprogrammas,
data-variantfloating, box, compact, sticky, ecommercefloating
data-targetKonteinera atlasītājs iegultai veidlapai
data-positionleft albo rightright
data-languagepl albo endokumenta valoda
data-titleVeidlapas galvenevalodas teksts
data-subtitleApraksts zem virsrakstavalodas teksts
data-button-textPogas tekstsvalodas teksts
data-success-textPielāgots veiksmes ziņojumsvalodas teksts
data-privacy-urlVietnes īpašnieka konfidencialitātes politikas adreselapas konfigurācija
data-primary-colorSpotkrāsa formātā #RRGGBB#08D6C3
data-button-colorPogas krāsa formātā #RRGGBB#0D6EFD
data-text-colorFormatētā teksta krāsa #RRGGBB#061B3A
data-background-colorFormatējiet fona krāsu #RRGGBB#FFFFFF
data-allow-urgentfalse ukrywa opcję pilnościlapas iestatīšana
data-opentrue otwiera formularz po załadowaniufalse

Steidzamības un konfidencialitātes politikas iestatījumi papildus tiek izgūti no CallFlow. Vietnes lietotājs nevar iespējot funkciju, ko atspējojis konta īpašnieks.

Drošība un konfidencialitāte

  • skripts nelasa konta datus vai biļešu sarakstu;
  • vietnes atslēga ļauj tikai izveidot biļeti;
  • pārraide notiek, izmantojot HTTPS;
  • veidlapā ir meduspoda, un saziņai ir nepieciešama nepārprotama piekrišana;
  • logrīks nesaglabā sīkfailus un neizmanto vietējo krātuvi;
  • numuru normalizē un atkārtoti apstiprina API;
  • pieprasījumam ir 15 sekunžu noildze un idempotences atslēga aizsardzībai pret dublikātiem.

Izskata pielāgošana

No versijas 1.2.0 logrīks pēc noklusējuma manto fontu no vietnes (inherit, awaryjnie system-ui), a wygląd można dopasować na dwóch poziomach: Viegli (vienkārši atribūti) i Papildu (pilna spektra CSS). Atzīmei var ievietot personalizācijas atribūtus <script> vai uz mērķa norādīto data-target (atrybut na elemencie docelowym ma pierwszeństwo). Bez tych atrybutów widget wygląda tak jak dotychczas.

Nevēlaties izstrādāt no jauna? Demonstrācijā skatiet gatavo stilu galeriju — katram piemēram ir kopējams kods.

Vienkāršs līmenis - krāsas, izmēri, fonts

Katrs atribūts nav obligāts un tiek kartēts uz CSS mainīgo, kas iestatīts logrīka saimniekdatora elementā (.callflow-widget-host):

AtribūtsCSS mainīgaisAprakstsNoklusējuma vērtība
data-accent--callflow-accentGalvenā krāsa: poga, fokusa lauki, saites#0D6EFD
data-accent-text--callflow-accent-textTeksta krāsa uz pogas#fff
data-bg--callflow-bgPaneļa fons#FFFFFF
data-text--callflow-textPaneļa teksta krāsa#061B3A
data-muted--callflow-mutedSekundārais teksts (apraksts, piekrišana)#52627a
data-border-color--callflow-border-colorPaneļa un lauku apmalesrgba(82,98,122,.18) / #ccd7e4
data-radius--callflow-radiusNoapaļošana (panelis; proporcionāli lauki)22px
data-font--callflow-fontFontu saimemantota no lapas
data-max-width--callflow-max-widthMaksimālais paneļa platums390px
data-input-bg--callflow-input-bgVeidlapas lauku fons#fff
data-input-text--callflow-input-textVeidlapas lauku teksts#061b3a
data-shadow--callflow-shadowPaneļa ēna: none, soft, strongsoft

Piemērs logrīka saskaņošanai ar tumšo pusi ar zelta akcentiem:

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

Tie paši mainīgie caurvij ēnu DOM, izmantojot CSS mantojumu, tāpēc atribūtu vietā varat izmantot tīru lapas CSS (lapu vai <style>):

#moj-kontener {

  --callflow-accent: #b8860b;

  --callflow-radius: 4px;

  --callflow-max-width: 460px;

}

Prioritātes secība: atribūts data-* na elemencie docelowym → atrybut data-* na tagu <script> → zmienna CSS strony → starsze atrybuty data-*-color → wartości domyślne.

Augstākais līmenis — pilns CSS klāsts

::part() — svarīgiem veidlapas elementiem ir atribūti 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 — neapstrādāts CSS, kas ievadīts ēnu DOM pēc bāzes stiliem (uzvar kaskāde, ietekmē iekšējos logrīku atlasītājus):

<div id="callback"

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

data-css-href — Ēnu DOM ielādētās ārējās lapas adrese. Drošības apsvērumu dēļ tiek pieņemtas tikai adreses 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>

Ēnu DOM stilu secība: bāzes stili → z lapa data-css-hrefdata-custom-css. Personalizacja jest w pełni opcjonalna i wstecznie kompatybilna — istniejące osadzenia działają bez zmian.

JavaScript notikumi

Logrīks izstaro notikumus resursdatora elementā un izplata tos dokumentā, lai jūs varētu, piemēram, nosūtīt reklāmguvumu uz analītikas sistēmu pēc veiksmīgas atskaites:

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

  console.log(event.detail.receiptId);

});



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

  console.warn(event.detail.code);

});

Pieejamie pasākumi:

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

CallFlow 1.1.0 spraudnis pievieno logrīku visai jūsu WordPress vietnei, nerediģējot veidni. Atbalsta variantus floating, box, sticky i compact oraz osadzanie formularza w treści przez shortcode.

Prasības

  • WordPress 6.0 vai jaunāka versija;
  • PHP 7.4 vai jaunāka versija (testēts uz PHP 7.4 un 8.3);
  • vietnes atslēga CF-… utworzony w aplikacji CallFlow.

Soli pa solim instalēšana

  1. Lejupielādējiet spraudni — fails callflow-wordpress-1.1.0.zip znajdziesz w sekcji Lejupielādēt.
  2. Instalējiet WordPress informācijas panelī — dodieties uz Spraudņi → Pievienot jaunu spraudni → Augšupielādēt spraudni serverī, norādiet uz lejupielādēto ZIP failu, noklikšķiniet uz Instalējietun pēc instalēšanas Iespējot.
  3. Konfigurēt — dodieties uz Iestatījumi → CallFlow un:
    • ielīmējiet atslēgu lodziņā PUBLISKĀ_SITE_ATSLĒGA (formāts CF-XXXX-XXXX);
    • atlasiet Nepieciešams Variants (noklusējums floating);
    • ievadiet adresi Privātuma politika ;
    • zīme Iespējot logrīku globāli un noklikšķiniet uz Saglabāt izmaiņas.

Iegulšana saturā (īskods)

Lai ziņojumā vai lapā parādītu veidlapu, izmantojiet īskodu:

[callflow variant="box"]

Izmantojot īskodu, šajā apakšlapā tiek automātiski atspējots otrais globālais logrīks — veidlapa nekad netiks dublēta.

Bieži sastopamas problēmas

  • Atslēga netiek saglabāta — spraudnis pārbauda formātu: atslēgai jāsākas ar CF- i zawierać wyłącznie wielkie litery, cyfry i myślniki. Skopiuj go ponownie z aplikacji, bez spacji.
  • Logrīks lapā neparādās - pārbaudes lauks Iespējot logrīku globāli ir atzīmēts, un atslēga nav tukša. Ja izmantojat kešatmiņas spraudni (piemēram, LiteSpeed, WP Super Cache), pēc iestatījumu saglabāšanas notīriet kešatmiņu.
  • Logrīks parādās divas reizes — jums ir arī aktīvs spraudnis CallFlow for WooCommerce; skatīt sadaļu WooCommerce.

WooCommerce spraudnis

CallFlow for WooCommerce 1.1.0 ir veikaliem pielāgots spraudnis — tas izmanto variantu 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.

Prasības

  • WordPress 6.0 vai jaunāka versija, PHP 7.4 vai jaunāka versija (testēts uz PHP 7.4 un 8.3);
  • aktīvs spraudnis WooCommerce (obligāts - bez tā logrīks netiks parādīts);
  • vietnes atslēga CF-… z aplikacji CallFlow.

Soli pa solim instalēšana

  1. Lejupielādējiet spraudni — fails callflow-woocommerce-1.1.0.zip z sekcji Lejupielādēt.
  2. InstalējietSpraudņi → Pievienot jaunu spraudni → Augšupielādēt spraudni serverī, atlasiet ZIP, Instalējiet, Iespējot.
  3. Konfigurēt — dodieties uz Iestatījumi → CallFlow WooCommerce un:
    • ielīmējiet PUBLISKĀ_SITE_ATSLĒGA;
    • atlasiet Nepieciešams Variants: ecommerce (domyślny), floating lub sticky;
    • iestatiet savu Galvene forma (noklusējuma "Vai jums ir jautājums par preci?");
    • zīme Iespējojiet veikala logrīku un saglabājiet.

Darbojas ar pamata spraudni CallFlow

Abi spraudņi var būt aktīvi vienlaikus. Kad WooCommerce logrīks ir iespējots, tas automātiski atspējo pamatā esošā spraudņa globālo logrīku, tāpēc veidlapa nekad netiks parādīta divreiz. Ja atstāsit atslēgas lauku WooCommerce iestatījumos tukšu, spraudnis izmantos atslēgu no pamata CallFlow spraudņa.

Bieži sastopamas problēmas

  • Logrīks neparādās - pārliecinieties, vai WooCommerce ir instalēts un aktīvs; spraudnis parāda logrīku tikai tad, kad darbojas WooCommerce.
  • Divi logrīki vienlaikus - atjauniniet abus spraudņus uz versiju 1.1.0; vecākās versijas nekoordinēja redzamību. Vai arī noņemiet atzīmi no izvēles rūtiņas "Iespējot logrīku globāli" pamatā esošajā spraudnī.
  • Šī ir beta versija — vispirms pārbaudiet spraudni veikala eksemplārā, pirms iespējojat to ražošanā.

PrestaShop 8 modulis

CallFlow 1.1.0 beta modulis iegulst ražošanas logrīku PrestaShop veikala kājenē (āķis displayFooter). Obsługuje warianty ecommerce, floating i sticky.

Prasības

  • PrestaShop 8.0 vai jaunāka versija;
  • vietnes atslēga CF-… z aplikacji CallFlow;
  • vispirms instalējiet beta versiju iestudējuma veikalā.

Soli pa solim instalēšana

  1. Lejupielādēt moduli — fails callflow-prestashop8-1.1.0.zip z sekcji Lejupielādēt.
  2. Instalējiet panelī — dodieties uz Moduļi → Moduļu pārvaldnieks → Ielādēt moduli un norādiet uz lejupielādēto ZIP. Moduli atradīsiet kategorijā "Reklāma un mārketings".
  3. Konfigurēt — noklikšķiniet Konfigurēt CallFlow modulim un:
    • ielīmējiet PUBLISKĀ_SITE_ATSLĒGA;
    • atlasiet Nepieciešams Variants: e-komercija (noklusējums), peldoša vai lipīga;
    • komplekts Logrīka galvene (noklusējums "Vai jums ir jautājums par šo produktu?" - ievadiet savu poļu valodā);
    • lūdzu, precizējiet privātuma politikas adrese veikals;
    • iestatīt slēdzi Iespējots uz "Jā" un noklikšķiniet Saglabāt.

Bieži sastopamas problēmas

  • Kļūda "CallFlow atslēgai jāsākas ar CF-" - modulis apstiprina atslēgas formātu; kopējiet to no lietojumprogrammas bez atstarpēm.
  • Logrīks pēc saglabāšanas neparādās — notīrīt veikala kešatmiņu (Papildu → Veiktspēja → Notīrīt kešatmiņu) un pārbaudiet, vai slēdzis Iespējots ir iestatīts uz "Jā".
  • Motīvs neizsauc kājeni - logrīks ir savienots ar āķi displayFooter; jeśli Twój motyw go nie renderuje, podepnij moduł do innego hooka w Izskats → Vienumi.

Citas platformas

Tālāk norādītās integrācijas ir 1.1.0 tehniskās beta versijas — lūdzu, vispirms instalējiet tās savā iestudējuma vidē. Visus iepakojumus atradīsi sadaļā Lejupielādēt.

Drupal 11.10

Pēc moduļa instalēšanas dodieties uz Konfigurācija → Tīkla pakalpojumi → CallFlow, ielīmējiet vietnes publisko atslēgu un atlasiet variantu.

Joomla 4/5

Pēc instalēšanas iespējojiet spraudni Sistēma — CallFlow (v Sistēma → Spraudņi), ielīmējiet PUBLIC_SITE_KEY, wybierz wariant i podaj adres polityki prywatności.

Magento 2 / Adobe Commerce

Kopēt moduli uz app/code/CallFlow/Callback, uruchom bin/magento setup:upgrade i skonfiguruj go w Veikali → Konfigurācija → Vispārīgi → CallFlow. Modulis satur CSP balto sarakstu skriptam un API samael.pl, więc nie musisz ręcznie modyfikować polityki bezpieczeństwa treści.

e107 2.3

Pēc instalēšanas atveriet CallFlow konfigurāciju, ielīmējiet atslēgu CF-…, wybierz wariant i włącz widget.

Strapi 4/5

Spraudnis nodrošina publisku pod konfigurāciju /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

Komplektā ietilpst pirmkods Motīva lietotnes paplašinājums (lietotnes iegulšana peldošam logrīkam un lietotņu blokam ar sadaļā iegultu veidlapu) — šī nav veikala instalēšanas programma. Izvietošanai nepieciešama Shopify Partner lietotne un izstrādātāju veikals:

shopify app dev

shopify app deploy

Pēc instalēšanas pārdevējs aktivizē CallFlow in Motīvu iestatījumi → Lietotņu iegulšana vai pievieno veidlapas bloku motīva sadaļai.

API izstrādātājiem

CallFlow nodrošina REST API versiju 1.2.0 — tas pats līgums nodrošina mobilo lietotni un publiskos logrīkus.

Pamatinformācija

  • Pamata URL: https://callflowdesk.com/api/v1
  • Autentifikācija: galvene Authorization: Bearer <access_token> (JWT). Token uzyskasz przez POST /auth/login, a odświeżysz przez POST /auth/refresh z refresh_token.
  • Nav marķiera darbojas tikai: /auth/register, /auth/login, /auth/refresh oraz /public/leads.
  • Kļūdas: formāta atbildes application/problem+json z polami type, title, status, code, detail, trace_id i (dla walidacji) errors.
  • Lappuse: sarakstus atgriežas next_cursor; kolejną stronę pobierzesz parametrem zapytania cursor.

Auth — reģistrācija un sesijas dzīves cikls

MetodeCeļšApraksts
POST/auth/registerIzveido galveno kontu un atgriež aktīvu sesiju (nepieciešams e-pasts, parole un pieņemto noteikumu un nosacījumu un konfidencialitātes politikas versija).
POST/auth/loginPiesakās lietotājam ar e-pastu un paroli, atgriežoties access_token, refresh_token i expires_in.
POST/auth/refreshSaraksti refresh_token na nową parę tokenów sesji.
POST/auth/logoutNederīga pieteikušās lietotāja pašreizējā sesija.

Konts — galvenais konts, apakškonti un statistika

MetodeCeļšApraksts
GET/accountAtgriež aktīvo kontu ar lomu (main/sub), strefą czasową i uprawnieniami użytkownika.
DELETE/accountNeatgriezeniski dzēš kontu ar visiem datiem (tikai galvenā loma; nepieciešama parole, un tikai Google konts — apstiprinājuma frāze "DZĒST KONTU").
GET/account/exportAtgriež konta datu eksportu JSON formātā, kas ir ierobežots līdz pieteikušajam lietotājam redzamajam tvērumam.
GET/account/consentsAtgriež juridisko dokumentu (noteikumu, privātuma, mārketinga) pieņemšanas vēsturi.
POST/account/purge-completedHard dzēš biļetes galīgajos statusos kopā ar piezīmēm, ierakstiem rindā un paziņojumiem (tikai galvenajai lomai). jūsu vietnes
POST/account/sub-users/invitationsNosūta uzaicinājumu apakšlietotājam ar piešķiršanu atlasītajiem avotiem.
GET/dashboardAtgriež aktīvo konta statistiku: šodienas zvani, plānotie un pabeigtie zvani un avota slodze.

Avoti — vietnes un kontaktpersonu pakotnes

MetodeCeļšApraksts
GET/sourcesAtgriež lietotājam pieejamās lapas un pakotnes (filtrs kind, paginacja kursorem).
POST/sourcesIzveido jaunu lapu vai kontaktpersonu paketi ar darba laiku un paredzamo zvanu laiku.
GET/sources/{sourceId}Atgriež informāciju par vienu lapu vai pakotni.
PATCH/sources/{sourceId}Atjaunina atlasītos avota laukus (apvienošanas ielāps: vārds, adrese, darba laiks, statuss utt.).
DELETE/sources/{sourceId}Arhivējiet avotu, vienlaikus saglabājot pieprasījumu vēsturi.
POST/sources/{sourceId}/rotate-keyģenerē jaunu publiskās vietnes atslēgu; vecais nekavējoties pārstāj darboties.
GET/sources/{sourceId}/install-codeAtgriež gatavu logrīka instalēšanas kodu, kā arī QR koda atslēgu un datus.
POST/sources/{sourceId}/send-instructionsNosūta instalēšanas instrukcijas pa e-pastu (pēc noklusējuma uz pieteikušās lietotāja adresi).

Potenciālie pirkumi — atzvanīšanas pieprasījumi un to statusi

MetodeCeļšApraksts
GET/leadsAtgriež lietotājam pieejamās biļetes (filtri source_id i status, paginacja kursorem).
GET/leads/{leadId}Atgriež vienas biļetes informāciju.
PATCH/leads/{leadId}/statusMaina biļetes statusu (piem. handled, no_answer, spam) z opcjonalnym uzasadnieniem.

Grafiks — zvanu plānošana

MetodeCeļšApraksts
POST/leads/{leadId}/schedule-nextEs plānoju interviju nākamajā brīvajā datumā; atgriežas 409, gdy w dozwolonym horyzoncie nie ma terminu.
GET/scheduleAtgriež zvanu kalendāru konkrētam periodam (obligātie parametri from i to, opcjonalny filtr source_id).

Ierīces — push ierīces

MetodeCeļšApraksts
GET/devicesAtgriež to lietotāja aktīvo mobilo ierīču sarakstu, kas reģistrētas pašpiegādes paziņojumiem.
DELETE/devices/{deviceId}Atsauc ierīci — tā pārstāj saņemt paziņojumus.

Publisks — logrīku galapunkti

MetodeCeļšApraksts
POST/public/leadsPieņem pieprasījumu no logrīka bez autentifikācijas — nepieciešama galvene Idempotency-Key i publicznego klucza strony; zwraca 202 z potwierdzeniem, nie ujawniając danych konta.

Piemērs: pieteikšanās

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

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

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

Atbildēt 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"

Piemērs: potenciālā pirkuma publiska nosūtīšana

Galapunkts POST /public/leads nie wymaga tokenu — identyfikuje stronę po publicznym kluczu CF-…. Nagłówek Idempotency-Key jest (16–128 rakstzīmes, piemēram, UUID): atkārtoti mēģinot izpildīt pieprasījumu ar to pašu atslēgu, pieprasījuma dublikāts netiks izveidots.

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

  }'

Obligātie lauki: 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.

Kad pieprasījuma ierobežojums tiek pārsniegts, API atbild ar kodu 429 z nagłówkiem Retry-After — odczekaj wskazany czas przed ponowieniem. Błędne dane wejściowe zwracają 422 z listą błędów per pole w errors.

Android lietojumprogramma

Lietojumprogramma CallFlow ir komandu centrs jūsu zvaniem: tur tiek novirzīti visi logrīku pārskati, šeit jūs pārvaldāt lapas, atslēgas un atzvanīšanas kalendāru. Drīzumā aplikācija parādīsies Google Play – līdz tam instalācijas pakotni atradīsi sadaļā Lejupielādēt.

Galvenās funkcijas

  • Zvanu rinda - jauni pieprasījumi tiek automātiski nosūtīti uz atbilstošo projektu un sastādīti rindā atbilstoši darba laikam un paredzamajam sarunas laikam; statusi (jauns, notiek, apstrādāts, nokavēts, surogātpasts) organizē darbu.
  • Grafiks - atzvanīšanas kalendārs ar automātisku nākamās pieejamās tikšanās plānošanu ar vienu pieskārienu.
  • Push paziņojumi - katrs jauns ziņojums nekavējoties aktivizē paziņojumu; Jūs pārvaldāt reģistrēto ierīču sarakstu iestatījumos un varat atsaukt piekļuvi pazaudētam tālrunim.
  • Apakškonti - kā konta īpašnieks (galvenā loma) uzaicināt kolēģus (apakšlomas) pa e-pastu un piešķirat viņiem izvēlētās lapas; viņi redz tikai tiem piešķirtos avotus un ziņojumus.
  • Datu eksportēšana — pilnīga konta datu (lapu, pārskatu, grafika, piekrišanas) eksportēšana uz JSON failu saskaņā ar GDPR.
  • Konta dzēšana - neatgriezeniska konta dzēšana ar visiem datiem tieši no lietojumprogrammas (nepieciešams paroles apstiprinājums, un Google kontiem - frāze "DZĒST KONTU"); sīkāk sadaļā Dzēsiet savu kontu.

Problēmu novēršana

Logrīks netiek rādīts vispār

Visbiežākais iemesls ir nederīga atslēga. Pārbaudiet atribūtu 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.

Logrīkā tiek parādīts ziņojums "Nederīga konfigurācija".

Atslēga ir pareizā formātā, taču tā nav aktīva. Tas notiek, ja ir ģenerēta jauna atslēga (rotācija nekavējoties padara nederīgu veco) vai lapa ir arhivēta. Pieteikumā dodieties uz vietnes informāciju un kopējiet pašreizējā un nomainiet to koda vai spraudņa iestatījumos.

Veidlapa darbojas, bet lietojumprogrammas nesasniedz pieteikumu

Pārbaudiet vietnes statusu lietojumprogrammā: tikai aktīvās vietnes pieņem pieteikumus. Pauzēta vai arhivēta lapa nepieņem jaunus potenciālos pirkumus. Pārbaudiet arī, vai neskatāt pārskatus ar statusa filtru vai apakškontā bez piekļuves šai lapai.

Logrīks tiek parādīts divreiz pakalpojumā WordPress ar WooCommerce

Jums ir aktīvi abi spraudņi: pamata CallFlow un CallFlow WooCommerce. Sākot ar versiju 1.1.0, WooCommerce spraudnis automātiski atspējo globālo pamata logrīku — atjauniniet abus uz 1.1.0. Ja problēma joprojām pastāv, noņemiet atzīmi no izvēles rūtiņas “Iespējot logrīku globāli”. Iestatījumi → CallFlow. Atcerieties arī šo īskodu [callflow] sam wyłącza widget globalny na danej podstronie.

Veikals ar ierobežojošu CSP bloķē logrīku

Ja jūsu vietne nosūta satura drošības politikas galveni, pievienojiet domēnu 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.

Logrīks nesūta pārskatus par vietējo resursdatoru

Šis ir tīšs lauks 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.

Kā mainīt logrīku krāsas, nerediģējot lapas CSS?

Izmantojiet Easy līmeņa atribūtus tieši uz taga <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 Personalizēšanaun gatavas komplektācijas demonstrācijas galerija.

Kur es varu atrast savas vietnes CF atslēgu?

CallFlow lietojumprogrammā atveriet sadaļu "Paketes un lapas", atlasiet lapu - taustiņu 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.

Es nesaņemu pašpiegādes paziņojumus par jauniem pārskatiem

Pārbaudiet, vai lietotnei ir atļauja saņemt paziņojumus Android iestatījumos un vai jūsu ierīce ir lietotnes ierīču sarakstā un nav atsaukta. Atspējojiet akumulatora optimizāciju pakalpojumam CallFlow, ja sistēma fonā pārslēdz lietojumprogrammu miega režīmā.

Es ģenerēju jaunu atslēgu, un logrīks pārstāja darboties

Atslēgas pagriešana nekavējoties padara nederīgu iepriekšējo - tas ir drošības līdzeklis. Pēc jaunas atslēgas ģenerēšanas atjauniniet to visās vietās, kur ir iegults logrīks: vietnes kodā un katra CMS spraudņa iestatījumos.