Messages overview
Every message route sits under the number: /v1/numbers/{ref}/messages. To choose the number and understand its lifecycle, see the numbers overview. You follow the result of a send through the message status or through events, both described below.
| You want to | Page |
|---|---|
| Send text, with mentions, rich content and groups | Sending messages |
| Send an image, video, audio or document | Sending media |
Look up
Section titled “Look up”| You want to | Page |
|---|---|
| List the messages of a number, newest first | List messages |
| Get the content, status and media reference of a message | Get a message |
| Follow the progress and failures of a send | Message status |
| See the history of delivery transitions | Receipt history |
| List the reactions on a message | Get reactions |
| See each guest’s answer to a calendar event | Get event responses |
Change a sent message
Section titled “Change a sent message”Edit and delete messages: edit the text, the caption of a media message or a calendar event, or delete for everyone.
Receive what happens
Section titled “Receive what happens”| You want to | Page |
|---|---|
| Receive events on your server | Events via webhook |
| Look up events through the API, instead of the webhook or alongside it | Event polling |
Retention, limits and quotas
Section titled “Retention, limits and quotas”- Message retention: how long the content stays available.
- Rate limits: the pace of sending, contact updates and pairing per plan.
- Quota and usage: the message and contact quotas per cycle.