Typing Indicators resource
Public Beta
Typing indicators for WhatsApp on Twilio are currently available as a Public Beta product and the information contained in this document is subject to change. This means that some features aren't yet implemented and others may be changed before the product is declared as Generally Available. Public Beta products aren't covered by the Twilio Support Terms or Twilio Service Level Agreement.
Typing indicators for WhatsApp aren't HIPAA-eligible or PCI-compliant and shouldn't be enabled in workflows that are subject to HIPAA or PCI.
Typing indicators signal to WhatsApp users that a response is being prepared. This improves user experience by reducing perceived wait times. Use typing indicators for responses that might take longer than a few seconds to generate.
To send a WhatsApp typing indicator, reference the ID of the message that you're preparing a response for. When you send the typing indicator, Twilio automatically marks the referenced message as read for the user in their WhatsApp client and displays the typing indicator on the user's device.
The typing indicator on WhatsApp will disappear when your response is delivered or after 25 seconds, whichever happens first.
| Request body parameter | Required | Description |
|---|---|---|
messageId | Yes | The SID of the message that you're preparing a response for. Must be a valid Twilio Message SID (starting with SM) or Media SID (starting with MM) from an existing WhatsApp conversation. |
channel | Yes | The channel to send the typing indicator on. Must be whatsapp. |
1curl -X POST https://messaging.twilio.com/v2/Indicators/Typing.json \2-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN \3--data-urlencode "messageId=SMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \4--data-urlencode "channel=whatsapp"
1{2"success": true3}