AI Chatbots

Notikuma nosūtīšanas API

Šī metode botam nosūta informāciju par to, ka saruna ir sākusies un padod parametrus, ko tālāk izmantot sarunā.

Pieprasījums:

• Metode: POST

• URL: https://va.tilde.com/dl/directline/aHR0cDovL3Byb2RrOHNib3RsZWxkZTE=/conversations/e30760de-0595-4b04-89fe-58f117f08793/activities

• Pieprasījuma pamatteksts:

  {
    "name": "webchat/join",
    "type": "event",
    "value": {
      "locale": "lv-lv"
    },
    "host": "[https://va.tilde.com](https://va.tilde.com)",
    "channelId": "webchat",
    "from": {
      "id": "{{username}}",
      "name": "{{username}}",
      "role": "user"
    },
    "locale": "lv-lv",
    "timestamp": "2022-10-13T14:10:38.744Z"
  }

  , kur

Parametrs	Apraksts	Vērtība
name	Notikuma nosaukums	webchat/join – norāda botam, ka saruna sākusies, bots saglabā key/value konteksta vērtības, kas definētas ‘value’ parametrā, uzsāk sarunu un nosūta starta ziņu, kāda ir definēta scenārijā webchat/context – nodod botam jaunas key/value konteksta vērtības, kas definētas ‘value parametrā’, bots vērtības saglabā kontekstā tālākai izmantošanai scenārijā
type	Notikums	event
value	Key/value mainīgo vērtības	Vērtības, ko padot botam izmantošanai dialogā locale: sarunas valoda (lv-lv latviešu valodai) host: domēns, kurā norit saruna
channelId	Kanāls, kas tiek izmantots sarunu filtrā	WhatsApp
from	Informācija, kas identificē lietotāju	id: unikāls lietotāja ID name: lietotāja vārds role: user (loma lietotājs)
locale	Sarunas valoda	lv-lv
timestamp	Laika zīmogs, kad tiek nosūtīts notikums

Pieprasījuma URL satur bota ID (aHR0cDovL3Byb2RrOHNib3RsZWxkZTE=), kas identificē botu Saldējums un sarunas ID (e30760de-0595-4b04-89fe-58f117f08793), kas identificē konkrēto sarunu.

Veiksmīga izsaukuma atbilde:

• Statuss: 200 OK
• Atbilde (JSON), nosūtītās ziņas identifikators: {"id":"01ec79c6-ae3b-47df-b0ea-ca1bc236bf8b"}

Lasīt vairāk

Tildes boti izmanto API, kas balstīts uz Microsoft Bot Framework specifikāciju. Lai iegūtu detalizētu informāciju par API darbību un iespējamajiem pieprasījumiem un atbildēm, skatiet Microsoft Bot Framework Activity API specifikāciju.