Greita pradžia
CallFlow yra nemokamas atgalinio skambinimo valdiklis su automatine skambučių eile. Jūsų svetainės lankytojas palieka telefono numerį, o užklausa iškart patenka į jūsų telefono programą CallFlow. Paleidimas trunka keletą minučių ir susideda iš trijų etapų:
- Susikurkite paskyrą – „CallFlow“ programoje, skirtoje „Android“ ar naujesnėms priemonėms žiniatinklio skydelis. Paskyra nemokama.
- Pridėti puslapį – Skiltyje „Paketai ir puslapiai“ pridėkite savo svetainės adresą ir nukopijuokite trumpąjį klavišą, prasidedantį
CF-. To publiczny klucz strony (PUBLIC_SITE_KEY) — pozwala wyłącznie wysyłać nowe zgłoszenia, nie daje dostępu do Twojego konta. - Įklijuokite scenarijų – įdėkite šį kodą prieš pat žymą
</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>
Užteks. Svetainėje pasirodys slankusis mygtukas, o kiekviena ataskaita suaktyvins tiesioginį pranešimą programoje.
.pl, .com). Na localhost formularz się wyświetli, ale wysyłka nie przejdzie walidacji — testuj na domenie docelowej lub stagingowej.HTML/JS valdiklis
CallFlow 1.2.0 valdiklis yra įprastų HTML puslapių gamybinis scenarijus. Tam nereikia sistemos ar išorinių bibliotekų. Forma veikia izoliuotame šešėliniame DOM (ji netrukdo jūsų svetainės CSS) ir gali siųsti naujas užklausas tik per viešąją CallFlow API.
Pagrindinis diegimas (plaukiojantis valdiklis)
Įklijuokite scenarijų anksčiau </body> — dokładnie tak jak w Greita pradžia. Numatytasis variantas floating wyświetla pływający przycisk w rogu ekranu, który otwiera formularz.
Turinyje įterptas variantas
Jei formą norite patalpinti konkrečioje puslapio vietoje (pvz., kontaktų antriniame puslapyje), pridėkite tuščią konteinerį ir nurodykite jį atributu 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>
Galimi variantai
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 galite tiesiogiai stebėti svetainėje Valdiklio demonstracinė versija.
Visos konfigūracijos atributų lentelė
| Atributas | Aprašymas | Numatytoji vertė |
|---|---|---|
data-site-key | Puslapio raktas iš programos, reikalingas | — |
data-variant | floating, box, compact, sticky, ecommerce | floating |
data-target | Įterptosios formos sudėtinio rodinio parinkiklis | — |
data-position | left albo right | right |
data-language | pl albo en | dokumento kalba |
data-title | Formos antraštė | kalbos tekstas |
data-subtitle | Aprašymas po antrašte | kalbos tekstas |
data-button-text | Mygtuko tekstas | kalbos tekstas |
data-success-text | Priskirtas sėkmės pranešimas | kalbos tekstas |
data-privacy-url | Svetainės savininko privatumo politikos adresas | puslapio konfigūracija |
data-primary-color | Taškinės spalvos formatu #RRGGBB | #08D6C3 |
data-button-color | Mygtuko spalva formatu #RRGGBB | #0D6EFD |
data-text-color | Suformatuoto teksto spalva #RRGGBB | #061B3A |
data-background-color | Fono spalvos formatavimas #RRGGBB | #FFFFFF |
data-allow-urgent | false ukrywa opcję pilności | puslapio sąranka |
data-open | true otwiera formularz po załadowaniu | false |
Skubos ir privatumo politikos nustatymai papildomai nuskaitomi iš CallFlow. Svetainės naudotojas negali įjungti funkcijos, kurią išjungė paskyros savininkas.
Saugumas ir privatumas
- scenarijus neskaito sąskaitos duomenų ar bilietų sąrašo;
- svetainės raktas leidžia tik sukurti bilietą;
- perdavimas vyksta per HTTPS;
- formoje yra medaus puodas ir reikalingas aiškus sutikimas susisiekti;
- valdiklis neišsaugo slapukų ir nenaudoja vietinės saugyklos;
- numeris yra normalizuotas ir iš naujo patvirtintas API;
- užklausa turi 15 sekundžių skirtąjį laiką ir idempotencijos raktą, kad apsaugotų nuo dublikatų.
Išvaizdos tinkinimas
Nuo 1.2.0 versijos valdiklis pagal numatytuosius nustatymus paveldi šriftą iš svetainės (inherit, awaryjnie system-ui), a wygląd można dopasować na dwóch poziomach: Lengva (paprasti atributai) i Išplėstinė (viso spektro CSS). Suasmeninimo atributai gali būti dedami ant žymos <script> arba pagal nurodytą tikslą data-target (atrybut na elemencie docelowym ma pierwszeństwo). Bez tych atrybutów widget wygląda tak jak dotychczas.
Lengvas lygis – spalvos, matmenys, šriftas
Kiekvienas atributas yra neprivalomas ir susietas su CSS kintamuoju, nustatytu valdiklio prieglobos elemente (.callflow-widget-host):
| Atributas | CSS kintamasis | Aprašymas | Numatytoji vertė |
|---|---|---|---|
data-accent | --callflow-accent | Pagrindinė spalva: mygtukas, fokusavimo laukai, nuorodos | #0D6EFD |
data-accent-text | --callflow-accent-text | Mygtuko teksto spalva | #fff |
data-bg | --callflow-bg | Skydelio fonas | #FFFFFF |
data-text | --callflow-text | Skydelio teksto spalva | #061B3A |
data-muted | --callflow-muted | Antrinis tekstas (aprašas, sutikimai) | #52627a |
data-border-color | --callflow-border-color | Skydelio ir lauko kraštinės | rgba(82,98,122,.18) / #ccd7e4 |
data-radius | --callflow-radius | Apvalinimas (skydelis; proporcingi laukai) | 22px |
data-font | --callflow-font | Šriftų šeima | paveldėtas iš puslapio |
data-max-width | --callflow-max-width | Maksimalus skydelio plotis | 390px |
data-input-bg | --callflow-input-bg | Formos laukų fonas | #fff |
data-input-text | --callflow-input-text | Formos laukų tekstas | #061b3a |
data-shadow | --callflow-shadow | Skydelio šešėlis: none, soft, strong | soft |
Valdiklio pritaikymo tamsiajai pusei su auksiniais akcentais pavyzdys:
<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 patys kintamieji persmelkia šešėlinį DOM per CSS paveldėjimą, todėl vietoj atributų galite naudoti gryną puslapio CSS (lapą arba <style>):
#moj-kontener {
--callflow-accent: #b8860b;
--callflow-radius: 4px;
--callflow-max-width: 460px;
}
Pirmumo tvarka: atributas data-* na elemencie docelowym → atrybut data-* na tagu <script> → zmienna CSS strony → starsze atrybuty data-*-color → wartości domyślne.
Aukštasis lygis – visas CSS spektras
::part() – svarbūs formos elementai turi atributus 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 – neapdorotas CSS, įterptas į šešėlinį DOM po bazinių stilių (laimi kaskados, turi įtakos vidinių valdiklių parinktuvams):
<div id="callback" data-custom-css=".cf-panel{border:0;padding:14px} .cf-submit{letter-spacing:.06em}"></div>
data-css-href – išorinio lapo, įkelto į šešėlinį DOM, adresas. Saugumo sumetimais priimami tik adresai 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 stiliaus tvarka: pagrindiniai stiliai → z lapas data-css-href → data-custom-css. Personalizacja jest w pełni opcjonalna i wstecznie kompatybilna — istniejące osadzenia działają bez zmian.
JavaScript įvykiai
Valdiklis skleidžia pagrindinio elemento įvykius ir perduoda juos į dokumentą, kad galėtumėte, pavyzdžiui, išsiųsti konversiją į analizės sistemą po sėkmingos ataskaitos:
document.addEventListener('callflow:submitted', (event) => { console.log(event.detail.receiptId); }); document.addEventListener('callflow:error', (event) => { console.warn(event.detail.code); });
Galimi įvykiai:
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“ papildinys
CallFlow 1.1.0 papildinys prideda valdiklį prie visos jūsų „WordPress“ svetainės neredaguojant šablono. Palaiko variantus floating, box, sticky i compact oraz osadzanie formularza w treści przez shortcode.
Reikalavimai
- WordPress 6.0 arba naujesnė versija;
- PHP 7.4 arba naujesnė versija (išbandyta PHP 7.4 ir 8.3 versijose);
- svetainės raktas
CF-…utworzony w aplikacji CallFlow.
Žingsnis po žingsnio diegimas
- Atsisiųskite papildinį - failas
callflow-wordpress-1.1.0.zipznajdziesz w sekcji Atsisiųsti. - Įdiekite „WordPress“ prietaisų skydelyje – eikite į Papildiniai → Pridėti naują papildinį → Įkelti papildinį į serverį, nukreipkite žymiklį į atsisiųstą ZIP failą, spustelėkite Įdiegtiir po įdiegimo Įjungti.
- Konfigūruoti – eikite į Nustatymai → CallFlow ir:
- įklijuokite raktą į dėžutę PUBLIC_SITE_KEY (formatas
CF-XXXX-XXXX); - pasirinkite Variantas (numatytasis
floating); - įveskite adresą Privatumo politika ;
- ženklas Įgalinkite valdiklį visame pasaulyje ir spustelėkite Išsaugoti pakeitimus.
- įklijuokite raktą į dėžutę PUBLIC_SITE_KEY (formatas
Įterpimas į turinį (trumpasis kodas)
Norėdami įraše arba puslapyje rodyti formą, naudokite trumpąjį kodą:
[callflow variant="box"]
Naudojant trumpąjį kodą, antrasis visuotinis valdiklis šiame antriniame puslapyje automatiškai išjungiamas – forma niekada nebus dubliuojama.
Dažnos problemos
- Raktas neišsaugomas – Papildinys patvirtina formatą: raktas turi prasidėti
CF-i zawierać wyłącznie wielkie litery, cyfry i myślniki. Skopiuj go ponownie z aplikacji, bez spacji. - Valdiklis nerodomas puslapyje – patikrinimo laukas Įgalinkite valdiklį visame pasaulyje yra pažymėtas, o raktas nėra tuščias. Jei naudojate talpyklos papildinį (pvz., LiteSpeed, WP Super Cache), išvalykite talpyklą išsaugoję nustatymus.
- Valdiklis pasirodo du kartus – taip pat turite aktyvų „CallFlow for WooCommerce“ papildinį; žr. skyrių WooCommerce.
WooCommerce papildinys
CallFlow for WooCommerce 1.1.0 yra parduotuvėms pritaikytas papildinys – jame naudojamas variantas 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.
Reikalavimai
- WordPress 6.0 arba naujesnė versija, PHP 7.4 arba naujesnė versija (išbandyta PHP 7.4 ir 8.3 versijose);
- aktyvus papildinys WooCommerce (būtina – be jo valdiklis nebus rodomas);
- svetainės raktas
CF-…z aplikacji CallFlow.
Žingsnis po žingsnio diegimas
- Atsisiųskite papildinį - failas
callflow-woocommerce-1.1.0.zipz sekcji Atsisiųsti. - Įdiegti — Papildiniai → Pridėti naują papildinį → Įkelti papildinį į serverį, pasirinkite ZIP, Įdiegti, Įjungti.
- Konfigūruoti – eikite į Nustatymai → CallFlow WooCommerce ir:
- įklijuoti PUBLIC_SITE_KEY;
- pasirinkite Variantas:
ecommerce(domyślny),floatinglubsticky; - nustatykite savo Antraštė forma (numatytasis "Ar turite klausimų apie prekę?");
- ženklas Įgalinkite parduotuvės valdiklį ir išsaugokite.
Veikia su pagrindiniu CallFlow papildiniu
Abu papildiniai gali būti aktyvūs vienu metu. Įjungus WooCommerce valdiklį, jis automatiškai išjungia pagrindinio papildinio visuotinį valdiklį, todėl forma niekada nebus rodoma du kartus. Jei paliksite rakto lauką WooCommerce nustatymuose tuščią, papildinys naudos raktą iš bazinio CallFlow papildinio.
Dažnos problemos
- Valdiklis nerodomas – įsitikinkite, kad WooCommerce įdiegta ir aktyvi; įskiepis rodo valdiklį tik tada, kai veikia „WooCommerce“.
- Du valdikliai vienu metu - atnaujinkite abu papildinius į 1.1.0 versiją; senesnės versijos nekoordinavo matomumo. Arba pagrindiniame papildinyje panaikinkite žymėjimą „Įgalinti valdiklį visame pasaulyje“.
- Tai yra beta versija – prieš įjungdami gamybinę versiją, pirmiausia išbandykite papildinį su parduotuve esančia kopija.
PrestaShop 8 modulis
CallFlow 1.1.0 beta versijos modulis įterpia gamybos valdiklį PrestaShop parduotuvės poraštėje (kablys displayFooter). Obsługuje warianty ecommerce, floating i sticky.
Reikalavimai
- PrestaShop 8.0 arba naujesnė versija;
- svetainės raktas
CF-…z aplikacji CallFlow; - pirmiausia įdiekite beta versiją sustojimo parduotuvėje.
Žingsnis po žingsnio diegimas
- Atsisiųskite modulį - failas
callflow-prestashop8-1.1.0.zipz sekcji Atsisiųsti. - Įdiegti skydelyje – eikite į Moduliai → Modulio tvarkyklė → Įkelti modulį ir nukreipkite žymiklį į atsisiųstą ZIP. Modulį rasite kategorijoje „Reklama ir rinkodara“.
- Konfigūruoti - spustelėkite Konfigūruoti CallFlow moduliui ir:
- įklijuoti PUBLIC_SITE_KEY;
- pasirinkite Variantas: elektroninė prekyba (numatytasis), slankioji arba prilipusi;
- rinkinys Valdiklio antraštė (numatytasis "Turite klausimų apie šį produktą?" - įveskite savo lenkų kalba);
- nurodykite privatumo politikos adresas parduotuvė;
- nustatyti jungiklį Įjungta į "Taip" ir spustelėkite Išsaugoti.
Dažnos problemos
- Klaida „CallFlow raktas turi prasidėti CF-“ - modulis patvirtina rakto formatą; nukopijuokite jį iš programos be tarpų.
- Valdiklis nerodomas po išsaugojimo - išvalyti parduotuvės talpyklą (Išplėstinė → Našumas → Išvalyti talpyklą) ir patikrinkite, ar jungiklis Įjungta nustatytas į "Taip".
- Tema neiškviečia poraštės – valdiklis prijungtas prie kabliuko
displayFooter; jeśli Twój motyw go nie renderuje, podepnij moduł do innego hooka w Išvaizda → Elementai.
Kitos platformos
Šios integracijos yra techninės 1.1.0 beta versijos – pirmiausia įdiekite jas savo kūrimo aplinkoje. Visas pakuotes rasite skiltyje Atsisiųsti.
Drupal 10/11
Įdiegę modulį, eikite į Konfigūracija → Tinklo paslaugos → CallFlow, įklijuokite viešąjį svetainės raktą ir pasirinkite variantą.
Joomla 4/5
Įdiegę įgalinkite papildinį Sistema – CallFlow (v Sistema → Papildiniai), įklijuokite PUBLIC_SITE_KEY, wybierz wariant i podaj adres polityki prywatności.
Magento 2 / Adobe Commerce
Kopijuoti modulį į app/code/CallFlow/Callback, uruchom bin/magento setup:upgrade i skonfiguruj go w Parduotuvės → Konfigūracija → Bendra → CallFlow. Modulis turi scenarijaus ir API CSP baltąjį sąrašą samael.pl, więc nie musisz ręcznie modyfikować polityki bezpieczeństwa treści.
e107 2.3
Įdiegę atidarykite CallFlow konfigūraciją, įklijuokite raktą CF-…, wybierz wariant i włącz widget.
Strapi 4/5
Papildinys suteikia viešą pod konfigūraciją /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
Į paketą įeina šaltinio kodas Temos programos plėtinys (programos įterpimas slankiajam valdikliui ir programos blokui su forma, įdėta skyriuje) – tai ne parduotuvės diegimo programa. Diegimui reikalinga „Shopify Partner“ programa ir kūrėjų parduotuvė:
shopify app dev shopify app deploy
Įdiegęs pardavėjas suaktyvina CallFlow in Temos nustatymai → Programų įterpimai arba prideda formos bloką prie temos skyriaus.
API kūrėjams
„CallFlow“ teikia REST API versiją 1.2.0 – ta pati sutartis galioja programai mobiliesiems ir viešiesiems valdikliams.
Pagrindai
- Bazinis URL:
https://callflowdesk.com/api/v1 - Autentifikavimas: antraštę
Authorization: Bearer <access_token>(JWT). Token uzyskasz przezPOST /auth/login, a odświeżysz przezPOST /auth/refreshzrefresh_token. - Nėra prieigos rakto veikia tik:
/auth/register,/auth/login,/auth/refreshoraz/public/leads. - Klaidos: formato atsakymus
application/problem+jsonz polamitype,title,status,code,detail,trace_idi (dla walidacji)errors. - Puslapiai: sąrašai grįžta
next_cursor; kolejną stronę pobierzesz parametrem zapytaniacursor.
Auth – registracija ir seanso gyvavimo ciklas
| Metodas | Kelias | Aprašymas |
|---|---|---|
POST | /auth/register | Sukuria pagrindinę paskyrą ir grąžina aktyvią seansą (reikalingas el. paštas, slaptažodis ir priimtų sąlygų ir privatumo politikos versija). |
POST | /auth/login | Prisijungia vartotojas su el. pašto adresu ir slaptažodžiu, grįžta access_token, refresh_token i expires_in. |
POST | /auth/refresh | Sąrašai refresh_token na nową parę tokenów sesji. |
POST | /auth/logout | Anuliuoja dabartinę prisijungusio vartotojo sesiją. |
Paskyra – pagrindinė sąskaita, antrinės sąskaitos ir statistika
| Metodas | Kelias | Aprašymas |
|---|---|---|
GET | /account | Grąžina aktyvią paskyrą su vaidmeniu (main/sub), strefą czasową i uprawnieniami użytkownika. |
DELETE | /account | Visam laikui ištrina paskyrą su visais duomenimis (tik pagrindiniam vaidmeniui; reikalingas slaptažodis ir tik Google paskyra – patvirtinimo frazė „IŠTRINTI PASKYRĄ“). |
GET | /account/export | Grąžina paskyros duomenų eksportą JSON formatu, apribotą prisijungusio vartotojo matoma apimtimi. |
GET | /account/consents | Grąžina teisinių dokumentų (reglamentų, privatumo, rinkodaros) priėmimo istoriją. |
POST | /account/purge-completed | Hard ištrina galutinės būsenos bilietus kartu su pastabomis, eilės įrašais ir pranešimais (tik pagrindiniam vaidmeniui). jūsų svetainės |
POST | /account/sub-users/invitations | Siunčia pakvietimą antriniam vartotojui su priskyrimu pasirinktiems šaltiniams. |
GET | /dashboard | Pateikia aktyvią paskyros statistiką: šiandienos skambučius, suplanuotus ir užbaigtus skambučius bei šaltinio įkėlimą. |
Šaltiniai – svetainės ir kontaktų paketai
| Metodas | Kelias | Aprašymas |
|---|---|---|
GET | /sources | Grąžina vartotojui prieinamus puslapius ir paketus (filtras kind, paginacja kursorem). |
POST | /sources | Sukuria naują puslapį arba kontaktų paketą su darbo valandomis ir numatomu skambučio laiku. |
GET | /sources/{sourceId} | Grąžina vieno puslapio arba paketo informaciją. |
PATCH | /sources/{sourceId} | Atnaujina pasirinktus šaltinio laukus (sujungimo pataisa: pavadinimas, adresas, darbo valandos, būsena ir kt.). |
DELETE | /sources/{sourceId} | Archyvuokite šaltinį išsaugodami užklausų istoriją. |
POST | /sources/{sourceId}/rotate-key | Sugeneruoja naują viešosios svetainės raktą; senasis iš karto nustoja veikti. |
GET | /sources/{sourceId}/install-code | Grąžina paruoštą valdiklio diegimo kodą kartu su QR kodo raktu ir duomenimis. |
POST | /sources/{sourceId}/send-instructions | El. paštu siunčia diegimo instrukcijas (numatytasis – prisijungusio vartotojo adresas). |
Potencialūs klientai – atgalinio skambinimo užklausos ir jų būsenos
| Metodas | Kelias | Aprašymas |
|---|---|---|
GET | /leads | Grąžina vartotojui prieinamus bilietus (filtrus source_id i status, paginacja kursorem). |
GET | /leads/{leadId} | Pateikia vieno bilieto informaciją. |
PATCH | /leads/{leadId}/status | Pakeičia bilieto būseną (pvz., handled, no_answer, spam) z opcjonalnym uzasadnieniem. |
Tvarkaraštis – skambučių planavimas
| Metodas | Kelias | Aprašymas |
|---|---|---|
POST | /leads/{leadId}/schedule-next | Planuoju pokalbį kitą laisvą dieną; grįžta 409, gdy w dozwolonym horyzoncie nie ma terminu. |
GET | /schedule | Grąžina tam tikro laikotarpio skambučių kalendorių (būtini parametrai from i to, opcjonalny filtr source_id). |
Įrenginiai – stūmimo įrenginiai
| Metodas | Kelias | Aprašymas |
|---|---|---|
GET | /devices | Pateikia naudotojo aktyvių mobiliųjų įrenginių, užregistruotų gauti tiesioginius pranešimus, sąrašą. |
DELETE | /devices/{deviceId} | Atšaukia įrenginį – jis nustoja gauti pranešimų. |
Viešas – valdiklių galiniai taškai
| Metodas | Kelias | Aprašymas |
|---|---|---|
POST | /public/leads | Priima užklausą iš valdiklio be autentifikavimo – reikia antraštės Idempotency-Key i publicznego klucza strony; zwraca 202 z potwierdzeniem, nie ujawniając danych konta. |
Pavyzdys: prisijungimas
curl -X POST https://callflowdesk.com/api/v1/auth/login \ -H "Content-Type: application/json" \ -d '{"email":"jan@firma.pl","password":"TwojeBezpieczneHaslo"}'
Atsakyti 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"
Pavyzdys: galimo kliento siuntimas viešai
Galutinis taškas POST /public/leads nie wymaga tokenu — identyfikuje stronę po publicznym kluczu CF-…. Nagłówek Idempotency-Key jest reikalingas (16–128 simboliai, pvz., UUID): dar kartą bandant pateikti užklausą naudojant tą patį raktą, nepasikartos užklausa.
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": "" }'
Privalomi laukai: 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 programa
Programa CallFlow yra jūsų skambučių komandų centras: čia pateikiamos visos valdiklių ataskaitos, čia tvarkote puslapius, klavišus ir atgalinio skambučio kalendorių. Programa netrukus pasirodys Google Play – iki tol diegimo paketą rasite skiltyje Atsisiųsti.
Pagrindinės funkcijos
- Skambučių eilė - naujos užklausos automatiškai siunčiamos į atitinkamą projektą ir įtraukiamos į eilę pagal darbo valandas ir numatomą pokalbio laiką; būsenos (naujas, vykdomas, tvarkomas, praleistas, šlamštas) organizuoja darbą.
- Tvarkaraštis – atgalinio skambučio kalendorius su automatiniu kito laisvo susitikimo planavimu vienu paspaudimu.
- Push pranešimai – kiekviena nauja ataskaita iš karto suaktyvina pranešimą; Nustatymuose tvarkote registruotų įrenginių sąrašą ir galite atšaukti prieigą prie prarasto telefono.
- Subsąskaitos - kaip paskyros savininkas (pagrindinis vaidmuo), kviečiate kolegas (antrinis vaidmuo) el. paštu ir priskiriate jiems pasirinktus puslapius; jie mato tik jiems priskirtus šaltinius ir ataskaitas.
- Duomenų eksportavimas – visas paskyros duomenų (puslapių, ataskaitų, tvarkaraščio, sutikimų) eksportavimas į JSON failą pagal BDAR.
- Paskyros ištrynimas - nuolatinis paskyros su visais duomenimis ištrynimas tiesiai iš programos (reikalingas slaptažodžio patvirtinimas, o "Google" paskyroms - frazė "IŠTRINTI PASKYRĄ"); detalės skyriuje Ištrinkite paskyrą.
Trikčių šalinimas
Valdiklis iš viso nerodomas
Dažniausia priežastis yra neteisingas raktas. Patikrinkite atributą 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.
Valdiklis rodo pranešimą „Netinkama konfigūracija“.
Raktas tinkamo formato, bet neaktyvus. Taip nutinka, kai sugeneruojamas naujas raktas (pasukimas iš karto anuliuoja senąjį) arba puslapis suarchyvuojamas. Eikite į išsamią svetainės informaciją programoje ir nukopijuokite dabartinė raktą ir pakeiskite jį savo kodo arba papildinio nustatymuose.
Forma veikia, bet programos nepasiekia programos
Patikrinkite svetainės būseną programoje: programas priima tik aktyvios svetainės. Pristabdytas arba suarchyvuotas puslapis nepriima naujų potencialių klientų. Taip pat patikrinkite, ar nežiūrite ataskaitų su būsenos filtru arba antrinėje paskyroje be prieigos prie šio puslapio.
Valdiklis du kartus pasirodo „WordPress“ su „WooCommerce“
Turite abu aktyvius papildinius: bazinį CallFlow ir CallFlow, skirtą WooCommerce. Nuo 1.1.0 versijos WooCommerce įskiepis automatiškai išjungia visuotinį bazinį valdiklį – atnaujinkite abu į 1.1.0. Jei problema išlieka, panaikinkite žymėjimą „Įgalinti valdiklį visame pasaulyje“. Nustatymai → CallFlow. Taip pat atsiminkite šį trumpąjį kodą [callflow] sam wyłącza widget globalny na danej podstronie.
Parduotuvė su ribojančiu CSP blokuoja valdiklį
Jei svetainė siunčia turinio saugos politikos antraštę, pridėkite domeną 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.
Valdiklis nesiunčia ataskaitų apie localhost
Tai tyčinis: laukas 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.
Kaip pakeisti valdiklio spalvas neredaguojant puslapio CSS?
Naudokite Easy lygio atributus tiesiai ant žymos <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 Personalizavimasir paruošti rinkiniai demonstracinėje galerijoje.
Kur galiu rasti savo svetainės CF raktą?
CallFlow programoje atidarykite "Paketai ir puslapiai", pasirinkite puslapį - klavišą 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.
Negaunu tiesioginių pranešimų apie naujas ataskaitas
Patikrinkite, ar programa turi leidimą gauti pranešimus „Android“ nustatymuose ir ar jūsų įrenginys yra programos įrenginių sąraše ir nebuvo atšauktas. Išjunkite „CallFlow“ akumuliatoriaus optimizavimą, jei sistema užmigdo programą fone.
Sukūriau naują raktą ir valdiklis nustojo veikti
Rakto pasukimas iš karto anuliuoja ankstesnįjį – tai saugumo funkcija. Sugeneravę naują raktą atnaujinkite jį visose vietose, kur yra įdėtas valdiklis: svetainės kode ir kiekvieno TVS įskiepio nustatymuose.