Show a typing indicator in a 1:1 WhatsApp conversation

Shows the "typing…" indicator to a customer in a 1:1 WhatsApp chat, as you would while composing a reply.

Before you call

  • Send wabaNumber (your connected WhatsApp number) and customerNumber (the customer's phone number). Both are required.
  • A chat must already exist between that number and that customer, and the customer must have messaged you.

How it works

  • The indicator is attached to the customer's most recent incoming message, which is also marked as read.
  • WhatsApp expires the indicator automatically after about 25 seconds, or as soon as you send a message. Send this again to keep it visible for longer.
  • The request returns as soon as it is accepted. The call to WhatsApp happens in the background, so success: true does not confirm the customer saw it.
  • Returns success: false if the customer has never messaged you, or if the number is also used on the WhatsApp Business app.
  • Returns 404 if the WhatsApp number, customer or chat is not found.

Rate limit

  • 60 requests per minute.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

WABA number the conversation belongs to

string
required

The customer's WhatsApp number in E.164 format. Example: +15551230000

Responses

success is false when the conversation has no inbound customer message to attach the indicator to, when the integration's provider does not support typing indicators, or for a WhatsApp Business app (Coex) number.

400

Missing or non-string wabaNumber or customerNumber

401

Missing or invalid API key, or insufficient permissions to write to this chat

404

No connected integration, customer, or chat found for the given wabaNumber and customerNumber

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json