Typing Indicators

Show a Typing Indicator

Call the typing endpoint with the inbound message ID you want to acknowledge:

await zavu.messages.showTyping("msg_abc123");

zavu.messages.show_typing("msg_abc123")

client.messages.show_typing("msg_abc123")

curl -X POST https://api.zavu.dev/v1/messages/msg_abc123/typing \
  -H "Authorization: Bearer zv_live_xxx"

The indicator is automatically dismissed when:

You send a reply, OR

25 seconds elapse — whichever comes first.

When to Use

Show the indicator only when a response really is on the way. The typical pattern is to call it as the first thing your webhook handler does for an inbound message that will trigger slow work:

// In your webhook handler for `message.inbound`
await zavu.messages.showTyping(event.data.messageId);

const reply = await yourLLM.generate(event.data.text);

await zavu.messages.send({
  to: event.data.from,
  channel: "whatsapp",
  text: reply,
});

This is especially valuable for AI Agents — without it, the user sees nothing happen for several seconds after they send their message.

Specifications

Property	Requirement
Message channel	Must be `whatsapp`
Message direction	Must be `inbound`
Provider message ID	Must be present (set automatically on received messages)

Do not call this endpoint speculatively — only when you are about to respond. Showing typing dots without ever replying degrades trust.

The 24-hour conversation window applies. Typing indicators on messages outside that window will fail.

Getting Started

Build agents

Send & receive

Operate

Developer tools

Integrations

Typing Indicators

Show a Typing Indicator

When to Use

Specifications

​Show a Typing Indicator

​When to Use

​Specifications

​Related

Show a Typing Indicator

When to Use

Specifications

Related