Get chat history

Retrieves the chat message history

Parameters

Function GetChatHistory(Val AccessParameters, Val ChatID, Val Count = 100) Export

Parameter	CLI option	Type	Required	Description
AccessParameters	--access	Structure Of KeyAndValue	✔	Access parameters. See FormAccessParameters
ChatID	--chat	String	✔	Chat identifier
Count	--count	Number	✖	Number of messages to receive

Returns

Map Of KeyAndValue - serialized JSON response from Green API

Advanced call ?

Parameter	Description
proxy	InternetProxy or a structure with fields Protocol, Host, Port, User, Password, UseOSAuthentication
timeout	Request execution timeout
adv_response	Formats the response as a complete HTTP structure with fields code, body, and headers
retries	Number of HTTP request send attempts on 5** status codes or internal client errors
dontwait	Creates a background job and returns its data (for 1C and OneScript only)

tip

Method at API documentation: GetChatHistory

1C:Enterprise/OneScript code example

    ApiUrl           = "https://7105.api.greenapi.com";
    MediaUrl         = "https://7105.media.greenapi.com";
    IdInstance       = "71051...";
    ApiTokenInstance = "425010d90e114aa6b78f0969e...";

    ChatID = "120363410406221140@g.us";

    AccessParameters = OPI_GreenAPI.FormAccessParameters(ApiUrl, MediaUrl, IdInstance, ApiTokenInstance);
    Result           = OPI_GreenAPI.GetChatHistory(AccessParameters, ChatID);

Bash

    # JSON data can also be passed as a path to a .json file
    
    oint greenapi GetChatHistory \
      --access "{'apiUrl':'***','mediaUrl':'https://7105.media.greenapi.com','idInstance':'7105187566','apiTokenInstance':'***'}" \
      --chat "***"

CMD/Bat

    :: JSON data can also be passed as a path to a .json file
    
    oint greenapi GetChatHistory ^
      --access "{'apiUrl':'***','mediaUrl':'https://7105.media.greenapi.com','idInstance':'7105187566','apiTokenInstance':'***'}" ^
      --chat "***"

Result

[
 {
  "type": "outgoing",
  "idMessage": "3EB08D9B2DD354640CE2D5",
  "timestamp": 1779805977,
  "typeMessage": "deletedMessage",
  "chatId": "***",
  "deletedMessageData": {
   "stanzaId": "3EB01108AB4DCCC1772556"
  },
  "statusMessage": "sent",
  "sendByApi": "***"
 },
 {
  "type": "outgoing",
  "idMessage": "3EB04F9417509032C93ABE",
  "timestamp": 1779805977,
  "typeMessage": "extendedTextMessage",
  "chatId": "***",
  "textMessage": "New message",
  "extendedTextMessage": {
   "text": "New message",
   "description": "",
   "title": "",
   "previewType": "None",
   "jpegThumbnail": "",
   "forwardingScore": 1,
   "isForwarded": true
  },
  "statusMessage": "sent",
  "sendByApi": "***",
  "deletedMessageId": "",
  "editedMessageId": "",
  "isEdited": false,
  "isDeleted": false
 },
 {
  "type": "outgoing",
  "idMessage": "3EB0337008C26C0CFC18C6",
  "timestamp": 1779805976,
  "typeMessage": "contactMessage",
  "chatId": "***",
  "contact": {
   "displayName": "Bicycle",
   "vcard": "BEGIN:VCARD\nVERSION:3.0\nN:;;;\nFN:Bicycle\nORG:Bicycle\nTEL;type=CELL;type=VOICE;waid=79001234568:+7900...",
   "forwardingScore": 0,
   "isForwarded": false
  },
  "quotedMessage": {
   "stanzaId": "3EB0D9A2316CD6BD955436",
   "participant": "1234567890@c.us",
   "typeMessage": "contactMessage",
   "contact": {
    "displayName": "Artem Evpatoriysky Petrovich",
    "vcard": "BEGIN:VCARD\nVERSION:3.0\nN:Petrovich;Artem;Evpatoriysky;\nFN:Artem Evpatoriysky Petrovich\nORG:Bicycle\n...",
    "forwardingScore": 0,
    "isForwarded": false
   },
   "deletedMessageId": "",
   "editedMessageId": "",
   "isEdited": false,
   "isDeleted": false
  },
  "statusMessage": "sent",
  "sendByApi": "***",
  "deletedMessageId": "",
  "editedMessageId": "",
  "isEdited": false,
  "isDeleted": false
 },
 {
  "type": "outgoing",
  "idMessage": "3EB0D9A2316CD6BD955436",
  "timestamp": 1779805975,
  "typeMessage": "contactMessage",
  "chatId": "***",
  "contact": {
   "displayName": "Artem Evpatoriysky Petrovich",
   "vcard": "BEGIN:VCARD\nVERSION:3.0\nN:Petrovich;Artem;Evpatoriysky;\nFN:Artem Evpatoriysky Petrovich\nORG:Bicycle\n...",
   "forwardingScore": 0,
   "isForwarded": false
  },
  "statusMessage": "sent",
  "sendByApi": "***",
  "deletedMessageId": "",
  "editedMessageId": "",
  "isEdited": false,
  "isDeleted": false
 },
 {
  "type": "outgoing",
  "idMessage": "3EB06E2D6DA5AB79766C71",
  "timestamp": 1779805974,
  "typeMessage": "locationMessage",
  "chatId": "***",
  "location": {
   "nameLocation": "",
   "address": "",
   "jpegThumbnail": "",
   "latitude": 53.908522,
   "longitude": 27.574821,
   "forwardingScore": 0,
   "isForwarded": false
  },
  "quotedMessage": {
   "stanzaId": "3EB0A859DEFDBACCCA8F3D",
   "participant": "1234567890@c.us",
   "typeMessage": "locationMessage",
   "location": {
    "nameLocation": "Victory Square, Minsk",
    "address": "Victory sq.",
    "jpegThumbnail": "",
    "latitude": 53.908522,
    "longitude": 27.574821,
    "forwardingScore": 0,
    "isForwarded": false
   },
   "deletedMessageId": "",
   "editedMessageId": "",
   "isEdited": false,
   "isDeleted": false
  },
  "statusMessage": "sent",
  "sendByApi": "***",
  "deletedMessageId": "",
  "editedMessageId": "",
  "isEdited": false,
  "isDeleted": false
 },
 {
  "type": "outgoing",
  "idMessage": "3EB0A859DEFDBACCCA8F3D",
  "timestamp": 1779805973,
  "typeMessage": "locationMessage",
  "chatId": "***",
  "location": {
   "nameLocation": "Victory Square, Minsk",
   "address": "Victory sq.",
   "jpegThumbnail": "",
   "latitude": 53.908522,
   "longitude": 27.574821,
   "forwardingScore": 0,
   "isForwarded": false
  },
  "statusMessage": "sent",
  "sendByApi": "***",
  "deletedMessageId": "",
  "editedMessageId": "",
  "isEdited": false,
  "isDeleted": false
...