Send file

Sends the file to the selected chat room

Parameters

Function SendFile(Val AccessParameters, Val ChatID, Val File, Val FileName, Val Description = "", Val ReplyID = "") Export

Parameter	CLI option	Type	Required	Description
AccessParameters	--access	Structure Of KeyAndValue	✔	Access parameters. See FormAccessParameters
ChatID	--chat	String	✔	Chat identifier
File	--file	String, BinaryData	✔	File data or filepath
FileName	--filename	String	✔	Name of the file with the extension
Description	--caption	String	✖	Message text below the file
ReplyID	--quoted	String	✖	Replying message id if necessary

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: SendFileByUpload

Parameters with Binary data type can also accept file paths on disk and URLs

1C:Enterprise/OneScript code example

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

    File        = "https://hut.openintegrations.dev/test_data/picture.jpg"; // URL, Path or Binary data
    FileName    = "photo.jpg";
    ChatID      = "120363410406221140@g.us";
    Description = "File description";

    AccessParameters = OPI_GreenAPI.FormAccessParameters(ApiUrl, MediaUrl, IdInstance, ApiTokenInstance);
    Result           = OPI_GreenAPI.SendFile(AccessParameters, ChatID, File, FileName, Description);

Bash

    # JSON data can also be passed as a path to a .json file
    
    oint greenapi SendFile \
      --access "{'apiUrl':'***','mediaUrl':'https://7105.media.greenapi.com','idInstance':'7105187566','apiTokenInstance':'***'}" \
      --chat "***" \
      --file "https://hut.openintegrations.dev/test_data/video.mp4" \
      --filename "vid.mp4" \
      --caption "File description" \
      --quoted "3EB070D0D0DCD65A666F38"

CMD/Bat

    :: JSON data can also be passed as a path to a .json file
    
    oint greenapi SendFile ^
      --access "{'apiUrl':'***','mediaUrl':'https://7105.media.greenapi.com','idInstance':'7105187566','apiTokenInstance':'***'}" ^
      --chat "***" ^
      --file "https://hut.openintegrations.dev/test_data/video.mp4" ^
      --filename "vid.mp4" ^
      --caption "File description" ^
      --quoted "3EB070D0D0DCD65A666F38"

Result

{
 "idMessage": "3EB070D0D0DCD65A666F38",
 "urlFile": "https://do-mediaout-7105.fra1.digitaloceanspaces.com/7105187566/97d95105-713c-4c85-bd5a-221b4e4abca0..."
}