Sekcija: Marketing i Komunikacija
URL:/admin/whatsapp
Pregled
WhatsApp je potpuno opremljeno čvorište za razmenu poruka unutar CRMConnect-a, izgrađeno na WhatsApp Business API-ju (WABA / Meta Cloud API). Pokriva kompletan životni ciklus WhatsApp komunikacije: dvosmerni ćaskanje u realnom vremenu sa potencijalnim i postojećim klijentima, automatizovani tokovi chatbota, kampanje masovnih poruka sa odobrenim predlošcima, grupe kontakata za segmentaciju publike i samostalni direktorijum kontakata za masovni kontakt — sve sa granularnim dozvolama zasnovanim na ulozi po podmodulu.
Poslovna Vrednost
- Ko ga koristi: Prodajni predstavnici (ćaskanje), marketing (kampanje, botovi), CRM administratori (brojevi, predlošci, grupe)
- Ključna prednost: Objedinjavanje svake WhatsApp tačke dodira — individualnih razgovora, masovnih kampanja i automatizovanih odgovora — na jednom mestu povezanom sa CRM zapisima.
- Metrike na koje utiče: Vreme odgovora, stopa konverzije potencijalnih klijenata, stopa isporuke/čitanja kampanje, preusmeravanje podrške
Tipični slučajevi korišćenja:
- Prodajni predstavnik direktno ćaska sa potencijalnim klijentom iz CRM-a; razgovor je povezan sa zapisom potencijalnog klijenta i automatski evidentiran
- Marketing šalje promotivnu kampanju filtriranoj grupi kontakata koristeći Meta-odobreni predložak poruke
- Chatbot odgovara na česta pitanja van radnog vremena i usmerava razgovor odgovarajućem zaposlenom na osnovu odgovora
- Predlozi i fakture šalju se klijentima putem WhatsApp-a jednim klikom putem integracije predloška zasnovane na akciji
Podmoduli na Jednom Mestu
| Podmodul | URL | Svrha |
|---|---|---|
| Ćaskanje (Interakcija) | /admin/whatsapp/interaction |
Dvosmerno ćaskanje u realnom vremenu sa potencijalnim i postojećim klijentima |
| Botovi | /admin/whatsapp/bots |
AI chatbotovi sa vizuelnim Drawflow editorom toka |
| Kampanje | /admin/whatsapp/campaigns |
Masovno slanje poruka sa WABA-odobrenim predlošcima |
| Grupe | /admin/whatsapp/groups |
Grupe kontakata za segmentaciju publike |
| Masovni Kontakti | /admin/whatsapp/BulkContacts |
Samostalni direktorijum WhatsApp kontakata |
| Predlošci | /admin/whatsapp/templates |
Upravljanje i sinhronizacija WABA predložaka poruka |
| Brzi Odgovori | /admin/whatsapp/QuickReplies |
Unapred definisane prečice za odgovor za agente ćaskanja |
| Brojevi | /admin/whatsapp/numbers |
Povezani WhatsApp Business brojevi |
| Veza | /admin/whatsapp/connection |
Akreditivi Cloud API-ja i podešavanje veze |
| Dnevnik Aktivnosti | /admin/whatsapp/activity_log |
Kompletan revizijski trag WhatsApp aktivnosti |
1. Ćaskanje (Interakcija)
URL: /admin/whatsapp/interaction
Dozvola: whatsapp_chat → pregled
Glavni interfejs za ćaskanje. Zaposleni mogu otvoriti bilo koji nit razgovora, slati poruke slobodnog oblika ili predloške, prilagati medije, koristiti brze odgovore i dodeljivati razgovore kolegama. Svaki razgovor je povezan sa CRM zapisom potencijalnog ili postojećeg klijenta.
Ključni Pojmovi
| Pojam | Opis |
|---|---|
| Interakcija | Nit razgovora vezana za određeni broj telefona i WhatsApp Business broj |
| Brzi odgovor | Unapred definisana poruka umetnuta prečicom — videti podmodul Brzi Odgovori |
| Predložak poruke | Meta-odobrena strukturisana poruka koja se koristi za iniciranje razgovora (obavezno van prozora sesije od 24 sata) |
| Dodela | Svaki razgovor može biti dodeljen zaposlenom radi vlasništva i odgovornosti |
| Status potencijalnog klijenta | Status potencijalnog klijenta može se ažurirati direktno iz prikaza ćaskanja |
Uobičajene Akcije
- Otvaranje razgovora — kliknuti na nit u levom panelu za učitavanje istorije poruka.
- Slanje poruke — upisati u kompozitoru i pritisnuti pošalji; koristiti ikonu privitka za medije.
- Umetanje brzog odgovora — upisati
/ili kliknuti ikonu brzog odgovora za izbor unapred definisane poruke. - Slanje predloška — kliknuti ikonu predloška za odabir odobrenog WABA predloška van prozora sesije od 24 sata.
- Dodela razgovora — koristiti kontrolu dodele u zaglavlju za predaju drugom zaposlenom.
- Slanje predloga putem WhatsApp-a — iz menija pregleda predloga, kliknuti „Pošalji Predlog na WhatsApp"; sistem automatski otvara ili kreira interakciju i šalje konfigurisani predložak akcije.
Integracija Predloška Zasnovana na Akciji
Određene CRM akcije mogu automatski poslati WhatsApp predložak kada su konfigurisane u Podešavanja → WhatsApp → Predložak po akciji:
- Predlog poslat — predložak se šalje kada se predlog isporuči putem dugmeta WhatsApp akcije.
- Dodatni okidači akcija (faktura, prodajni nalog itd.) prate isti obrazac.
2. Botovi
URL: /admin/whatsapp/bots
Dozvola: whatsapp_bot → pregled / kreiranje / izmena / brisanje
WhatsApp Botovi su automatizovani agenti za razgovor koji odgovaraju na dolazne poruke na osnovu vizuelnog toka dizajniranog u Drawflow editoru metodom prevuci i pusti. Botovi podržavaju više tipova (ključne reči okidača, zasnovani na meniju, uz AI pomoć) i mogu referisati odobrene WABA predloške za strukturisane odgovore.
Ključni Pojmovi
| Pojam | Opis |
|---|---|
| Bot | Imenovana automatizacija sa uslovom okidača, tokom odgovora i prekidačem aktivan/neaktivan |
| Tip bota | Određuje kako se bot aktivira (podudaranje ključne reči, izbor menija itd.) |
| Tok bota | Vizuelno Drawflow platno koje definiše put razgovora — čvorovi i veze |
| Čvor toka | Korak u razgovoru: pošalji poruku, pošalji predložak, grananje na osnovu odgovora, čekanje, kraj |
| Vezivanje predloška | Korak bota može poslati WABA predložak sa mapiranim header_params, body_params i footer_params |
| Aktivni status | Samo aktivni botovi presreću dolazne poruke; prekida se po botu bez brisanja toka |
Uobičajene Akcije
- Listanje botova —
/admin/whatsapp/botsprikazuje sve botove sa imenom, tipom, statusom i brzim akcijama. - Kreiranje bota — kliknuti Dodaj Bot, popuniti ime, tip i opcioni predložak; sačuvati za kreiranje zapisa.
- Dizajniranje toka — kliknuti ikonu Editor Toka za otvaranje Drawflow platna (
/admin/whatsapp/bots/botflow/{id}); prevlačiti čvorove, povezivati ih, konfigurisati poruku ili predložak svakog čvora, zatim sačuvati. - Aktiviranje / deaktiviranje — koristiti prekidač na redu liste (AJAX poziv na
change_active_status); samo jedan bot treba biti aktivan po opsegu okidača radi izbegavanja sukoba. - Dupliranje bota — koristiti akciju dupliranja za kloniranje konfiguracije i toka bota kao polazne tačke za novi.
- Izmena podešavanja — kliknuti izmeni za ažuriranje imena, tipa, vezivanja predloška ili priloženog medijskog fajla.
- Brisanje fajla bota — ukloniti prilog medija iz bota bez brisanja samog bota.
Napomene o Editoru Toka
- Editor koristi Drawflow (isti motor kao Automatizacija Marketinga).
- JSON toka se čuva u koloni
flow_datai čuva putemupdateFlow. header_params,body_paramsifooter_paramssu JSON nizovi koji mapiraju promenljive predloška na dinamičke vrednosti.
3. Kampanje
URL: /admin/whatsapp/campaigns
Dozvola: whatsapp_campaign → pregled / kreiranje / izmena / brisanje
WhatsApp Kampanje omogućavaju slanje jednog WABA-odobrenog predloška poruke velikom spisku primalaca (potencijalni klijenti, kontakti klijenata ili grupe kontakata) u jednoj operaciji. Status isporuke i čitanja se prati po primaocu.
Ključni Pojmovi
| Pojam | Opis |
|---|---|
| Kampanja | Imenovani posao masovnog slanja koji cilja određenu publiku sa određenim predloškom |
Tip primaoca (rel_type) |
leads, contacts ili grupa kontakata — bira se pri kreiranju kampanje |
| Predložak | Meta-odobreni WABA predložak koji se koristi za telo poruke |
| WhatsApp broj | Broj pošiljaoca (iz spiska povezanih brojeva) |
| Status isporuke | Status po primaocu: na čekanju → poslato → isporučeno → pročitano |
| Isporučeno % | Broj isporučenih poruka kao procenat ukupnih primalaca |
| Pročitano % | Broj pročitanih poruka kao procenat isporučenih poruka |
| Pauza / Nastavak | Pokrenute kampanje mogu biti pauzirane i kasnije nastavljene bez gubitka napretka |
| Fajl kampanje | Opcioni medijski prilog poslan sa predloškom |
Uobičajene Akcije
- Pregled svih kampanja —
/admin/whatsapp/campaignslista kampanje sa statusom i metrikama isporuke. - Kreiranje kampanje — kliknuti Nova Kampanja, izabrati broj pošiljaoca, predložak, tip primaoca (potencijalni klijenti / kontakti / grupa), odabrati pojedinačne primaoce ili celu grupu, opciono priložiti fajl, zatim sačuvati.
- Izmena kampanje — otvoriti postojeću kampanju pre pokretanja za podešavanje primalaca ili mapiranja predloška.
- Pregled izveštaja kampanje — kliknuti na naziv kampanje za prikaz detalja sa isporučenim %, pročitanim % i evidencijom po primaocu.
- Pauza / Nastavak — koristiti kontrolu pauze/nastavka na prikazu detalja kampanje za zaustavljanje ili nastavak slanja.
- Brisanje kampanje — uklanja zapis kampanje i podatke po primaocu.
- Brisanje fajla kampanje — ukloniti medijski prilog bez brisanja kampanje.
- Filtriranje potencijalnih klijenata za kampanju — koristiti
get_filtered_leads(AJAX) za sužavanje spiska primalaca prema kriterijumima potencijalnih klijenata pre čuvanja.
Analitika Kampanje
Detaljan prikaz kampanje (/admin/whatsapp/campaigns/view/{id}) prikazuje:
- Ukupan broj izabranih primalaca u odnosu na ukupan broj u CRM-u (kao %)
- Broj isporučenih i isporučeno %
- Broj pročitanih i pročitano %
4. Grupe
URL: /admin/whatsapp/groups
Dozvola: whatsapp_groups → pregled / kreiranje / izmena / brisanje
Grupe su imenovane kolekcije Masovnih Kontakata koje se koriste za segmentaciju publike za kampanje. Kontakt može pripadati više grupama; grupa može biti targetovana kao spisak primalaca za kampanju.
Uobičajene Akcije
- Listanje grupa —
/admin/whatsapp/groupsprikazuje sve grupe sa imenom i brojem kontakata. - Kreiranje grupe — kliknuti Dodaj Grupu, uneti ime i opcioni opis, sačuvati.
- Izmena grupe — kliknuti izmeni na bilo kom redu za ažuriranje naziva grupe.
- Brisanje grupe — uklanja grupu; kontakti se ne brišu, samo dodela grupi.
5. Masovni Kontakti
URL: /admin/whatsapp/BulkContacts
Dozvola: whatsapp_contacts → pregled / kreiranje / izmena / brisanje
Masovni Kontakti je samostalni direktorijum kontakata specifičan za WhatsApp, odvojen od potencijalnih klijenata i klijenata u CRM-u. Kontakti ovde su primaoci dostupni za kampanje i grupe. Jedinstvenost broja telefona je nametnuta.
Ključni Pojmovi
| Pojam | Opis |
|---|---|
| Kontakt | Zapis sa imenom, brojem telefona, kompanijom, adresom, gradom, državom, zemljom, opisom |
| Jedinstvenost telefona | Svaki broj telefona može se pojaviti samo jedanput; duplikati se odbijaju pri kreiranju i ažuriranju |
| Dodela grupi | Kontakt može biti dodeljen jednoj ili više grupa pri kreiranju ili putem izmene |
| CSV uvoz | Masovni kontakti mogu se uvesti iz CSV fajla; postojeći brojevi telefona pokreću ažuriranje samo dodele grupi umesto dupliranog unosa |
Format CSV Uvoza
Uvoz očekuje fajl razdvojen zarezima sa kolonama u ovom redosledu (red zaglavlja se preskače):
| Kolona | Polje |
|---|---|
| 1 | name |
| 2 | phonenumber |
| 3 | company_name |
| 4 | address |
| 5 | city |
| 6 | state |
| 7 | country |
| 8 | description |
Ako broj telefona već postoji, uvoz preskače kreiranje novog zapisa i samo dodeljuje izabrane grupe postojećem kontaktu.
Uobičajene Akcije
- Listanje kontakata —
/admin/whatsapp/BulkContactsprikazuje sve kontakte sa njihovim članstvima u grupama. - Dodavanje kontakta — kliknuti Dodaj Kontakt, popuniti broj telefona (obavezno, jedinstven), ime i opciona polja; dodeliti jednoj ili više grupa; sačuvati.
- Izmena kontakta — ažurirati bilo koje polje ili promeniti dodele grupama.
- Brisanje kontakta — uklanja kontakt i njegova grupna udruženja.
- Uvoz iz CSV-a — koristiti dugme Uvoz, otpremiti CSV fajl, opciono unapred izabrati grupe za dodelu svim uvezenim kontaktima, zatim potvrditi.
- Masovno brisanje — izabrati više kontakata putem polja za označavanje i koristiti akciju masovnog brisanja.
- Masovna dodela grupama — izabrati više kontakata i dodeliti ih jednoj ili više grupa u jednoj operaciji.
6. Predlošci
URL: /admin/whatsapp/templates
Dozvola: whatsapp_template → pregled / kreiranje / izmena / učitavanje predloška
Predlošci su Meta-odobreni WABA predlošci poruka neophodni za iniciranje razgovora i za poruke kampanja. Podmodul Predlošci se sinhronizuje sa Meta Graph API-jem za listanje, kreiranje i upravljanje predlošcima direktno iz CRMConnect-a.
Ključni Pojmovi
| Pojam | Opis |
|---|---|
| WABA predložak | Meta-odobrena strukturisana poruka sa zaglavljem, telom, podnožjem i opcionalnim dugmadima |
| Model predloška | Unapred definisani CRMConnect predložak za uobičajene akcije dokumenata (predlog, faktura, predračun, storno, prodajni nalog) |
| Mapiranje parametara | Predlošci sa promenljivim ({{1}}, {{2}}) mapiraju se na CRM polja za spajanje u vreme slanja |
parameter_format |
POSITIONAL (numerisani čuvari mesta) ili NAMED — mora odgovarati Meta definiciji predloška |
| Sinhronizacija sa Meta | Predlošci se preuzimaju iz Meta API-ja; prikazuje se status (odobreno / na čekanju / odbijeno) |
Modeli Predložaka
Stranica Modeli Predložaka (/admin/whatsapp/templates/template_models) pruža kreiranje standardnih predložaka u Meta jednim klikom za:
- Predlog
- Faktura
- Predračun
- Storno (kreditna nota)
- Prodajni Nalog
Kliknuti Učitaj u Meta na bilo kom modelu za podnošenje na Meta odobrenje. Jednom odobreni, predložak postaje dostupan za kampanje, botove i slanje zasnovano na akciji.
Uobičajene Akcije
- Pregled predložaka — lista svih predložaka sinhronizovanih iz Meta sa njihovim statusom odobrenja.
- Kreiranje predloška — definisati zaglavlje, telo, podnožje, kategoriju, jezik i podneti Meta-u na odobrenje.
- Izmena predloška — ažurirati nacrt ili odbijeni predložak i ponovo podneti.
- Brisanje predloška — uklanja lokalni zapis i briše iz Meta.
- Učitavanje modela predloška — koristiti stranicu Modeli Predložaka za podnošenje unapred definisanog predloška dokumenta Meta-u jednim klikom (zahteva dozvolu
load_template). - Dobijanje mapiranja predloška — kada se bira predložak u obrascu kampanje ili bota, UI mapiranja parametara se automatski učitava putem AJAX-a za prikaz obaveznih polja promenljivih.
7. Brzi Odgovori
URL: /admin/whatsapp/QuickReplies
Dozvola: quickreplies → pregled / kreiranje / izmena / brisanje
Brzi Odgovori su kratki imenovani tekstualni isečci koje agenti ćaskanja mogu odmah ubaciti u razgovor. Smanjuju vreme odgovora za česta pitanja ili standardne pozdrave.
Uobičajene Akcije
- Listanje brzih odgovora —
/admin/whatsapp/QuickRepliesprikazuje sve sačuvane odgovore sa imenom i pregledom poruke. - Dodavanje brzog odgovora — kliknuti Dodaj, uneti ime (oznaka prečice) i kompletan tekst poruke; sačuvati.
- Izmena brzog odgovora — ažurirati ime ili tekst poruke.
- Brisanje brzog odgovora — uklanja prečicu; više se neće pojavljivati u kompozitoru ćaskanja.
- Korišćenje u ćaskanju — u prikazu Interakcije, kliknuti ikonu brzog odgovora ili upisati prečicu za umetanje kompletnog teksta poruke u kompozitor.
8. Brojevi
URL: /admin/whatsapp/numbers
Dozvola: whatsapp_numbers → pregled
Lista svih WhatsApp Business telefonskih brojeva povezanih sa CRMConnect-om putem Meta Cloud API-ja. Za svaki broj sistem preuzima i kešira poslovni profil iz Meta-e (profilna slika, tekst o kompaniji, adresa, delatnost, email, veb sajtovi).
Ključni Pojmovi
| Pojam | Opis |
|---|---|
| ID telefonskog broja | Meta-ov jedinstveni identifikator za WhatsApp Business telefonski broj |
| Poslovni profil | Ime za prikaz, profilna slika, opis, adresa, email, delatnost preuzeti iz Meta Graph API-ja |
| Proksi profilne slike | Profilne slike se serviraju putem /admin/whatsapp/profile_picture_proxy/{phone_number_id} radi dodavanja potrebnog Bearer tokena — direktni Meta URL-ovi nisu javno dostupni |
Brojevi se dodaju i konfigurisau u Podešavanja → WhatsApp, ne putem ovog prikaza liste. Ova stranica je pregled aktivnih veza samo za čitanje.
9. Veza
URL: /admin/whatsapp/connection
Pristup: Samo administrator
Stranica Veze prikazuje status integracije WhatsApp Cloud API-ja i pruža interfejs za unos ili ažuriranje Meta akreditiva (Access Token, ID telefonskog broja, ID poslovnog naloga, konfiguracija Webhook-a). Samo administratori mogu pristupiti ovoj stranici.
10. Dnevnik Aktivnosti
URL: /admin/whatsapp/activity_log
Hronološki revizijski trag svih WhatsApp akcija izvedenih unutar CRMConnect-a — poslate i primljene poruke, slanje kampanja, aktiviranja botova, slanje predložaka i sistemski događaji. Korisno za pregled usklađenosti i otklanjanje problema isporuke.
Referenca Dozvola
| Resurs dozvole | Kontroliše pristup |
|---|---|
whatsapp_chat |
Pregled i slanje u ćaskanju (Interakcija) |
whatsapp_bot |
Lista botova, editor toka, kreiranje/izmena/brisanje |
whatsapp_campaign |
Lista kampanja, kreiranje/izmena/brisanje/pregled |
whatsapp_groups |
Lista grupa, kreiranje/izmena/brisanje |
whatsapp_contacts |
Lista masovnih kontakata, kreiranje/izmena/brisanje/uvoz |
whatsapp_template |
Lista predložaka, kreiranje/izmena/brisanje/učitavanje predloška |
whatsapp_numbers |
Prikaz liste brojeva |
quickreplies |
Lista brzih odgovora, kreiranje/izmena/brisanje |
Izvor: crm-connect-main/app/modules/whatsapp/controllers/ · Ažurirano: 2026-06-03