Webhook Payload Media Types
Connectly webhooks support 4 media types that correspond to certain MIME types:
Type | Description | Supported MIME types |
---|---|---|
image | images in .jpeg, .png format | - image/jpeg - image/png |
video (Coming soon!) | video files | - video/mp4 - video/3gpp |
audio | audio files and audio recordings | - audio/aac - audio/mp4 - audio/mpeg - audio/amr - audio/ogg - audio/ogg; codecs=opus |
document | work documents, text files and all other file types that are not listed in the previous 3 categories | Most common MIMEs: - text/plain - application/pdf - application/vnd.ms-powerpoint - application/msword - application/vnd.ms-excel - application/vnd.openxmlformats-officedocument.wordprocessingml.document - application/vnd.openxmlformats-officedocument.presentationml.presentation - application/vnd.openxmlformats-officedocument.spreadsheetml.sheet - application/vnd.android.package-archive |
The media webhook payload has the following format:
{
"timestamp": "1640204070",
"sender": {
"id": "+16044441111",
"channelType": "whatsapp"
},
"recipient": {
"id": "16042221111",
"channelType": "whatsapp"
},
"message": {
"attachments": [
{
"type": "audio",
"url": "https://cdn.connectly.ai/46b6/46b6725c-a821-480c-901b-8a76b990a25c"
}
]
}
}
The media payload is stored under attachments
.
Connectly supports sending multiple attachments in one webhook event but currently, only ONE attachment is sent at a time.
The type
indicates the media type and the media file is accessible by visiting the url
. If you download the media file from the URL programmatically then you should get the MIME type from the response headers.