User Events

Receive events related to user interactions such as when a user starts typing via webhook. See our [guide](/guides/messages/receiving) for handling user and message events with SDKs. > **Note:** Typing indicators are best-effort hints. RBM may coalesce, drop, or skip indicators, and you may not receive an indicator for every keystroke or session. Events can be missed if messages arrive before typing events are processed.

Headers

PINNACLE-SIGNING-SECRETstringRequired
Secret for verifying the authenticity of the request. Starts with `pss-` and is unique for each webhook. Find it at [webhooks](https://app.pinnacle.sh/dashboard/development/webhooks).

Payload

The payload of this webhook request is an object.
typeenumRequired
Type of user event.
Allowed values:
startedAtstringRequired
Timestamp when the user event started in ISO 8601 format.
conversationobjectRequired
Conversation metadata containing the conversation ID, sender, and recipient information.

Response

200
any
Return a 200 status to indicate that the data was received successfully.