Integrácia Planfix
Integrujte SMSBAT s Planfix CRM na odosielanie správ Viber a SMS priamo z úloh a chatov Planfix. Táto príručka sa zaoberá nastavením, konfiguráciou šablóny a automatizáciou chatu.
Prehľad
Integrácia SMSBAT s Planfix vám umožňuje:
- Posielajte Viber a SMS správy klientom z úloh Planfix
- Automaticky vytvárať úlohy z prichádzajúcich správ chatu
- Opätovne otvorte rozhovory, keď klienti odpovedia
- Sledujte stav doručenia správ v rámci Planfix
Predpoklady
- Aktívny účet SMSBAT s povereniami API
- Účet Planfix s prístupom správcu
- Schválená šablóna správy Viber Business (pre transakčné správy)
Krok 1: Pripojte integráciu
1.1 Povoľte Chat API v Planfix
Vo svojom účte Planfix prejdite na Správa účtu > Integrácie > Rozhovory > Rozhranie API Planfix Chat.
Vyberte integráciu SMSBAT zo zoznamu a povoľte ju.

1.2 Konfigurácia integračných parametrov
Vyplňte nastavenia integrácie pomocou poverení poskytnutých službou SMSBAT:
| Parameter | Popis |
|---|---|
| Adresa URL žiadosti | Adresa URL poskytnutá službou SMSBAT na prijímanie požiadaviek |
| Autorizačný kľúč | Váš autorizačný kľúč SMSBAT |
| Poskytovateľ | smsbat |
| Adresa URL upozornenia | URL webhooku na prijímanie oznámení o doručení od Planfix, napr. https://api.smsbat.com.ua/planfix/auth/uuid=... |
| Id poskytovateľa | smsbat |
| Planfix Autorizačný kľúč | Autorizačný kľúč pre stranu Planfix |
| Šablóna úloh | Vyberte šablónu, ktorú chcete použiť na vytváranie úloh s chatom |
| Kontaktná šablóna | Vyberte šablónu pre vytváranie nových kontaktov |

Získanie poverení
Kontaktujte podporu SMSBAT na adrese help@smsbat.com a získajte svoje integračné poverenia (URL žiadosti, autorizačný kľúč a adresa URL upozornenia).
1.3 Nastavenia vytvárania úloh
Nakonfigurujte, ako Planfix spracováva prichádzajúce chatové správy:
- Vytvoriť novú úlohu, ak s týmto kontaktom nie sú žiadne aktívne úlohy - Túto možnosť povoľte, ak váš pracovný postup zahŕňa krátke interakcie alebo spracovanie potenciálneho zákazníka, kde by každá požiadavka mala vytvoriť novú úlohu.
- Ak sú vaše predajné cykly dlhšie alebo poskytujete nepretržitú podporu, je lepšie znova otvoriť existujúce úlohy, aby ste uchovali celú históriu konverzácií s klientom.

Krok 2: Šablóna a nastavenie automatizácie chatu
2.1 Konfigurácia šablóny pozdravu
Dohodnite si s klientom šablónu uvítacej správy. Na začatie četu použite šablónu transakčnej správy, pretože je cenovo výhodnejšia ako propagačná správa.
2.2 Nastavenie šablóny úloh
Pridajte schválenú šablónu uvítacej správy do šablóny úlohy poľa popisu. Po vytvorení úlohy sa text z popisu odošle klientovi ako prvá správa.
Príklad konfigurácie šablóny úlohy:
| Pole | Hodnota |
|---|---|
| Názov úlohy | Viber Business Žiadosť |
| Telefón | Telefónne číslo klienta |
| Protistrana | Klientská protistrana |
| Popis | Vaša schválená šablóna uvítacej správy |

2.3 Pracovný postup rýchlych interakcií
Ak váš pracovný postup zahŕňa rýchle spracovanie, pri ktorom nemusíte viesť dlhé konverzácie:
- Spracujte dopyt klienta na chat
- Odpovedzte klientovi cez chat v úlohe
- Nastavte stav úlohy na Dokončené
- Keď klient odošle novú správu, automaticky sa vytvorí nová úloha (ak je zaškrtnuté políčko z kroku 1.3)
2.4 Pracovný postup prebiehajúcich konverzácií
Ak nechcete vytvárať samostatnú úlohu pre každú správu klienta, nastavte automatizáciu opätovného otvorenia rozhovoru.
2.4.1 Znovu otvorte chat prostredníctvom transakčnej správy
Vytvorte scenár automatizácie, ktorý sa spustí, keď sa stav úlohy zmení na Dokončené alebo Hotovo:
Scenár: „Opätovné otvorenie rozhovoru“
| Nastavenie | Hodnota |
|---|---|
| Udalosť | Hodnota poľa zmenená |
| Pole | Začať chat |
| Podmienky | Začať chat = Áno A Stav v (Dokončené, Hotovo) |
| Filtrovacia logika | "1 A 2" |
Akcie:
- Pridajte komentár pomocou šablóny uvítacej správy (upozornenie kontaktu ako príjemcu)
- Nastavte pole
Start chatna začiarknuté - Aktualizujte plánovaný dátum dokončenia na aktuálny dátum + 1 hodinu

