AI Chatbots

Sarunas ziņu saņemšanai

Metode, kas atgriež sarunas ziņas.

Pieprasījums:

• Metode: GET
• URL: https://va.tilde.com/dl/directline/aHR0cDovL3Byb2RrOHNib3RsZWxkZTE=/conversations/51d1fd66-848a-421e-b24e-3c86dde21673/activities?watermark=4
• Pieprasījuma parametri:
  • watermark (neobligāts): norāda ūdenszīmi, līdz kurai jau ir saņemtas aktivitātes.

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), ziņu masīvs

Piemērs:

{
  "activities": [
    {
      "name": "webchat/join",
      "type": "event",
      "value": {
        "locale": "lv-lv"
      },
      "host": "https://va.tilde.com",
      "channelData": {
        "clientActivityID": "1702035851711pgu4yyp9s3g",
        "clientTimestamp": "2023-12-08T11:44:11.712Z"
      },
      "channelId": "directline",
      "from": {
        "id": "r_1702035850",
        "name": "",
        "role": "user"
      },
      "locale": "lv-lv",
      "timestamp": "2023-12-08T11:44:11Z",
      "entities": [
        {
          "requiresBotState": true,
          "supportsListening": true,
          "supportsTts": true,
          "type": "ClientCapabilities"
        }
      ],
      "serviceUrl": "https://va.tilde.com/dl/",
      "conversation": {
        "id": "a15e64ac-8f70-4ce0-ab04-2d473870bd8d"
      },
      "id": "954a2ec6-2c94-4566-bc72-fe2293cc55f7"
    },
    {
      "type": "typing",
      "timestamp": "2023-12-08T11:44:11Z",
      "serviceUrl": "https://va.tilde.com/dl/",
      "channelId": "directline",
      "conversation": {
        "id": "a15e64ac-8f70-4ce0-ab04-2d473870bd8d"
      },
      "recipient": {
        "id": "r_1702035850",
        "name": "",
        "role": "user"
      },
      "locale": "lv-lv",
      "text": "",
      "attachments": [],
      "entities": [],
      "replyToId": "954a2ec6-2c94-4566-bc72-fe2293cc55f7",
      "id": "2d0b7fda-7e2d-49d3-aeca-792b2410a296",
      "from": {
        "id": "id",
        "name": "Bot"
      }
    },
    {
      "type": "message",
      "timestamp": "2023-12-08T11:44:11Z",
      "serviceUrl": "https://va.tilde.com/dl/",
      "channelId": "directline",
      "conversation": {
        "id": "a15e64ac-8f70-4ce0-ab04-2d473870bd8d"
      },
      "recipient": {
        "id": "r_1702035850",
        "name": ""
        ...
      }
    }
  ]
}

watermark: norāda ūdenszīmi, līdz kurai jau ir atgrieztas aktivitātes, nākamās ziņas var sākt prasīt no šīs ūdenszīmes.

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.