Send file by URL

Sends a file from web to the selected chat room

Parameters

Function SendFileByURL(Val AccessParameters, Val ChatID, Val FileURL, 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
FileURL	--url	String	✔	File URL
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: SendFileByUrl

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";
    FileName    = "photo.jpg";
    ChatID      = "120363410406221140@g.us";
    Description = "File description";

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

Bash

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

CMD/Bat

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

Result

{
 "idMessage": "3EB0D55ADCC6DCF03680F7"
}