Tok rada: WhatsApp → Lid / Podrška

Uključeni moduli: WhatsApp (Inbox · Botovi · Kampanje · Šabloni) · WhatsApp API (Obaveštenja o događajima) · Lidovi · Tiketi · Marketinška automatizacija
Ko ga koristi: Prodaja · Korisnička podrška · Marketing
Tipično trajanje: U realnom vremenu (dolazne poruke) + ciklus kampanje (jednokratne/periodične)

Pregled

CRMConnect ima tri različita WhatsApp modula sa potpuno različitim svrhama:

Ovaj tok rada pokriva glavni whatsapp modul (inbox + auto-lid + botovi + kampanje) i whatsapp_api (obaveštenja o događajima).

Napomena: Automatsko kreiranje tiketa iz WhatsApp razgovora je delimično implementirano (AI prikuplja podatke, ali insert u tbltickets nedostaje iz koda). Tikete ručno kreiraju zaposleni iz interfejsa za čet.

Dijagram toka

[PODEŠAVANJE — admin, samo jednom]
  │
  ├── Meta App + WhatsApp Business nalog konfigurisan
  ├── Webhook registrovan kod Meta: {site_url}/whatsapp/webhook/getdata
  ├── Broj telefona povezan u WhatsApp → Brojevi
  ├── Šabloni učitani iz Meta (ručna sinhronizacija ili cron na sat)
  └── Auto-lid omogućen (opciono): whatsapp_auto_lead_settings = 'enable'
  │
  ↓
[DOLAZNA PORUKA]
  │
  ├── Meta šalje webhook POST na /whatsapp/webhook/getdata
  ├── Sistem pretražuje broj u: lidovima → kontaktima → zaposlenima
  │
  ├── BROJ IDENTIFIKOVAN → mapira razgovor na postojeći zapis
  │     rel_type = 'leads' / 'contacts' / 'staff'
  │
  └── NEPOZNAT BROJ:
        ├── auto_lead OMOGUĆEN → automatski kreira Lid
        │     status = whatsapp_lead_status
        │     izvor = whatsapp_lead_source
        │     dodeljen = whatsapp_lead_assigned
        │     rel_type = 'leads'
        │
        └── auto_lead ONEMOGUĆEN (podrazumevano) → rel_type = 'general'
              zaposleni vidi razgovor kao nepoznat u inboxu
  │
  ↓
[BOT (ako je aktivan)]
  │
  ├── BotHandler::processBots() procenjuje SVE aktivne botove
  ├── Podudaranje okidača → šalje automatski odgovor (tekst / šablon / meni / AI)
  └── Nema podudaranja → poruka ostaje u inboxu za ručni odgovor
  │
  ↓
[ODGOVOR ZAPOSLENOG / ESKALACIJA]
  │
  ├── Zaposleni otvara /admin/whatsapp → inbox
  ├── Vidi razgovore grupisane: identifikovani (lid/kontakt) + opšti
  ├── Odgovara direktno ili koristi Brze odgovore
  └── Ručno kreira tiket iz razgovora (ako podrška to zahteva)
  │
  ↓
[MASOVNA KAMPANJA (odvojen tok)]
  │
  ├── Kreiran odobreni Meta šablon
  ├── Nova kampanja: tip (jednokratna/periodična/prilagođena), primaoci, broj pošiljaoca
  ├── send_now=1 ili planirano scheduled_send_time
  └── Cron izvršava slanje → status po primaocu: neuspešno(0) / uspešno(2) / nevažeće(3)
  │
  ↓
[OBAVEŠTENJA O DOGAĐAJIMA — modul whatsapp_api]
  │
  ├── Kreiran lid → šablon mapiran na kategoriju 'leads' šalje se automatski
  ├── Kreiran tiket → šablon mapiran na 'ticket' šalje se automatski
  ├── Dodata faktura → šablon mapiran na 'invoice'
  └── Evidentirana uplata → šablon mapiran na after_payment_added

[RAZGOVOR ZATVOREN / LID KVALIFIKOVAN ✓]

Korak po korak

