Integrace Planfix
Integrujte SMSBAT s Planfix CRM pro odesílání zpráv Viber a SMS přímo z úloh a chatů Planfix. Tato příručka pokrývá nastavení, konfiguraci šablony a automatizaci chatu.
Přehled
Integrace SMSBAT s Planfix vám umožňuje:
- Odesílejte Viber a SMS zprávy klientům z úloh Planfix
- Automaticky vytvářet úkoly z příchozích zpráv chatu
- Znovu otevřít chaty, když klienti odpoví
- Sledujte stav doručení zpráv v rámci Planfix
Předpoklady
- Aktivní účet SMSBAT s přihlašovacími údaji API
- Účet Planfix s přístupem správce
- Schválená šablona zprávy Viber Business (pro transakční zprávy)
Krok 1: Připojte integraci
1.1 Povolte Chat API v Planfix
Ve svém účtu Planfix přejděte na Správa účtu > Integrace > Chaty > Planfix Chat API.
Vyberte integraci SMSBAT ze seznamu a povolte ji.

1.2 Konfigurace integračních parametrů
Vyplňte nastavení integrace pomocí přihlašovacích údajů poskytnutých SMSBAT:
| Parametr | Popis |
|---|---|
| URL požadavku | Adresa URL poskytnutá službou SMSBAT pro příjem požadavků |
| Autorizační klíč | Váš autorizační klíč SMSBAT |
| Poskytovatel | smsbat |
| Adresa URL oznámení | URL webhooku pro příjem oznámení o doručení z Planfixu, např. https://api.smsbat.com.ua/planfix/auth/uuid=... |
| ID poskytovatele | smsbat |
| Planfix Autorizační klíč | Autorizační klíč pro stranu Planfix |
| Šablona úkolu | Vyberte šablonu, kterou chcete použít pro vytváření úkolů pomocí chatu |
| Kontaktní šablona | Vyberte šablonu pro vytváření nových kontaktů |

Získání přihlašovacích údajů
Kontaktujte podporu SMSBAT na adrese help@smsbat.com a získejte své integrační pověření (URL požadavku, autorizační klíč a URL upozornění).
1.3 Nastavení vytváření úkolů
Nakonfigurujte, jak Planfix zpracovává příchozí zprávy chatu:
- Vytvořit nový úkol, pokud s tímto kontaktem nejsou žádné aktivní úkoly - Tuto možnost povolte, pokud váš pracovní postup zahrnuje krátké interakce nebo zpracování potenciálních zákazníků, kde by každý dotaz měl vytvořit nový úkol.
- Pokud jsou vaše prodejní cykly delší nebo poskytujete průběžnou podporu, je lepší znovu otevřít stávající úkoly, abyste zachovali úplnou historii konverzace s klientem.

Krok 2: Šablona a nastavení automatizace chatu
2.1 Konfigurace šablony pozdravu
Dohodněte se s klientem na šabloně uvítací zprávy. K zahájení chatu použijte šablonu transakční zprávy, protože je cenově výhodnější než reklamní zpráva.
2.2 Nastavení šablony úloh
Přidejte schválenou šablonu uvítací zprávy do šablony úkolu pole popisu. Po vytvoření úkolu bude text z popisu odeslán klientovi jako první zpráva.
Příklad konfigurace šablony úkolu:
| Pole | Hodnota |
|---|---|
| Název úkolu | "Požadavek Viber Business" |
| Telefon | Telefonní číslo klienta |
| Protistrana | Klientská protistrana |
| Popis | Vaše schválená šablona uvítací zprávy |

2.3 Pracovní postup rychlých interakcí
Pokud váš pracovní postup zahrnuje rychlé zpracování, kdy nemusíte vést dlouhé rozhovory:
- Zpracujte dotaz klienta na chat
- Odpovězte klientovi prostřednictvím chatu v úloze
- Nastavte stav úkolu na Dokončeno
- Když klient odešle novou zprávu, automaticky se vytvoří nová úloha (pokud je zaškrtnuto políčko z kroku 1.3)
2.4 Pracovní postup probíhajících konverzací
Pokud nechcete pro každou zprávu klienta vytvářet samostatnou úlohu, nastavte automatizaci opětovného otevření chatu.
2.4.1 Znovu otevřít chat prostřednictvím transakční zprávy
Vytvořte scénář automatizace, který se spustí, když se stav úlohy změní na Dokončeno nebo Hotovo:
Scénář: "Znovu otevřít chat"
| Nastavení | Hodnota |
|---|---|
| Událost | Hodnota pole změněna |
| Pole | Zahájit chat |
| Podmínky | Zahájit chat = Ano A Stav v (Dokončeno, Hotovo) |
| Logika filtru | "1 A 2" |
Akce:
- Přidejte komentář pomocí šablony uvítací zprávy (upozornění kontaktu jako příjemce)
- Nastavte pole
Start chatna zaškrtnuté - Aktualizujte plánované datum dokončení na aktuální datum + 1 hodinu