2.4.2 Opätovné otvorenie rozhovoru pri novom komentári
Vytvorte scenáre automatizácie, ktoré znova otvoria chat, keď sa pridá nový komentár (buď od potenciálneho zákazníka/klienta alebo od zamestnanca):
Scenár: "Opätovné otvorenie rozhovoru (zamestnanec)"
| Nastavenie | Hodnota |
|---|---|
| Udalosť | Komentár pridaný zodpovedajúce podmienky |
| Podmienky | Stav v (Dokončené, Hotovo) A Autor komentára = Zamestnanec |
| Filtrovacia logika | "1 A 2" |
Akcie:
- Zmeňte stav na Prebieha
- Aktualizujte plánovaný dátum dokončenia na aktuálny dátum + 1 hodina
- Aktualizujte názov úlohy aktuálnou časovou pečiatkou a informáciami o klientovi

Scenár: "Opätovné otvorenie rozhovoru (klient)"
| Nastavenie | Hodnota |
|---|---|
| Udalosť | Komentár pridaný zodpovedajúce podmienky |
| Podmienky | Stav v (Dokončené, Hotovo) A Autor komentára = Kontakt |
| Filtrovacia logika | "1 A 2" |
Akcie:
- Zmeňte stav na Nové
- Aktualizujte plánovaný dátum dokončenia na aktuálny dátum + 1 hodina
- Aktualizujte názov úlohy aktuálnou časovou pečiatkou a informáciami o klientovi

Krok 3: Odosielanie správ (upozornenia pre potenciálnych zákazníkov)
Príjemcovia upozornení
Pri odosielaní komentára (upozornenie potenciálneho zákazníka) sa uistite, že kontakt (potenciálny zákazník) je v zozname upozornení označený ako príjemca. Upozorňujeme, že stav začiarkavacieho políčka sa môže líšiť v závislosti od podmienok, preto si ho pred odoslaním overte.
3.1 Neoznačené začiarkavacie políčko – klient správu nedostane
Ak nie je začiarknuté políčko potenciálneho zákazníka v zozname príjemcov, klient upozornenie ne nedostane. Môžete to použiť na zanechanie interných komentárov, ktoré budú viditeľné iba pre váš tím.

3.2 Začiarknuté políčko – klient dostane správu
Ak je začiarknuté políčko potenciálneho zákazníka, správa bude klientovi odoslaná cez Viber alebo SMS cez SMSBAT.

3.3 Overenie doručenia správy
Skontrolujte stav doručenia v Planfix
Kliknutím na ikonu začiarknutia vedľa odoslanej správy zobrazíte správu o doručení pre všetkých príjemcov tohto komentára.

Overte v správe o doručení
V správe o doručení by mal byť klient uvedený ako príjemca so stavom Odoslané (bez chybového stavu). Prehľad zobrazuje dátum, kanál (rozhranie API), telefónne číslo príjemcu a stav doručenia.
Osvedčené postupy
Nastavenie šablóny
- Na začatie rozhovoru používajte šablóny transakčných správ (cenovo efektívnejšie ako promo)
- Udržujte uvítacie správy stručné a relevantné
- Pred vyrolovaním otestujte šablónu v malej skupine
Správa úloh
- Používajte samostatné šablóny úloh pre rôzne typy správ Viber Business
- Povoľte zaškrtávacie políčko automatického vytvárania úloh, ak spracovávate krátke, jednorazové otázky
- Udržujte úlohy otvorené pre prebiehajúce vzťahy s klientmi, aby ste zachovali históriu chatu
Automatizácia
- Nastavte scenáre opätovného otvárania komentárov zamestnancov aj klientov
- Na sledovanie SLA použite plánované dátumy dokončenia
- Starostlivo nakonfigurujte príjemcov upozornení, aby ste sa vyhli neúmyselným správam
Riešenie problémov
Správy sa neodosielajú
- Overte, či sú integračné poverenia správne v nastaveniach Planfix
- Skontrolujte, či je telefónne číslo kontaktu v správnom formáte
- Uistite sa, že potenciálny zákazník je označený ako príjemca v zozname upozornení na komentáre
- Overte, či je šablóna správy schválená
Úlohy sa nevytvárajú automaticky
- Potvrďte, že je začiarknuté políčko „Vytvoriť novú úlohu, ak neexistujú žiadne aktívne úlohy“.
- Skontrolujte, či je šablóna úlohy správne nakonfigurovaná
- Skontrolujte, či je adresa URL upozornenia správne nastavená
Chat sa znova neotvára
- Skontrolujte, či sú aktívne scenáre automatizácie
- Overte, či stavové podmienky zodpovedajú vašim stavom pracovného toku
- Uistite sa, že pole
Start chatje správne nakonfigurované
Ďalšie kroky
– SMSBAT API – Prečítajte si o odosielaní správ cez rozhranie API - Cascade API - Nastavte viackanálové doručovanie správ - Typy správ - Preskúmajte dostupné typy správ - Stav doručenia - Pochopenie stavov doručenia