Chatboti (třetích stran)¶

Nastavte si propojení s chatbotem třetí strany, který se zákazníky komunikuje před spojením s operátorem (nebo místo něj). Pokud chcete bota postavit přímo v Daktele, použijte Rozhodovací stromy.

Propojení chatbotů je dostupné pro webchat, Facebook Messenger, Instagram DM, SMS, Viber a WhatsApp a nastavuje se pro každý kanál zvlášť.

Chatboty si nastavíte pod Spravovat → Směrování → váš kanál → Chatboti (např. Spravovat → Směrování → Web chaty → Chatboti). Zobrazí se přehled vašich chatbotů.

Chcete-li chatbota upravit, klikněte na jeho Název. Chcete-li vytvořit nového chatbota, klikněte na Přidat nový. Otevře se detail chatbota.

Warning

Když upravíte stávajícího nebo vytvoříte nového chatbota, klikněte na Uložit a po návratu na přehled chatbotů klikněte na tlačítko Aplikovat změny konfigurace v pravém horním rohu.

Tlačítko Aplikovat změny konfigurace v pravém horním rohu

U webchatů se změny na vašem webu projeví až po několika minutách. Pokud chcete nová nastavení vidět ihned, otevřete web v novém okně v anonymním režimu.

Detail chatbota¶

Nastavte svého chatbota ve sloupci Sandbox. Pokud upravujete již vytvořeného chatbota, můžete porovnat nová nastavení s těmi stávajícími ve sloupci In Production.

Název: zadejte název.

Popis: zadejte popis.

Záložní cíl: zvolte, kam bude konverzace směrována, pokud URL zpětného volání nebude dostupné.

URL zpětného volání: zadejte koncový bod, kam se budou posílat data z chatbota. Vyplní se automaticky – není potřeba měnit.

Adresa URL chatbota: zadejte URL adresu vašeho chatbota.

Odeslat úvodní zprávu: odešle klientovu inicializační zprávu (pokud existuje) jako součást prvního požadavku na chatbota.

Odeslat přílohy: odešle strukturu jakékoliv přílohy, kterou pošle klient.

Odeslat vlastní pole: zvolte vlastní vstupní pole, která se mají posílat do chatbota.

Struktura dat posílaná na chatbota¶

message = objekt zprávy
interaction = objekt interakce
? = pokud je prázdné, posílá se null

'?name' => '{{message.name}}',
'?time' => '{{message.time_created}}',
'?direction' => '{{message.direction}}',
'conversation.name' => '{{interaction.name}}',
'conversation.title' => '{{interaction.title}}',
'conversation.time' => '{{interaction.time}}',
'conversation.response_url' => '{{config.callback}}?hash={{interactionHash}}',
'text' => '{{text}}',
'attachments' => pole objektů, kde každý objekt má: 'title', 'type', 'size', 'link'
'quickreply.name' => hodnota z tlačítka, text tlačítka se neposílá
'conversation.customFields' => pole objektů, kde každý objekt má: 'title', 'name', 'value'
'referer' => {{interaction.options.referer}} (pouze webchat)

Příklad 1 – textová zpráva a seznam příloh:

POST chatbotURL
{
  "name": "messages_62fe1518a9820077126134",
  "time": "2022-08-18 12:31:52",
  "direction": "IN",
  "conversation": {
    "name": "web_62fe14acd567e380992326",
    "title": "",
    "time": "2022-08-18 12:30:04",
    "response_url": "https://XXX.daktela.com/external/web/api/chatbotUpdate?hash=b9f68fa377263e8f3018a405f25f44add10fab4c",
    "customFields": [
      {
        "name": "number",
        "title": "Number we want to know",
        "value": "22"
      },
      {
        "name": "...",
        "title": "....",
        "value": "...."
      }
    ]
  },
  "text": "xxx",
  "attachments": [
    {
      "link": "https://xxx.daktela.com/external/web/chat_file.php?accessToken=on87q29oq60q02nqo6nr3oo7s5r7r607&chat=web_62fe14acd567e380992326&mapper=chatsMessage&name=29",
      "title": "Name of screenshot.png",
      "type": "image/png",
      "size": "122221"
    },
    {
      "link": "...",
      "type": "....",
      "size": "...."
    }
  ],
  "referer": "https://xxx.com/demo/chat.html"
}

Příklad 2 – stisknuté tlačítko rychlé odpovědi:

POST chatbotURL
{
  "name": "messages_62fe1518a9820077126134",
  "time": "2022-08-18 12:31:52",
  "direction": "IN",
  "conversation": {
    "name": "web_62fe14acd567e380992326",
    "title": "",
    "time": "2022-08-18 12:30:04",
    "response_url": "https://XXX.daktela.com/external/web/api/chatbotUpdate?hash=b9f68fa377263e8f3018a405f25f44add10fab4c",
    "customFields": []
  },
  "quickreply": {
    "name": "quickReplyName1"
  },
  "referer": "https://xxx.com/demo/chat.html"
}

Struktura dat, kterou očekáváme¶

'conversation.name' – jméno interakce
'hash' – identifikuje konverzaci, ke které se příchozí zpráva vztahuje
'text' – příchozí zpráva
'transfer' – name fronty, na kterou by se měla konverzace přepojit
'quickreply' – pole objektů, které mají atributy 'text' a 'value' – odpovídá 'suggestedAnswers' v naší aplikaci
'button' – pole objektů, které mají atributy 'text' a 'url' – <a href class=button> tlačítko poslané ve zprávě

Příklad odpovědi:

POST https://XXX.daktela.com/external/web/api/chatbotUpdate
{
  "conversation": {
    "name": "web_62fe14acd567e380992326"
  },
  "text": "textMessage",
  "button": [
    {
      "text": "xxx.com",
      "url": "https://xxx.com/api/"
    },
    {
      "text": "...",
      "url": "...."
    }
  ],
  "quickreply": [
    {
      "name": "quickReplyName1",
      "text": "Quick reply Name 1"
    },
    {
      "name": "....",
      "text": "...."
    }
  ],
  "queue": "10001",
  "hash": "b9f68fa377263e8f3018a405f25f44add10fab4c"
}