Send File Message

In this page we show you how to send a message containing a pdf file.

A file-type conversation refers to a message that includes a file attachment.

In this table below you'll see the Arguments for this request.

Arguments	Explanation
mediaURL *required	Provides the URL where the file content is hosted or located
type *required	To specify the media type that will be used.
altText (optional)	A description of the image that's optional, provided mainly for accessibility reasons. By default, it'll be saved using the image file's name.

Here's how to create a request for sending a file message to a WhatsApp user using the provided API endpoint.

JSON

{
    "type": "file",
    "mediaUrl": "https://www.w3.org/dummy.pdf",
    "altText": "Here is a pdf attached"
}

cURL

curl --location 'channel360.co.za/v1.1/org/{{orgId}}/whatsapp/appuser/{{appUserId}}/reply' \
--data '{
    "type": "file",
    "mediaUrl": "https://www.w3.org/dummy.pdf",
    "altText": "Here is a pdf attached"
}'

The provided YAML configuration below defines an API specification using the OpenAPI (formerly known as Swagger) format.

Send file request

API request to send a file

POSThttps://www.channel360.co.za/v1.1/org/{orgId}/whatsapp/appuser/{appUser}/reply

Path parameters

orgId*string

appUser*string

Body

application/json

type*enum

Example: "file"

fileimagetext

mediaUrl*string

Example: "https://www.w3.org/dummy.pdf"

altText*string

Example: "Here is a pdf attached"

Response

200

Successfully Replied.

Body

application/json

conversationobject

messageobject

Request

JavaScriptCurlPython

const response = await fetch('https://www.channel360.co.za/v1.1/org/{orgId}/whatsapp/appuser/{appUser}/reply', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "altText": "Here is a pdf attached",
      "mediaUrl": "https://www.w3.org/dummy.pdf",
      "type": "file"
    }),
});
const data = await response.json();

Response

200

{
  "conversation": {
    "_id": "5x3v39263cnmvb9537548416",
    "appMakerLastRead": 1714391363,
    "appUserLastRead": 1714390358.894,
    "unreadCount": 2
  },
  "message": {
    "_id": "edf85dfg2h82d5f2d93s",
    "role": "appMaker",
    "authorId": "2wm6nj7i8d09fg8h45c7",
    "type": "file",
    "avatarUrl": "https://www.gravatar.com/avatar/00000000000000000000000000000000.png?s=200&d=mm",
    "mediaUrl": "https://www.w3.org/dummy.pdf",
    "mediaSize": 15658,
    "altText": "Here is a pdf attached",
    "received": 1714391363,
    "mediaType": "application/pdf",
    "source": {
      "type": "api"
    }
  }
}