Skip to main content
POST
Send Typing Indicator
Show “typing…” in the customer’s WhatsApp chat while your code prepares a reply, for example while it looks up an order or waits on an AI model. WhatsApp attaches the indicator to one message the customer sent: that message is marked as read (blue ticks), and “typing…” shows until you send your reply or about 25 seconds pass, whichever comes first. Nothing is stored in the chat.

Basic Usage

Without a message_id, FlowIQ uses the customer’s latest WhatsApp message. To answer a specific message, pass its id (the whatsapp_message_id of the message_received webhook):

Request Body

The API key needs the send permission.

Response

Success (200)

Errors


Integration Example

Show the indicator as soon as a message arrives, then send the reply when it is ready:
The indicator also marks the customer’s message as read. Only send it when you are about to reply.

Authorizations

Authorization
string
header
required

Your FlowIQ API key (from Settings → Profile → API Keys), sent as a bearer token. Format: Bearer fiq_YOUR_API_KEY

Body

application/json
phone_number
string
required

The customer's WhatsApp number with country code. The contact must exist in FlowIQ.

Example:

"+27123456789"

message_type
enum<string>
required

Must be "typing"

Available options:
typing
Example:

"typing"

typing
object

Optional.

Response

Typing indicator shown

success
boolean
Example:

true

message
string
Example:

"Typing indicator shown to 27123456789 for up to 25 seconds or until you reply"

data
object