2.4.2 Znovu otevřít chat u nového komentáře
Vytvořte scénáře automatizace, které znovu otevřou chat, když je přidán nový komentář (buď od potenciálního zákazníka/klienta nebo od zaměstnance):
Scénář: "Znovu otevřít chat (zaměstnanec)"
| Nastavení | Hodnota |
|---|---|
| Událost | Komentář přidán odpovídající podmínky |
| Podmínky | Stav v (Dokončeno, Hotovo) A Autor komentáře = Zaměstnanec |
| Logika filtru | "1 A 2" |
Akce:
- Změňte stav na Probíhá
- Aktualizujte plánované datum dokončení na aktuální datum + 1 hodina
- Aktualizujte název úlohy aktuálním časovým razítkem a informacemi o klientovi

Scénář: "Znovu otevřít chat (klient)"
| Nastavení | Hodnota |
|---|---|
| Událost | Komentář přidán odpovídající podmínky |
| Podmínky | Stav v (Dokončeno, Hotovo) A Autor komentáře = Kontakt |
| Logika filtru | "1 A 2" |
Akce:
- Změňte stav na Nový
- Aktualizujte plánované datum dokončení na aktuální datum + 1 hodina
- Aktualizujte název úlohy aktuálním časovým razítkem a informacemi o klientovi

Krok 3: Odesílání zpráv (oznámení pro potenciální zákazníky)
Příjemci oznámení
Při odesílání komentáře (upozorňování potenciálního zákazníka) se ujistěte, že je kontakt (potenciální zákazník) v seznamu oznámení označen jako příjemce. Pamatujte, že stav zaškrtávacího políčka se může lišit v závislosti na podmínkách, proto jej před odesláním ověřte.
3.1 Zaškrtávací políčko nezaškrtnuté – klient zprávu neobdrží
Pokud není zaškrtávací políčko potenciálního zákazníka v seznamu příjemců zaškrtnuto, klient oznámení ne neobdrží. Toto můžete použít k tomu, abyste nechali interní komentáře viditelné pouze pro váš tým.

3.2 Zaškrtávací políčko – klient obdrží zprávu
Pokud je zaškrtnuto políčko potenciálního zákazníka, bude zpráva odeslána klientovi přes Viber nebo SMS přes SMSBAT.

3.3 Ověření doručení zprávy
Zkontrolujte stav doručení v Planfix
Kliknutím na ikonu zaškrtnutí vedle odeslané zprávy zobrazíte zprávu o doručení pro všechny příjemce tohoto komentáře.

Ověřte v protokolu o doručení
V protokolu o doručení by měl být klient uveden jako příjemce se stavem Odesláno (bez chybového stavu). Zpráva zobrazuje datum, kanál (chat API), telefonní číslo příjemce a stav doručení.
Nejlepší postupy
Nastavení šablony
- Použijte transakční zprávy šablony pro zahájení chatu (cenově efektivnější než promo)
- Udržujte uvítací zprávy stručné a relevantní
- Před vytažením šablonu vyzkoušejte v malé skupině
Správa úloh
- Použijte samostatné šablony úkolů pro různé typy zpráv Viber Business
- Zaškrtněte políčko automatického vytváření úkolů, pokud zpracováváte krátké, jednorázové dotazy
- Udržujte úkoly otevřené pro pokračující vztahy s klienty, abyste zachovali historii chatu
Automatizace
- Nastavte scénáře opětovného otevírání komentářů zaměstnanců i klientů
- Použijte plánovaná data dokončení ke sledování SLA
- Pečlivě nakonfigurujte příjemce oznámení, abyste se vyhnuli nechtěným zprávám
Odstraňování problémů
Zprávy se neodesílají
- Ověřte správnost integračních pověření v nastavení Planfix
- Zkontrolujte, zda je telefonní číslo kontaktu ve správném formátu
- Ujistěte se, že je zájemce označen jako příjemce v seznamu upozornění na komentáře
- Ověřte, zda je šablona zprávy schválena
Úkoly se nevytvářejí automaticky
- Potvrďte, že je zaškrtnuto políčko „Vytvořit nový úkol, pokud nejsou žádné aktivní úkoly“.
- Zkontrolujte, zda je šablona úlohy správně nakonfigurována
- Ověřte, zda je adresa URL upozornění správně nastavena
Chat se znovu neotevře
- Zkontrolujte, zda jsou aktivní scénáře automatizace
- Ověřte, že stavové podmínky odpovídají vašim stavům pracovního postupu
- Ujistěte se, že je správně nakonfigurováno pole
Start chat
Další kroky
– SMSBAT API – Další informace o odesílání zpráv prostřednictvím rozhraní API – Cascade API – Nastavte vícekanálové doručování zpráv – Typy zpráv – Prozkoumejte dostupné typy zpráv - Stav doručení - Vysvětlení stavů doručení