Typing Indicators

Typing indicators show recipients that someone is actively composing a message. They create a more natural, real-time feel in conversations.

Sending typing indicators

Start a typing indicator in a chat to show the recipient that you’re composing a message:

# Start typing
curl -X POST https://api.linqapp.com/api/partner/v3/chats/{chat_id}/typing \
  -H "Authorization: Bearer $LINQ_API_KEY"

# Stop typing
curl -X DELETE https://api.linqapp.com/api/partner/v3/chats/{chat_id}/typing \
  -H "Authorization: Bearer $LINQ_API_KEY"

// Start typing
await client.chats.typing.start(chatId);

// Stop typing
await client.chats.typing.stop(chatId);

# Start typing
client.chats.typing.start(chat_id)

# Stop typing
client.chats.typing.stop(chat_id)

Tip: Send a typing indicator before your application processes a response (e.g., while an AI agent generates a reply). This gives the recipient a natural “someone is typing” experience. The indicator automatically clears when you send the actual message.

Receiving typing indicators

Subscribe to typing indicator webhooks to know when a recipient is typing:

Event	Description
chat.typing_indicator.started	A participant started typing
chat.typing_indicator.stopped	A participant stopped typing

See Webhooks for setup instructions and the Webhook Events API Reference for payload schemas.

Important notes

• iMessage only — Typing indicators are an iMessage feature and are not available on RCS or SMS. See Protocol Selection for protocol capabilities.
• One-to-one chats only — Typing indicators are not supported in group chats. They only work in one-to-one conversations.
• Auto-clear — Typing indicators automatically clear when you send a message to the chat.
• Timeout — Typing indicators expire after approximately 60 seconds if not refreshed or stopped.

See the Chats API Reference for the full typing indicator endpoint specification.