Webhook Payload Media Types

Connectly webhooks support 4 media types that correspond to certain MIME types:

TypeDescriptionSupported MIME types
imageimages in .jpeg, .png format- image/jpeg
- image/png
video (Coming soon!)video files- video/mp4
- video/3gpp
audioaudio files and audio recordings- audio/aac
- audio/mp4
- audio/mpeg
- audio/amr
- audio/ogg
- audio/ogg; codecs=opus
documentwork documents, text files and all other file types that are not listed in the previous 3 categoriesMost 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.