Browse guides

Messaging

Every WhatsApp message type the Cloud API can send: text, images, video, audio, documents, stickers, locations, contacts, buttons, lists, reactions and replies.

16 pages

  1. The 24-Hour Customer Service WindowThe 24-hour customer service window in the WhatsApp Cloud API — how the rolling timer works, what you can send inside vs outside it, and how to reopen it.
  2. Sending Your First MessageHow to send the first test message using the pre-approved hello_world template on the WhatsApp Cloud API.
  3. Sending Text MessagesHow to send a plain text message on the WhatsApp Cloud API, with or without URL preview.
  4. Image MessagesHow to send an image message on the WhatsApp Cloud API, including supported formats, file size limits, captions, and whether to use a URL or media ID.
  5. Video MessagesHow to send a video message on the WhatsApp Cloud API, including supported formats, file size limits, and captions.
  6. Audio MessagesHow to send an audio message or voice note on the WhatsApp Cloud API, including supported formats and size limits.
  7. Document MessagesHow to send a document (PDF, Word, Excel, PowerPoint, or text file) on the WhatsApp Cloud API using a URL or media ID, including the filename and caption fields.
  8. Sticker MessagesHow to send a sticker message on the WhatsApp Cloud API, including the WebP format requirement and size limits for static and animated stickers.
  9. Location MessagesHow to send a location message on the WhatsApp Cloud API using latitude, longitude, name, and address fields.
  10. Contact MessagesHow to send a contact card message on the WhatsApp Cloud API, sharing a person's name, phone number, email, and other vCard details.
  11. Reply Buttons (Quick Replies)How to send an interactive message with up to 3 tappable reply buttons (quick replies) on the WhatsApp Cloud API.
  12. List MessagesHow to send an interactive list message on the WhatsApp Cloud API — a menu with sections and up to 10 selectable rows.
  13. CTA URL ButtonsHow to send an interactive CTA (Call-to-Action) URL button message on the WhatsApp Cloud API — a button that opens a website when tapped.
  14. ReactionsHow to send a reaction (emoji) to a specific WhatsApp message using the WhatsApp Cloud API, and how to remove a reaction.
  15. Replies (Quoting)How to send a reply that quotes a specific previous WhatsApp message using the context field with a message_id.
  16. Media API (Upload, Retrieve, Delete)How to upload, retrieve, and delete media files with the WhatsApp Cloud API Media endpoint — get a media ID, download received media, and delete old media.