scuba

Author: tcaldwell-x

x-api/activity/introduction.mdx

@@ -84,6 +84,8 @@ Chat events pertain to the new, encrypted messaging stack, or XChat.
 | --- | --- | --- |
 | `chat.received` | Fired when a user receives an encrypted direct message | `user_id` |
 | `chat.sent` | Fired when a user sends an encrypted direct message | `user_id` |
+| `chat.conversation_join` | Fired when a user joins an encrypted chat conversation | `user_id` |
+
 
 ### News Events
 

x-api/webhooks/introduction.mdx

@@ -34,7 +34,8 @@ These are the products that currently support delivering events via webhook:
 
 | Product | Description |
 |:--------|:------------|
-| [Account Activity API (AAA)](/x-api/account-activity/introduction) | Receive real-time account activity events (posts, DMs, follows, likes, etc.) |
+| [X Activity API (XAA)](/x-api/activity/introduction) | Receive real-time events for activity happening on X (open beta) |
+| [Account Activity API (AAA)](/x-api/account-activity/introduction) | Receive real-time events tied to specific user accounts |
 | [Filtered Stream Webhooks](/x-api/webhooks/stream/introduction) | Receive filtered stream Posts via webhook delivery |
 
 ---
@@ -93,6 +94,31 @@ X's webhook-based APIs provide two methods for confirming the security of your w
 
 ---
 
+## Webhook validation
+
+A CRC check is sent to your webhook in the following cases:
+
+- Immediately upon creation
+- On an explicit PUT request (`PUT /2/webhooks/{id}`)
+- Periodically every 30 minutes, but only if the webhook has not been successfully validated in the past 24 hours
+
+A webhook is marked as **invalid** when:
+
+- It returns an invalid response to a CRC check
+  - Returns a 2XX status code but the `response_token` is incorrect
+  - Returns a 3XX status code
+  - Results in an SSL exception
+- It experiences persistent transient errors such that it has not successfully validated for more than 28 hours (includes a 4-hour grace period for transient issues)
+  - The following responses are treated as transient errors:
+    - 4XX status code
+    - 5XX status code
+    - Request timeout
+    - Channel closed
+
+You can check the valid/invalid status of a webhook using the `GET /2/webhooks` endpoint or via the toolbox in the Developer Console.
+
+---
+
 ## Getting started
 
 <Note>