Ī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:
- Izveidojiet kontu — lietotnē CallFlow operētājsistēmai Android vai jaunākai versijai tīmekļa panelis. Konts ir bezmaksas.
- 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. - 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ē.
.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ūts | Apraksts | Noklusējuma vērtība |
|---|---|---|
data-site-key | Lapas atslēga no lietojumprogrammas, | — |
data-variant | floating, box, compact, sticky, ecommerce | floating |
data-target | Konteinera atlasītājs iegultai veidlapai | — |
data-position | left albo right | right |
data-language | pl albo en | dokumenta valoda |
data-title | Veidlapas galvene | valodas teksts |
data-subtitle | Apraksts zem virsraksta | valodas teksts |
data-button-text | Pogas teksts | valodas teksts |
data-success-text | Pielāgots veiksmes ziņojums | valodas teksts |
data-privacy-url | Vietnes īpašnieka konfidencialitātes politikas adrese | lapas konfigurācija |
data-primary-color | Spotkrāsa formātā #RRGGBB | #08D6C3 |
data-button-color | Pogas krāsa formātā #RRGGBB | #0D6EFD |
data-text-color | Formatētā teksta krāsa #RRGGBB | #061B3A |
data-background-color | Formatējiet fona krāsu #RRGGBB | #FFFFFF |
data-allow-urgent | false ukrywa opcję pilności | lapas iestatīšana |
data-open | true otwiera formularz po załadowaniu | false |
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.
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ūts | CSS mainīgais | Apraksts | Noklusējuma vērtība |
|---|---|---|---|
data-accent | --callflow-accent | Galvenā krāsa: poga, fokusa lauki, saites | #0D6EFD |
data-accent-text | --callflow-accent-text | Teksta krāsa uz pogas | #fff |
data-bg | --callflow-bg | Paneļa fons | #FFFFFF |
data-text | --callflow-text | Paneļa teksta krāsa | #061B3A |
data-muted | --callflow-muted | Sekundārais teksts (apraksts, piekrišana) | #52627a |
data-border-color | --callflow-border-color | Paneļa un lauku apmales | rgba(82,98,122,.18) / #ccd7e4 |
data-radius | --callflow-radius | Noapaļošana (panelis; proporcionāli lauki) | 22px |
data-font | --callflow-font | Fontu saime | mantota no lapas |
data-max-width | --callflow-max-width | Maksimālais paneļa platums | 390px |
data-input-bg | --callflow-input-bg | Veidlapas lauku fons | #fff |
data-input-text | --callflow-input-text | Veidlapas lauku teksts | #061b3a |
data-shadow | --callflow-shadow | Paneļa ēna: none, soft, strong | soft |
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-href → data-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 (wevent.detail.receiptIdznajdziesz identyfikator potwierdzenia);callflow:error— wysyłka się nie powiodła (wevent.detail.codeznajdziesz 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
- Lejupielādējiet spraudni — fails
callflow-wordpress-1.1.0.zipznajdziesz w sekcji Lejupielādēt. - 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.
- 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.
- ielīmējiet atslēgu lodziņā PUBLISKĀ_SITE_ATSLĒGA (formāts
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
- Lejupielādējiet spraudni — fails
callflow-woocommerce-1.1.0.zipz sekcji Lejupielādēt. - Instalējiet — Spraudņi → Pievienot jaunu spraudni → Augšupielādēt spraudni serverī, atlasiet ZIP, Instalējiet, Iespējot.
- Konfigurēt — dodieties uz Iestatījumi → CallFlow WooCommerce un:
- ielīmējiet PUBLISKĀ_SITE_ATSLĒGA;
- atlasiet
Nepieciešams Variants:
ecommerce(domyślny),floatinglubsticky; - 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
- Lejupielādēt moduli — fails
callflow-prestashop8-1.1.0.zipz sekcji Lejupielādēt. - 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".
- 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 przezPOST /auth/login, a odświeżysz przezPOST /auth/refreshzrefresh_token. - Nav marķiera darbojas tikai:
/auth/register,/auth/login,/auth/refreshoraz/public/leads. - Kļūdas: formāta atbildes
application/problem+jsonz polamitype,title,status,code,detail,trace_idi (dla walidacji)errors. - Lappuse: sarakstus atgriežas
next_cursor; kolejną stronę pobierzesz parametrem zapytaniacursor.
Auth — reģistrācija un sesijas dzīves cikls
| Metode | Ceļš | Apraksts |
|---|---|---|
POST | /auth/register | Izveido 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/login | Piesakās lietotājam ar e-pastu un paroli, atgriežoties access_token, refresh_token i expires_in. |
POST | /auth/refresh | Saraksti refresh_token na nową parę tokenów sesji. |
POST | /auth/logout | Nederīga pieteikušās lietotāja pašreizējā sesija. |
Konts — galvenais konts, apakškonti un statistika
| Metode | Ceļš | Apraksts |
|---|---|---|
GET | /account | Atgriež aktīvo kontu ar lomu (main/sub), strefą czasową i uprawnieniami użytkownika. |
DELETE | /account | Neatgriezeniski dzēš kontu ar visiem datiem (tikai galvenā loma; nepieciešama parole, un tikai Google konts — apstiprinājuma frāze "DZĒST KONTU"). |
GET | /account/export | Atgriež konta datu eksportu JSON formātā, kas ir ierobežots līdz pieteikušajam lietotājam redzamajam tvērumam. |
GET | /account/consents | Atgriež juridisko dokumentu (noteikumu, privātuma, mārketinga) pieņemšanas vēsturi. |
POST | /account/purge-completed | Hard 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/invitations | Nosūta uzaicinājumu apakšlietotājam ar piešķiršanu atlasītajiem avotiem. |
GET | /dashboard | Atgriež aktīvo konta statistiku: šodienas zvani, plānotie un pabeigtie zvani un avota slodze. |
Avoti — vietnes un kontaktpersonu pakotnes
| Metode | Ceļš | Apraksts |
|---|---|---|
GET | /sources | Atgriež lietotājam pieejamās lapas un pakotnes (filtrs kind, paginacja kursorem). |
POST | /sources | Izveido 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-code | Atgriež gatavu logrīka instalēšanas kodu, kā arī QR koda atslēgu un datus. |
POST | /sources/{sourceId}/send-instructions | Nosū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
| Metode | Ceļš | Apraksts |
|---|---|---|
GET | /leads | Atgriež 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}/status | Maina biļetes statusu (piem. handled, no_answer, spam) z opcjonalnym uzasadnieniem. |
Grafiks — zvanu plānošana
| Metode | Ceļš | Apraksts |
|---|---|---|
POST | /leads/{leadId}/schedule-next | Es plānoju interviju nākamajā brīvajā datumā; atgriežas 409, gdy w dozwolonym horyzoncie nie ma terminu. |
GET | /schedule | Atgriež zvanu kalendāru konkrētam periodam (obligātie parametri from i to, opcjonalny filtr source_id). |
Ierīces — push ierīces
| Metode | Ceļš | Apraksts |
|---|---|---|
GET | /devices | Atgriež 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
| Metode | Ceļš | Apraksts |
|---|---|---|
POST | /public/leads | Pieņ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.
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.