ChatsTyping Indicators

Typing Indicators

Send typing indicators to show the recipient that you’re composing a message.

Send a Typing Indicator

curl -X POST https://api.textbubbles.com/v1/chats/CHAT_ID/typing \
  -H "Authorization: Bearer YOUR_API_KEY"

This displays the familiar ”…” typing bubble in the recipient’s Messages app.

Receiving Typing Indicators

Subscribe to the typing.indicator webhook event to detect when contacts are typing:

curl -X PUT https://api.textbubbles.com/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhooks/textbubbles",
    "events": ["typing.indicator"]
  }'

Webhook payload:

{
  "id": "evt_abc123",
  "type": "typing.indicator",
  "timestamp": "2026-03-28T10:00:00.000Z",
  "data": {
    "chatId": "chat_xyz",
    "from": "+14155551234",
    "active": true
  }
}

Notes

  • Typing indicators are iMessage only
  • The indicator automatically expires after a few seconds
  • Useful for building conversational AI flows where you want to simulate natural response timing
Group ChatsContacts