Napojení na CRM

2. Přes n8n nebo Make

Automatizační nástroj přijme data o hovoru a předá je do CRM. Nic se neprogramuje, jen se spojí dva kroky.

1. V n8n nebo Make vytvořte nový scénář a jako první krok zvolte Webhook s metodou POST. Nástroj vám vygeneruje adresu.
2. V administraci otevřete Co se má stát po hovoru, zaškrtněte „Každý vzkaz pošli i do mého systému“, vložte adresu a uložte.
3. Na stránce Napojení na váš systém klikněte na „Poslat zkušební data“. V nástroji se objeví ukázkový hovor se všemi poli.
4. Přidejte druhý krok s vaším CRM, například „Vytvořit kontakt“ nebo „Vytvořit úkol“, a pole spárujte podle tabulky.

3. Webhookem

Adresu svého systému zadáte v administraci na stránce Co se má stát po hovoru u věty „Každý vzkaz pošli i do mého systému“. V pokročilém nastavení můžete posílat i hovory bez vzkazu, naléhavé hovory nebo hovory, ve kterých zazní určité slovo.

Na adresu pošleme požadavek POST s daty ve formátu JSON:

{
  "udalost": "hovor.dokoncen",
  "klient": { "id": 12, "nazev": "Ordinace Novák" },
  "hovor": {
    "id": 4821,
    "nazev": "Vypadlá plomba, chce termín",
    "zacatek": "2026-10-08T09:42:11+02:00",
    "delka_sekund": 68,
    "telefon": "+420777555010",
    "jmeno": "Jana Dvořáková",
    "nechal_vzkaz": true,
    "stav": "Čeká na vyřízení",
    "shrnuti": "Paní Dvořáková má vypadlou plombu, bolí to, chce termín tento týden.",
    "udaje": { "duvod_navstevy": "vypadlá plomba", "nova_pacientka": "ne" },
    "domluveny_termin": null,
    "nalada": "Neutrální",
    "volane_cislo": "+420228123456",
    "ukonceni": "Volající",
    "prepis": [
      { "kdo": "recepční", "cas_sekund": 0, "text": "Dobrý den, ordinace doktora Nováka…" },
      { "kdo": "volající", "cas_sekund": 4, "text": "Dobrý den, vypadla mi plomba." }
    ],
    "odkaz": "https://app.hovoro.cz/call/detail/4821"
}}

• Odpověď: čekáme stav 2xx do 8 sekund.
• Opakování: když váš systém neodpoví nebo vrátí chybu, zkusíme to znovu za minutu, za deset minut a za hodinu. Poslední odeslání a jejich výsledek vidíte na stránce Napojení na váš systém.
• Ověření původu: hlavička X-Hovoro-Podpis má tvar sha256=… a obsahuje HMAC SHA-256 těla požadavku s vaším klíčem z administrace. Spočítejte si ho stejně a požadavky, kde nesedí, odmítněte.
• Zkouška: tlačítkem „Poslat zkušební data“ v administraci pošlete vymyšlený hovor. Pozná se podle "udalost": "hovor.zkouska".
• Prázdná pole: když volající zavěsí dřív, než řekne jméno, přijde jen telefon. Záznam v CRM proto hledejte podle telefonu, ne podle jména.
• Pole „udaje“ se liší podle toho, co jste nechali recepční zjišťovat.

Čtení dat přes API

Váš systém si hovory může stáhnout i sám. Prokazuje se klíčem z administrace v hlavičce Authorization: Bearer váš-klíč.

Pole jsou stejná jako v části „hovor“ u webhooku.

Dohledávání ve vašem systému během hovoru

Recepční se umí uprostřed hovoru podívat do vašeho systému a volajícímu rovnou odpovědět: v jakém stavu je objednávka, kdy bude hotová zakázka, jestli je zboží skladem. Když odpověď nenajde, nic si nevymýšlí a zapíše vzkaz jako obvykle.

Napojení stavíme na míru my a je určené pro placené tarify Provoz a Firma (ve zkušební verzi není). Potřebujeme od vás:

• přístup do systému nebo databáze jen pro čtení,
• popis, co se má dohledat a podle čeho (číslo objednávky, telefon, jméno),
• co smí recepční volajícímu říct a co ne.

Přístupové údaje ukládáme šifrovaně a používáme je jen k těmto dotazům. Co už recepční umí dohledat, vidíte na stránce Napojení na váš systém. Máte zájem? Napište nám.