1. Podešavanje Meta + veza (admin)

Gde: /admin/whatsapp → Podešavanja → kartica Veza

Uslov: Sva polja ispod su dostupna samo za is_admin() — obično osoblje nema pristup.

URL webhook-a za registraciju kod Meta:

{site_url}/whatsapp/webhook/getdata

Potrebne Meta pretplate: messages + message_status_updates.

Brojevi telefona: nakon povezivanja akreditiva, brojevi se dodaju u WhatsApp → Brojevi (putem OAuth-a ili ručno). Postavite jedan broj kao podrazumevani za odlazne poruke.

Šabloni: WhatsApp → Šabloni → Učitaj šablone (sinhronizuje sa Meta). Cron automatski osvežava na sat.

2. Konfiguracija auto-lida (opciono)

Gde: /admin/whatsapp → Podešavanja → kartica Auto Lid

Tok identifikacije broja (po redosledu):

1. Pretraga u tblleads.phonenumber (normalizovano bez nenumeričkih znakova)
2. Pretraga u tblcontacts.phonenumber
3. Pretraga u tblstaff.phonenumber
4. Nema podudaranja → kreiranje lida (ako je auto_lead omogućen) ili ostaje kao general

3. Konfiguracija bota (opciono)

Gde: /admin/whatsapp → Botovi → Novi bot

Tipovi okidača (reply_type):

Tipovi odgovora (bot_type):

Konfiguracija AI (za bot_type=12): Gde: Podešavanja → kartica AI: izaberite provajdera (openai/gemini), unesite API ključ, postavite whatsapp_openai_status:

• auto = AI automatski odgovara na sve poruke koje nemaju podudaranje na drugim botovima
• manual = AI generiše predlog odgovora vidljiv zaposlenima, ali ne šalje automatski

4. Inbox i ručni odgovor

Gde: /admin/whatsapp (zahteva dozvolu whatsapp_chat → view)

Razgovori su grupisani po rel_type:

• leads — razgovori povezani sa lidovima
• contacts — razgovori povezani sa kontaktima
• staff — razgovori sa zaposlenima
• general — neidentifikovani brojevi (auto_lead onemogućen)

Zaposleni mogu:

• Odgovoriti tekstom, fajlovima, Brzim odgovorima (tblquick_replies)
• Dodeliti razgovor drugom zaposlenom
• Ručno kreirati Tiket iz interfejsa (tiket se NE kreira automatski)
• Pregledati kompletnu istoriju poruka (tblwhatsapp_interaction_messages)

5. Masovne kampanje

Gde: /admin/whatsapp → Kampanje → Nova kampanja

Preduslovi:

• Odobreni Meta šablon (status = 'APPROVED' u tblwhatsapp_interaction_templates)
• Barem jedan konfigurisani broj telefona

Polja kampanje:

Statusi po primaocu (tblwhatsapp_campaign_data):

Statusi isporuke (message_status): sent → delivered → read

Napomena: Kampanje izvršava cron, ne odmah. Ako CRM cron ne radi, planirane kampanje se ne šalju.

6. Automatska obaveštenja o CRM događajima (modul whatsapp_api)

Gde: /admin/whatsapp_api → Mapiranje šablona

Modul whatsapp_api se aktivira nezavisno od inboxa, na osnovu hook-ova:

Konfiguracija po obaveštenju:

1. Sinhronizujte šablone: WhatsApp API → Šabloni → Učitaj
2. Kreirajte mapiranje: WhatsApp API → Mapiranje šablona → Dodaj
3. Odaberite šablon + kategoriju + send_to (kontakt / lid / zaposleni) + parametre zaglavlja/tela/podnožja

Modul whatsapp_api deli Meta akreditive sa modulom whatsapp (isti access_token i phone_number_id), ali ih čuva odvojeno u sopstvenim opcijama.

Potrebne dozvole

Česte greške

Reference modula

• WhatsApp — dokumentacija glavnog modula
• Lidovi — automatski kreirani lidovi
• Tiketi — ručno kreiranje tiketa
• Marketinške kampanje — email kampanje (odvojeno od WA)