> ## Documentation Index > Fetch the complete documentation index at: https://docs.x.com/llms.txt > Use this file to discover all available pages before exploring further. # Exemplos de payloads de eventos da X Activity API > Exemplos de payloads JSON para eventos da X Activity API: Posts, curtidas, follows, atualizações de perfil, DMs, Spaces e revogações de OAuth. Os eventos entregues pela X Activity API (via [stream HTTP persistente](/x-api/activity/activity-stream) ou [webhooks](/x-api/webhooks/introduction)) compartilham um envelope comum: | Campo | Descrição | | ------------ | ------------------------------------------------------------------------ | | `event_uuid` | Identificador único para esta entrega de evento | | `filter` | O filtro que correspondeu (por exemplo, `user_id` ou `keyword`) | | `event_type` | O tipo de evento assinado | | `tag` | Tag opcional da sua assinatura (quando definida) | | `payload` | Dados específicos do evento | | `includes` | Objetos expandidos opcionais (usuários, tweets, etc.) quando disponíveis | ```json title="post.create" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "2080761390344937796", "filter": { "user_id": "1716450569358098432" }, "event_type": "post.create", "tag": "my post create", "payload": {}, "includes": {} } } ``` Os exemplos abaixo são payloads representativos do mundo real. A disponibilidade dos campos pode variar conforme as configurações da conta, as expansões e o estado do objeto no momento da entrega. Consulte a [introdução](/x-api/activity/introduction) para ver a lista completa dos tipos de evento suportados e os requisitos de autenticação. *** ## Eventos de Post ### `post.create` Disparado quando o usuário filtrado cria um Post. O `payload` é um objeto Post; `includes` pode conter usuários e tweets relacionados. ```json title="post.create" expandable lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "2080761390344937796", "filter": { "user_id": "1716450569358098432" }, "event_type": "post.create", "tag": "my post create", "payload": { "public_metrics": { "retweet_count": 0, "retweet_count_str": "0", "reply_count": 0, "reply_count_str": "0", "like_count": 0, "like_count_str": "0", "quote_count": 0, "quote_count_str": "0", "bookmark_count": 0, "bookmark_count_str": "0", "impression_count": 0, "impression_count_str": "0" }, "lang": "en", "created_at": "2026-07-24T21:05:48.000Z", "author_id": "1716450569358098432", "reply_settings": "everyone", "display_text_range": [ 0, 34 ], "paid_partnership": false, "id": "2080761390344937796", "possibly_sensitive": false, "edit_history_tweet_ids": [ "2080761390344937796" ], "conversation_id": "2080761390344937796", "text": "XAA docs payload sample 1784927148", "edit_controls": { "edits_remaining": 5, "edits_remaining_str": "5", "is_edit_eligible": true, "editable_until": "2026-07-24T22:05:48.000Z" } }, "includes": { "tweets": [ { "public_metrics": { "retweet_count": 0, "retweet_count_str": "0", "reply_count": 0, "reply_count_str": "0", "like_count": 0, "like_count_str": "0", "quote_count": 0, "quote_count_str": "0", "bookmark_count": 0, "bookmark_count_str": "0", "impression_count": 0, "impression_count_str": "0" }, "lang": "en", "created_at": "2026-07-24T21:05:48.000Z", "author_id": "1716450569358098432", "reply_settings": "everyone", "display_text_range": [ 0, 34 ], "paid_partnership": false, "id": "2080761390344937796", "possibly_sensitive": false, "edit_history_tweet_ids": [ "2080761390344937796" ], "conversation_id": "2080761390344937796", "text": "XAA docs payload sample 1784927148", "edit_controls": { "edits_remaining": 5, "edits_remaining_str": "5", "is_edit_eligible": true, "editable_until": "2026-07-24T22:05:48.000Z" } } ], "users": [ { "entities": { "url": { "urls": [ { "start": 0, "start_str": "0", "end": 23, "end_str": "23", "url": "https://t.co/OS6XL5y4m6", "expanded_url": "https://console.x.com", "display_url": "console.x.com" } ] }, "description": { "mentions": [ { "start": 29, "start_str": "29", "end": 36, "end_str": "36", "username": "google" }, { "start": 38, "start_str": "38", "end": 47, "end_str": "47", "username": "coinbase" }, { "start": 49, "start_str": "49", "end": 51, "end_str": "51", "username": "X" }, { "start": 52, "start_str": "52", "end": 64, "end_str": "64", "username": "XDevelopers" } ] } }, "name": "Taylor", "protected": false, "verified": true, "description": "X Developer Platform • prev. @google, @coinbase\n\n@X @XDevelopers", "is_identity_verified": true, "affiliation": { "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg", "url": "https://twitter.com/X", "user_id": [ "783214" ], "description": "X" }, "location": "Palo Alto, CA", "username": "taycaldwell", "verified_type": "blue", "pinned_tweet_id": "1968451310203859083", "created_at": "2023-10-23T13:44:53.000Z", "id": "1716450569358098432", "profile_image_url": "https://pbs.twimg.com/profile_images/2035547159203139584/BKh7KcEt_normal.jpg", "url": "https://t.co/OS6XL5y4m6", "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1779411426", "most_recent_tweet_id": "2080761390344937796", "public_metrics": { "followers_count": 5502, "followers_count_str": "5502", "following_count": 652, "following_count_str": "652", "tweet_count": 790, "tweet_count_str": "790", "listed_count": 47, "listed_count_str": "47", "like_count": 8011, "like_count_str": "8011", "media_count": 79, "media_count_str": "79" }, "profile_geo_enrichment": { "potential_locations": [ { "geo_entity": { "entity_id": "5380748", "display_name": "Palo Alto, California, United States", "country_code": "US", "region": "California", "sub_region": "Santa Clara County", "locality": "Palo Alto", "population": 64403, "population_str": "64403", "geo_point": { "latitude": 37.44188, "longitude": -122.14302 } } } ] } } ] } } } ``` ### `post.delete` Disparado quando o usuário filtrado exclui um Post. O `payload` contém o ID do Post excluído e o ID do autor. ```json title="post.delete" expandable lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "-2781149976877970683", "filter": { "user_id": "1716450569358098432" }, "event_type": "post.delete", "tag": "my post deletes", "payload": { "id": "2080761269309813134", "author_id": "1716450569358098432" }, "includes": { "users": [ { "data": { "profile_image_url": "https://pbs.twimg.com/profile_images/2035547159203139584/BKh7KcEt_normal.jpg", "affiliation": { "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg", "url": "https://twitter.com/X", "description": "X" }, "protected": false, "id": "1716450569358098432", "username": "taycaldwell", "verified_type": "blue", "verified": true, "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1779411426", "entities": { "url": { "urls": [ { "start": 0, "start_str": "0", "end": 23, "end_str": "23", "url": "https://t.co/OS6XL5y4m6", "expanded_url": "https://console.x.com", "display_url": "console.x.com" } ] }, "description": { "mentions": [ { "start": 29, "start_str": "29", "end": 36, "end_str": "36", "username": "google" }, { "start": 38, "start_str": "38", "end": 47, "end_str": "47", "username": "coinbase" }, { "start": 49, "start_str": "49", "end": 51, "end_str": "51", "username": "X" }, { "start": 52, "start_str": "52", "end": 64, "end_str": "64", "username": "XDevelopers" } ] } }, "public_metrics": { "followers_count": 5502, "followers_count_str": "5502", "following_count": 651, "following_count_str": "651", "tweet_count": 789, "tweet_count_str": "789", "listed_count": 47, "listed_count_str": "47", "like_count": 8010, "like_count_str": "8010", "media_count": 79, "media_count_str": "79" }, "url": "https://t.co/OS6XL5y4m6", "created_at": "2023-10-23T13:44:53.000Z", "description": "X Developer Platform • prev. @google, @coinbase\n\n@X @XDevelopers", "is_identity_verified": true, "location": "Palo Alto, CA", "name": "Taylor" } } ] } } } ``` ### `post.mention.create` Disparado quando alguém @menciona o usuário filtrado em um Post. Evento privado — requer autenticação no contexto do usuário. ```json title="post.mention.create" expandable lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "2080765813578191303", "filter": { "user_id": "1716450569358098432" }, "event_type": "post.mention.create", "tag": "my post mentions", "payload": { "paid_partnership": false, "created_at": "2026-07-24T21:23:23.000Z", "edit_history_tweet_ids": [ "2080765813578191303" ], "conversation_id": "2080765813578191303", "display_text_range": [ 0, 16 ], "edit_controls": { "edits_remaining": 5, "edits_remaining_str": "5", "is_edit_eligible": true, "editable_until": "2026-07-24T22:23:23.000Z" }, "text": "hey @taycaldwell", "entities": { "mentions": [ { "start": 4, "start_str": "4", "end": 16, "end_str": "16", "username": "taycaldwell", "id": "1716450569358098432" } ] }, "author_id": "2046316926083764224", "possibly_sensitive": false, "public_metrics": { "retweet_count": 0, "retweet_count_str": "0", "reply_count": 0, "reply_count_str": "0", "like_count": 0, "like_count_str": "0", "quote_count": 0, "quote_count_str": "0", "bookmark_count": 0, "bookmark_count_str": "0", "impression_count": 0, "impression_count_str": "0" }, "reply_settings": "everyone", "id": "2080765813578191303", "lang": "und" }, "includes": { "users": [ { "public_metrics": { "followers_count": 97, "followers_count_str": "97", "following_count": 1, "following_count_str": "1", "tweet_count": 50, "tweet_count_str": "50", "listed_count": 4, "listed_count_str": "4", "like_count": 26, "like_count_str": "26", "media_count": 3, "media_count_str": "3" }, "profile_banner_url": "", "username": "paypertaylor2", "protected": false, "is_identity_verified": false, "affiliation": { "badge_url": "https://pbs.twimg.com/semantic_core_img/1428827730364096519/4ZXpTBhS?format=png&name=orig", "description": "Automated" }, "most_recent_tweet_id": "2080765813578191303", "verified_type": "none", "description": "", "created_at": "2026-04-20T19:55:59.000Z", "profile_image_url": "https://pbs.twimg.com/profile_images/2050311008334598144/EX0NG310_normal.jpg", "name": "paypertaylor2", "verified": false, "url": "", "id": "2046316926083764224" }, { "public_metrics": { "followers_count": 5502, "followers_count_str": "5502", "following_count": 651, "following_count_str": "651", "tweet_count": 789, "tweet_count_str": "789", "listed_count": 46, "listed_count_str": "46", "like_count": 8010, "like_count_str": "8010", "media_count": 79, "media_count_str": "79" }, "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1784928028", "username": "taycaldwell", "protected": false, "is_identity_verified": true, "affiliation": { "user_id": [ "783214" ], "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg", "url": "https://twitter.com/X", "description": "X" }, "most_recent_tweet_id": "2080761269309813134", "verified_type": "blue", "description": "X Developer Platform • prev @google, @coinbase\n\n@X @XDevelopers", "pinned_tweet_id": "1968451310203859083", "created_at": "2023-10-23T13:44:53.000Z", "profile_image_url": "https://pbs.twimg.com/profile_images/2080765075858825216/iZCZNCsV_normal.jpg", "name": "Taylor Caldwell", "verified": true, "url": "https://t.co/7SzJl0jTOo", "location": "San Francisco, CA", "id": "1716450569358098432", "entities": { "url": { "urls": [ { "start": 0, "start_str": "0", "end": 23, "end_str": "23", "url": "https://t.co/7SzJl0jTOo", "expanded_url": "https://developer.x.com", "display_url": "developer.x.com" } ] }, "description": { "mentions": [ { "start": 28, "start_str": "28", "end": 35, "end_str": "35", "username": "google" }, { "start": 37, "start_str": "37", "end": 46, "end_str": "46", "username": "coinbase" }, { "start": 48, "start_str": "48", "end": 50, "end_str": "50", "username": "X" }, { "start": 51, "start_str": "51", "end": 63, "end_str": "63", "username": "XDevelopers" } ] } } } ], "tweets": [ { "paid_partnership": false, "created_at": "2026-07-24T21:23:23.000Z", "edit_history_tweet_ids": [ "2080765813578191303" ], "conversation_id": "2080765813578191303", "display_text_range": [ 0, 16 ], "edit_controls": { "edits_remaining": 5, "edits_remaining_str": "5", "is_edit_eligible": true, "editable_until": "2026-07-24T22:23:23.000Z" }, "text": "hey @taycaldwell", "entities": { "mentions": [ { "start": 4, "start_str": "4", "end": 16, "end_str": "16", "username": "taycaldwell", "id": "1716450569358098432" } ] }, "author_id": "2046316926083764224", "possibly_sensitive": false, "public_metrics": { "retweet_count": 0, "retweet_count_str": "0", "reply_count": 0, "reply_count_str": "0", "like_count": 0, "like_count_str": "0", "quote_count": 0, "quote_count_str": "0", "bookmark_count": 0, "bookmark_count_str": "0", "impression_count": 0, "impression_count_str": "0" }, "reply_settings": "everyone", "id": "2080765813578191303", "lang": "und" } ] } } } ``` *** ## Eventos de curtida ### `like.create` Disparado quando o usuário filtrado curte um Post ou quando um dos seus Posts é curtido. Evento privado — requer autenticação no contexto do usuário. Suporta um filtro `direction` opcional (`inbound` ou `outbound`). O `payload` é um objeto de curtida com os seguintes campos: | Campo | Descrição | | ----------------------- | -------------------------------------------------------- | | `id` | ID do evento de curtida | | `liked_tweet_id` | ID do Post que foi curtido | | `liked_tweet_author_id` | Autor do Post curtido | | `created_at` | Horário de criação do Post curtido (quando disponível) | | `timestamp_ms` | Timestamp do evento em milissegundos (quando disponível) | `includes` pode conter o Post curtido e os usuários relacionados. ```json title="like.create" expandable lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "-3402274206530057851", "filter": { "user_id": "1716450569358098432", "direction": "outbound" }, "event_type": "like.create", "tag": "my likes", "payload": { "id": "87719f50ee17bdfa06a3089098a2b9ed", "created_at": "2026-07-24T21:12:45.000Z", "timestamp_ms": "1784927565236", "liked_tweet_author_id": "2533341854", "liked_tweet_id": "2079814480427442556" }, "includes": { "users": [ { "description": "𝕏 | @X @API @XDevelopers", "pinned_tweet_id": "2040770361566826685", "url": "", "profile_banner_url": "https://pbs.twimg.com/profile_banners/2533341854/1638372155", "created_at": "2014-05-29T20:24:26.000Z", "entities": { "description": { "mentions": [ { "start": 4, "start_str": "4", "end": 6, "end_str": "6", "username": "X" }, { "start": 7, "start_str": "7", "end": 11, "end_str": "11", "username": "API" }, { "start": 12, "start_str": "12", "end": 24, "end_str": "24", "username": "XDevelopers" } ] } }, "public_metrics": { "followers_count": 26972, "followers_count_str": "26972", "following_count": 1713, "following_count_str": "1713", "tweet_count": 2994, "tweet_count_str": "2994", "listed_count": 297, "listed_count_str": "297", "like_count": 47468, "like_count_str": "47468", "media_count": 265, "media_count_str": "265" }, "affiliation": { "description": "X", "url": "https://twitter.com/X", "user_id": [ "783214" ], "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg" }, "name": "Chris Park", "verified_type": "blue", "id": "2533341854", "profile_image_url": "https://pbs.twimg.com/profile_images/1770195415729569792/wUEX1LCO_normal.jpg", "username": "chrisparkX", "protected": false, "is_identity_verified": false, "location": "New York, NY", "verified": true, "profile_geo_enrichment": { "potential_locations": [ { "geo_entity": { "entity_id": "5128638", "display_name": "New York, United States", "country_code": "US", "region": "New York", "geo_point": { "latitude": 43.00035, "longitude": -75.4999 } } } ] } } ], "tweets": [ { "possibly_sensitive": false, "edit_controls": { "edits_remaining": 5, "edits_remaining_str": "5", "is_edit_eligible": true, "editable_until": "2026-07-22T07:23:07.000Z" }, "lang": "en", "text": "Great guide on using the X API via our new XMCP and Grok Build to build a structured knowledge system powered by X—unlocking great use cases like agentic research, realtime monitoring the situation, and an audience flywheel to improve as creators on X. https://t.co/5DedenNGo9", "conversation_id": "2079814480427442556", "created_at": "2026-07-22T06:23:07.000Z", "paid_partnership": false, "author_id": "2533341854", "entities": { "urls": [ { "start": 253, "start_str": "253", "end": 276, "end_str": "276", "url": "https://t.co/5DedenNGo9", "expanded_url": "https://twitter.com/xfreeze/status/2079756440722665849", "display_url": "x.com/xfreeze/status…" } ] }, "edit_history_tweet_ids": [ "2079814480427442556" ], "id": "2079814480427442556", "public_metrics": { "retweet_count": 16, "retweet_count_str": "16", "reply_count": 8, "reply_count_str": "8", "like_count": 131, "like_count_str": "131", "quote_count": 2, "quote_count_str": "2", "bookmark_count": 90, "bookmark_count_str": "90", "impression_count": 21004, "impression_count_str": "21004" }, "referenced_tweets": [ { "type": "quoted", "id": "2079756440722665849" } ], "display_text_range": [ 0, 252 ], "reply_settings": "everyone" } ] } } } ``` *** ## Eventos de seguir ### `follow.follow` Disparado quando o usuário filtrado segue outro usuário ou é seguido. O `payload` inclui `source` (o seguidor) e `target` (o usuário que está sendo seguido). ```json title="follow.follow" expandable lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "-7953119945885597316", "filter": { "user_id": "1716450569358098432" }, "event_type": "follow.follow", "tag": "my follows", "payload": { "source": { "data": { "affiliation": { "description": "X", "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg", "url": "https://twitter.com/X" }, "location": "Palo Alto, CA", "name": "Taylor", "profile_image_url": "https://pbs.twimg.com/profile_images/2035547159203139584/BKh7KcEt_normal.jpg", "created_at": "2023-10-23T13:44:53.000Z", "protected": false, "verified": true, "url": "https://t.co/OS6XL5y4m6", "public_metrics": { "followers_count": 5502, "followers_count_str": "5502", "following_count": 652, "following_count_str": "652", "tweet_count": 790, "tweet_count_str": "790", "listed_count": 47, "listed_count_str": "47", "like_count": 8010, "like_count_str": "8010", "media_count": 79, "media_count_str": "79" }, "is_identity_verified": true, "description": "X Developer Platform • prev. @google, @coinbase\n\n@X @XDevelopers", "verified_type": "blue", "entities": { "url": { "urls": [ { "start": 0, "start_str": "0", "end": 23, "end_str": "23", "url": "https://t.co/OS6XL5y4m6", "expanded_url": "https://console.x.com", "display_url": "console.x.com" } ] }, "description": { "mentions": [ { "start": 29, "start_str": "29", "end": 36, "end_str": "36", "username": "google" }, { "start": 38, "start_str": "38", "end": 47, "end_str": "47", "username": "coinbase" }, { "start": 49, "start_str": "49", "end": 51, "end_str": "51", "username": "X" }, { "start": 52, "start_str": "52", "end": 64, "end_str": "64", "username": "XDevelopers" } ] } }, "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1779411426", "username": "taycaldwell", "id": "1716450569358098432" } }, "target": { "data": { "affiliation": { "description": "X", "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg", "url": "https://twitter.com/X" }, "name": "API", "profile_image_url": "https://pbs.twimg.com/profile_images/1683497657388392455/yW7azZHt_normal.jpg", "created_at": "2007-05-23T06:01:13.000Z", "protected": false, "verified": true, "url": "https://t.co/YrfsitXdac", "public_metrics": { "followers_count": 4934564, "followers_count_str": "4934564", "following_count": 12, "following_count_str": "12", "tweet_count": 3755, "tweet_count_str": "3755", "listed_count": 11603, "listed_count_str": "11603", "like_count": 7, "like_count_str": "7", "media_count": 9, "media_count_str": "9" }, "is_identity_verified": false, "description": "Updates about X API changes and service issues.", "verified_type": "business", "entities": { "url": { "urls": [ { "start": 0, "start_str": "0", "end": 23, "end_str": "23", "url": "https://t.co/YrfsitXdac", "expanded_url": "https://developer.x.com", "display_url": "developer.x.com" } ] } }, "profile_banner_url": "https://pbs.twimg.com/profile_banners/6253282/1690212094", "username": "API", "id": "6253282" } } } } } ``` ### `follow.unfollow` Disparado quando o usuário filtrado deixa de seguir outro usuário ou deixa de ser seguido. Mesma estrutura de `source` / `target` que `follow.follow`. ```json title="follow.unfollow" expandable lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "-4233426745281461957", "filter": { "user_id": "1716450569358098432" }, "event_type": "follow.unfollow", "tag": "my unfollows", "payload": { "source": { "data": { "affiliation": { "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg", "url": "https://twitter.com/X", "description": "X" }, "url": "https://t.co/OS6XL5y4m6", "description": "X Developer Platform • prev. @google, @coinbase\n\n@X @XDevelopers", "verified": true, "entities": { "url": { "urls": [ { "start": 0, "start_str": "0", "end": 23, "end_str": "23", "url": "https://t.co/OS6XL5y4m6", "expanded_url": "https://console.x.com", "display_url": "console.x.com" } ] }, "description": { "mentions": [ { "start": 29, "start_str": "29", "end": 36, "end_str": "36", "username": "google" }, { "start": 38, "start_str": "38", "end": 47, "end_str": "47", "username": "coinbase" }, { "start": 49, "start_str": "49", "end": 51, "end_str": "51", "username": "X" }, { "start": 52, "start_str": "52", "end": 64, "end_str": "64", "username": "XDevelopers" } ] } }, "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1779411426", "is_identity_verified": true, "username": "taycaldwell", "id": "1716450569358098432", "name": "Taylor", "profile_image_url": "https://pbs.twimg.com/profile_images/2035547159203139584/BKh7KcEt_normal.jpg", "created_at": "2023-10-23T13:44:53.000Z", "public_metrics": { "followers_count": 5502, "followers_count_str": "5502", "following_count": 651, "following_count_str": "651", "tweet_count": 790, "tweet_count_str": "790", "listed_count": 47, "listed_count_str": "47", "like_count": 8010, "like_count_str": "8010", "media_count": 79, "media_count_str": "79" }, "verified_type": "blue", "location": "Palo Alto, CA", "protected": false } }, "target": { "data": { "affiliation": { "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg", "url": "https://twitter.com/X", "description": "X" }, "url": "https://t.co/YrfsitXdac", "description": "Updates about X API changes and service issues.", "verified": true, "entities": { "url": { "urls": [ { "start": 0, "start_str": "0", "end": 23, "end_str": "23", "url": "https://t.co/YrfsitXdac", "expanded_url": "https://developer.x.com", "display_url": "developer.x.com" } ] } }, "profile_banner_url": "https://pbs.twimg.com/profile_banners/6253282/1690212094", "is_identity_verified": false, "username": "API", "id": "6253282", "name": "API", "profile_image_url": "https://pbs.twimg.com/profile_images/1683497657388392455/yW7azZHt_normal.jpg", "created_at": "2007-05-23T06:01:13.000Z", "public_metrics": { "followers_count": 4934563, "followers_count_str": "4934563", "following_count": 12, "following_count_str": "12", "tweet_count": 3755, "tweet_count_str": "3755", "listed_count": 11603, "listed_count_str": "11603", "like_count": 7, "like_count_str": "7", "media_count": 9, "media_count_str": "9" }, "verified_type": "business", "protected": false } } } } } ``` *** ## Eventos de perfil Todos os eventos `profile.update.*` compartilham a mesma estrutura de payload com `before` / `after`. Tipos suportados: `profile.update.bio`, `profile.update.profile_picture`, `profile.update.banner_picture`, `profile.update.screenname`, `profile.update.handle`, `profile.update.geo`, `profile.update.url`, `profile.update.verified_badge`, `profile.update.affiliate_badge`. ### `profile.update.bio` Disparado quando o usuário filtrado atualiza a bio do perfil. ```json title="profile.update.bio" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "-8917909039855612786", "filter": { "user_id": "1716450569358098432" }, "event_type": "profile.update.bio", "tag": "my bio updates", "payload": { "before": "X Developer Platform • prev. @google, @coinbase\n\n@X @XDevelopers", "after": "X Developer Platform • prev @google, @coinbase\n\n@X @XDevelopers" } } } ``` ### `profile.update.profile_picture` Disparado quando o usuário filtrado atualiza a foto de perfil. ```json title="profile.update.profile_picture" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "3497989179769309099", "filter": { "user_id": "1716450569358098432" }, "event_type": "profile.update.profile_picture", "tag": "my profile picture updates", "payload": { "before": "https://pbs.twimg.com/profile_images/2035547159203139584/BKh7KcEt.jpg", "after": "https://pbs.twimg.com/profile_images/2080765075858825216/iZCZNCsV.jpg" } } } ``` ### `profile.update.banner_picture` Disparado quando o usuário filtrado atualiza o banner do perfil. ```json title="profile.update.banner_picture" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "5061407317112342192", "filter": { "user_id": "1716450569358098432" }, "event_type": "profile.update.banner_picture", "tag": "my banner updates", "payload": { "before": "https://pbs.twimg.com/profile_banners/1716450569358098432/1779411426", "after": "https://pbs.twimg.com/profile_banners/1716450569358098432/1784928028" } } } ``` ### `profile.update.screenname` Disparado quando o usuário filtrado atualiza o nome de exibição. ```json title="profile.update.screenname" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "4123434298221215973", "filter": { "user_id": "1716450569358098432" }, "event_type": "profile.update.screenname", "tag": "my display name updates", "payload": { "before": "Taylor", "after": "Taylor Caldwell" } } } ``` ### `profile.update.geo` Disparado quando o usuário filtrado atualiza a localização do perfil. ```json title="profile.update.geo" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "8309664692915093892", "filter": { "user_id": "1716450569358098432" }, "event_type": "profile.update.geo", "tag": "my location updates", "payload": { "before": "Palo Alto, CA", "after": "San Francisco, CA" } } } ``` ### `profile.update.url` Disparado quando o usuário filtrado atualiza a URL do site do perfil. ```json title="profile.update.url" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "-6055744140117128555", "filter": { "user_id": "1716450569358098432" }, "event_type": "profile.update.url", "tag": "my url updates", "payload": { "before": "https://t.co/OS6XL5y4m6", "after": "https://t.co/7SzJl0jTOo" } } } ``` ### `profile.update.handle` Disparado quando o usuário filtrado atualiza seu @handle. Mesma estrutura de payload `before` / `after` que os demais eventos de perfil. ### `profile.update.verified_badge` Disparado quando o selo de verificação do usuário filtrado é alterado. Mesma estrutura de payload `before` / `after` que os demais eventos de perfil. ### `profile.update.affiliate_badge` Disparado quando o selo de afiliação do usuário filtrado é alterado. Mesma estrutura de payload `before` / `after` que os demais eventos de perfil. *** ## Eventos de chat (XChat) Os payloads de chat criptografado incluem campos codificados opacos usados pelas bibliotecas cliente do XChat. Eventos privados — requerem autenticação no contexto do usuário. ### `chat.received` ```json title="chat.received" expandable lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "8511582263942905822", "filter": { "user_id": "1830023695835787264" }, "event_type": "chat.received", "tag": "my chat received", "payload": { "conversation_token": "eyJhbGciOiJIUzI1NiJ9.eyJyZXF1ZXN0aW5nVXNlciI6ICIxODMwMDIzNjk1ODM1Nzg3MjY0IiwgInJlY2lwaWVudCI6ICIxMDM0MjAyMjcyMzEyNTA0MzIwIiwgInZhbGlkU2luY2VNU2VjIjogIjE3NDU4ODQ4MDAwMDAifQ.86ymJsmru5KJtNvlvNXCErgMeevqaNBgBvLiSZa_kbo", "id": "e4f4d3fc-8bbf-4928-92eb-e5058d6bb6f6", "created_at_msec": "1784841183370", "sender_id": "1034202272312504320", "conversation_id": "1034202272312504320:1830023695835787264", "conversation_key_version": "1768236281331", "encoded_event": "CwABAAAAEzIwODA0MDA4MjUyMjcxMDAxNjALAAIAAAAkZTRmNGQzZmMtOGJiZi00OTI4LTkyZWItZTUwNThkNmJiNmY2CwADAAAAEzEwMzQyMDIyNzIzMTI1MDQzMjALAAQAAAAnMTAzNDIwMjI3MjMxMjUwNDMyMDoxODMwMDIzNjk1ODM1Nzg3MjY0CwAFAAAA12V5SmhiR2NpT2lKSVV6STFOaUo5LmV5SnlaWEYxWlhOMGFXNW5WWE5sY2lJNklDSXhPRE13TURJek5qazFPRE0xTnpnM01qWTBJaXdnSW5KbFkybHdhV1Z1ZENJNklDSXhNRE0wTWpBeU1qY3lNekV5TlRBME16SXdJaXdnSW5aaGJHbGtVMmx1WTJWTlUyVmpJam9nSWpFM05EVTRPRFE0TURBd01EQWlmUS44NnltSnNtcnU1S0p0TnZsdk5YQ0VyZ01lZXZxYU5CZ0J2TGlTWmFfa2JvCwAGAAAADTE3ODQ4NDExODMzNzAMAAcMAAELAGQAAABTzxVCBCVAlguLYySJdcYhpgpUgQYshT8ZDGTu+ukrdsGGBQ26N5r2/TNd7FJ/znc64yz9gv6u6xdA4IlWu+C4ScjGYgJ+7A8nLxDREFtYvlmqlDQLAGUAAAANMTc2ODIzNjI4MTMzMQIAZgECAGkACABqAAAAAQwAbAsAAQAAACBKpTut+m1aRnpYRpLv2RT2EaZGCqyjz3jp9zZ2ldrO6QsAAgAAAEjpfQJPSWghOYDoroi35e0Au4Lp5ClsN0brEmBVp7wwZo6qX3PbnSsBD2tqV8gk7JDSMTvSMjndOjk/MMHwGsYDt6Fn9yNJ+NoAAgBtAAAADAAJCwABAAAAVjZJSzlTWklNWEJlNVNGY0I3dkdaSmQ1QTVFYjVNTHZud3JoVUZmQkd2NFM1R3NTWDNXV1BHdUluWFZOZlNsYTM2RWpYUVEvUi9IaHNBKzJoUEFFWTdBCwACAAAADTE3NjUzODI2MzQ4MTcLAAMAAAABNwsABAAAAHxNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUVKMmMrM0JZWnM3WkNFWS9VUENwbVF4Sk85djZGSmpldXN2bVNaTy9KRWF5OG9GMStvWFhsSFY1NWtYNGJLNi96RmlqTkt2cTFZUmIwaXQweVhxYmdsQT09DwAFDAAAAAELAAEAAAATMTAzNDIwMjI3MjMxMjUwNDMyMAsAAgAAAA0xNzY1MzgyNjM0ODE3CwADAAAAfE1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRUoyYyszQllaczdaQ0VZL1VQQ3BtUXhKTzl2NkZKamV1c3ZtU1pPL0pFYXk4b0YxK29YWGxIVjU1a1g0Yks2L3pGaWpOS3ZxMVlSYjBpdDB5WHFiZ2xBPT0AAAIACwELAA0AAAADMC0xAA==", "conversation_key_change_event": "CwABAAAAEzIwMTA3NTQ4MTkxMTY0NDk5MDULAAIAAAAkNGNlNjQ1ZDItYTg5YS00OTlmLThiZGUtZTBhMWY0M2QxOTFmCwADAAAAEzE4MzAwMjM2OTU4MzU3ODcyNjQLAAQAAAAnMTAzNDIwMjI3MjMxMjUwNDMyMDoxODMwMDIzNjk1ODM1Nzg3MjY0CwAFAAAA12V5SmhiR2NpT2lKSVV6STFOaUo5LmV5SnlaWEYxWlhOMGFXNW5WWE5sY2lJNklDSXhPRE13TURJek5qazFPRE0xTnpnM01qWTBJaXdnSW5aaGJHbGtVMmx1WTJWTlUyVmpJam9nSWpFM05EVTRPRFE0TURBd01EQWlmUS44NnltSnNtcnU1S0p0TnZsdk5YQ0VyZ01lZXZxYU5CZ0J2TGlTWmFfa2JvCwAGAAAADTE3NjgyMzYyODE1NTkMAAcMAAMLAAEAAAANMTc2ODIzNjI4MTMzMQ8AAgwAAAACCwABAAAAEzEwMzQyMDIyNzIzMTI1MDQzMjALAAIAAACYQkVzU1pNTTZxMEhPM0FRVjlXWk52cWh0YndyblFpeE1zcEo5VkVZNmpvMVR2cFV1SmxjaE9GNVgxMFUrUStFRmMvZWZjMlpjYnRmSFR6ZFlzSDN2VExXdENJZE1qR1orZ0JGc0o4cEF1cmx6clR6ZkFPeVNPNWlYZEhBeVJ6c085TlV0TGZnUjJ4TWxJRVA2Y2M4bk1nUT0LAAMAAAANMTc2NTM4MjYzNDgxNwALAAEAAAATMTgzMDAyMzY5NTgzNTc4NzI2NAsAAgAAAJhCRDdHZEdXYklaaHdQaEFQaFYwVktoKyswR2poR3l5QXp0Yk1jL0ZHSWYvbCtSYThpU3lhV2tROFpSVVJtT25aRnN5VzNwMjRiMFp1QWg3dkNjZlpOV2dOZ1hpQUJIZmYxL1RpVFdLZ1FkM1liR0dyakV6eHJlZ0NmRWxRZmhaTFBDaEttQ0orb01wM2svL2RrRUhoSXNvPQsAAwAAAA0xNzM2NzIzODI4NjY3AAAADAAJCwABAAAAVlJpL1BsYndGK3Z4Yjdjb3BFSGgzOGNVdmx2cSt1cVp2eWRybVd3T2lBWE80c09mbm94MUUvM1U1RVV6QjBGL0RjMGkzNGNEejBXNjBXdFpTWnkrZUJBCwACAAAADTE3MzY3MjM4Mjg2NjcLAAMAAAABNAsABAAAAHxNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUV5eFFZKzNDSTJsd01GNUVxUldjNlhNUm5ZbVRuYVFYaFF5MW96Y2h6MElRbjd1aTVyeTFVU3pTY1Q5MDBXeVRQa05tU3ZHK004dHh6KzhZNVdmMGdaUT09AAA=", "message_event_signature": { "public_key_version": "1765382634817", "signature": "6IK9SZIMXBe5SFcB7vGZJd5A5Eb5MLvnwrhUFfBGv4S5GsSX3WWPGuInXVNfSla36EjXQQ/R/HhsA+2hPAEY7A", "signature_version": "7", "signing_public_key": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEJ2c+3BYZs7ZCEY/UPCpmQxJO9v6FJjeusvmSZO/JEay8oF1+oXXlHV55kX4bK6/zFijNKvq1YRb0it0yXqbglA==" } } } } ``` ### `chat.sent` ```json title="chat.sent" expandable lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "3723060601307155846", "filter": { "user_id": "1830023695835787264" }, "event_type": "chat.sent", "tag": "my chat sent", "payload": { "conversation_token": "eyJhbGciOiJIUzI1NiJ9.eyJyZXF1ZXN0aW5nVXNlciI6ICIxODMwMDIzNjk1ODM1Nzg3MjY0IiwgInJlY2lwaWVudCI6ICIxMDM0MjAyMjcyMzEyNTA0MzIwIiwgInZhbGlkU2luY2VNU2VjIjogIjE3NDU4ODQ4MDAwMDAifQ.86ymJsmru5KJtNvlvNXCErgMeevqaNBgBvLiSZa_kbo", "id": "8e75466b-56ec-4e88-bddf-b18f7cc6030e", "created_at_msec": "1784841233939", "sender_id": "1830023695835787264", "conversation_id": "1034202272312504320:1830023695835787264", "conversation_key_version": "1768236281331", "encoded_event": "CwABAAAAEzIwODA0MDEwMzczMzMyMzc3NjALAAIAAAAkOGU3NTQ2NmItNTZlYy00ZTg4LWJkZGYtYjE4ZjdjYzYwMzBlCwADAAAAEzE4MzAwMjM2OTU4MzU3ODcyNjQLAAQAAAAnMTAzNDIwMjI3MjMxMjUwNDMyMDoxODMwMDIzNjk1ODM1Nzg3MjY0CwAFAAAA12V5SmhiR2NpT2lKSVV6STFOaUo5LmV5SnlaWEYxWlhOMGFXNW5WWE5sY2lJNklDSXhPRE13TURJek5qazFPRE0xTnpnM01qWTBJaXdnSW5KbFkybHdhV1Z1ZENJNklDSXhNRE0wTWpBeU1qY3lNekV5TlRBME16SXdJaXdnSW5aaGJHbGtVMmx1WTJWTlUyVmpJam9nSWpFM05EVTRPRFE0TURBd01EQWlmUS44NnltSnNtcnU1S0p0TnZsdk5YQ0VyZ01lZXZxYU5CZ0J2TGlTWmFfa2JvCwAGAAAADTE3ODQ4NDEyMzM5MzkMAAcMAAELAGQAAABTH3krC1zh+3xP3AFJAdsXAzyU+i28GsAnsxk9LHLIAkYOcRpiEaP4ajkqrZ9PgxuqhA3+nsvJYyGDPHxeH+Wop/15BXDMmwGt6S259l3odPepvEMLAGUAAAANMTc2ODIzNjI4MTMzMQIAZgECAGkACABqAAAAAQwAbAsAAQAAACB948bZ8lP62xtQFXYtMh1V2xrDLFa7kwSnsXLgwLydVAsAAgAAAEgNfFI7/1jMfU7qQ0sfzSMEnapZn+9JlopoOmO9vm7FjZwEQgtk0E6A8ZxhUCSWN8xxb6k2aK417KxvDO5C6iD7DKy3mwc6phYAAgBtAAAADAAJCwABAAAAVk1hbnVSdkJ1cGlwMzhYemdTNzMzVjl4Vm4vNis0dWd1TXd2TWErWVVEUWlESXhWaFZiYVFjTitiS3liUFJCQ2o3SVB1UmkyUVF6UnZQZzdXcTlaaFB3CwACAAAADTE3MzY3MjM4Mjg2NjcLAAMAAAABNwsABAAAAHxNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUV5eFFZKzNDSTJsd01GNUVxUldjNlhNUm5ZbVRuYVFYaFF5MW96Y2h6MElRbjd1aTVyeTFVU3pTY1Q5MDBXeVRQa05tU3ZHK004dHh6KzhZNVdmMGdaUT09DwAFDAAAAAELAAEAAAATMTgzMDAyMzY5NTgzNTc4NzI2NAsAAgAAAA0xNzM2NzIzODI4NjY3CwADAAAAfE1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRXl4UVkrM0NJMmx3TUY1RXFSV2M2WE1SblltVG5hUVhoUXkxb3pjaHowSVFuN3VpNXJ5MVVTelNjVDkwMFd5VFBrTm1TdkcrTTh0eHorOFk1V2YwZ1pRPT0AAAIACwELAA0AAAADMC0yAA==", "conversation_key_change_event": "CwABAAAAEzIwMTA3NTQ4MTkxMTY0NDk5MDULAAIAAAAkNGNlNjQ1ZDItYTg5YS00OTlmLThiZGUtZTBhMWY0M2QxOTFmCwADAAAAEzE4MzAwMjM2OTU4MzU3ODcyNjQLAAQAAAAnMTAzNDIwMjI3MjMxMjUwNDMyMDoxODMwMDIzNjk1ODM1Nzg3MjY0CwAFAAAA12V5SmhiR2NpT2lKSVV6STFOaUo5LmV5SnlaWEYxWlhOMGFXNW5WWE5sY2lJNklDSXhPRE13TURJek5qazFPRE0xTnpnM01qWTBJaXdnSW5aaGJHbGtVMmx1WTJWTlUyVmpJam9nSWpFM05EVTRPRFE0TURBd01EQWlmUS44NnltSnNtcnU1S0p0TnZsdk5YQ0VyZ01lZXZxYU5CZ0J2TGlTWmFfa2JvCwAGAAAADTE3NjgyMzYyODE1NTkMAAcMAAMLAAEAAAANMTc2ODIzNjI4MTMzMQ8AAgwAAAACCwABAAAAEzEwMzQyMDIyNzIzMTI1MDQzMjALAAIAAACYQkVzU1pNTTZxMEhPM0FRVjlXWk52cWh0YndyblFpeE1zcEo5VkVZNmpvMVR2cFV1SmxjaE9GNVgxMFUrUStFRmMvZWZjMlpjYnRmSFR6ZFlzSDN2VExXdENJZE1qR1orZ0JGc0o4cEF1cmx6clR6ZkFPeVNPNWlYZEhBeVJ6c085TlV0TGZnUjJ4TWxJRVA2Y2M4bk1nUT0LAAMAAAANMTc2NTM4MjYzNDgxNwALAAEAAAATMTgzMDAyMzY5NTgzNTc4NzI2NAsAAgAAAJhCRDdHZEdXYklaaHdQaEFQaFYwVktoKyswR2poR3l5QXp0Yk1jL0ZHSWYvbCtSYThpU3lhV2tROFpSVVJtT25aRnN5VzNwMjRiMFp1QWg3dkNjZlpOV2dOZ1hpQUJIZmYxL1RpVFdLZ1FkM1liR0dyakV6eHJlZ0NmRWxRZmhaTFBDaEttQ0orb01wM2svL2RrRUhoSXNvPQsAAwAAAA0xNzM2NzIzODI4NjY3AAAADAAJCwABAAAAVlJpL1BsYndGK3Z4Yjdjb3BFSGgzOGNVdmx2cSt1cVp2eWRybVd3T2lBWE80c09mbm94MUUvM1U1RVV6QjBGL0RjMGkzNGNEejBXNjBXdFpTWnkrZUJBCwACAAAADTE3MzY3MjM4Mjg2NjcLAAMAAAABNAsABAAAAHxNRmt3RXdZSEtvWkl6ajBDQVFZSUtvWkl6ajBEQVFjRFFnQUV5eFFZKzNDSTJsd01GNUVxUldjNlhNUm5ZbVRuYVFYaFF5MW96Y2h6MElRbjd1aTVyeTFVU3pTY1Q5MDBXeVRQa05tU3ZHK004dHh6KzhZNVdmMGdaUT09AAA=", "message_event_signature": { "public_key_version": "1736723828667", "signature": "ManuRvBupip38XzgS733V9xVn/6+4uguMwvMa+YUDQiDIxVhVbaQcN+bKybPRBCj7IPuRi2QQzRvPg7Wq9ZhPw", "signature_version": "7", "signing_public_key": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEyxQY+3CI2lwMF5EqRWc6XMRnYmTnaQXhQy1ozchz0IQn7ui5ry1USzScT900WyTPkNmSvG+M8txz+8Y5Wf0gZQ==" } } } } ``` ### `chat.conversation_join` Disparado quando um usuário entra em uma conversa de chat criptografada. A estrutura do payload é a mesma dos outros eventos de chat (identidade da conversa e material criptográfico codificado). Evento privado — requer autenticação no contexto do usuário. *** ## Eventos de DM legados Eventos de DM legados (não criptografados). Eventos privados — requerem autenticação no contexto do usuário. ### `dm.sent` Disparado quando o usuário filtrado envia um DM não criptografado. O `payload` inclui `direct_message_events` e um mapa `users`. ```json title="dm.sent" expandable lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "-3577827201104920132", "filter": { "user_id": "1716450569358098432" }, "event_type": "dm.sent", "tag": "my dm sent", "payload": { "direct_message_events": [ { "type": "message_create", "id": "2080763914820927863", "created_timestamp": "1784927750704", "message_create": { "target": { "recipient_id": "2244994945" }, "sender_id": "1716450569358098432", "message_data": { "text": "XAA docs payload capture test - please ignore 1784927750", "entities": { "hashtags": [], "symbols": [], "user_mentions": [], "urls": [] } } } } ], "users": { "1716450569358098432": { "data": { "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1779411426", "username": "taycaldwell", "affiliation": { "description": "X", "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg", "url": "https://twitter.com/X" }, "name": "Taylor", "verified_type": "blue", "description": "X Developer Platform • prev. @google, @coinbase\n\n@X @XDevelopers", "location": "Palo Alto, CA", "public_metrics": { "followers_count": 5502, "followers_count_str": "5502", "following_count": 651, "following_count_str": "651", "tweet_count": 789, "tweet_count_str": "789", "listed_count": 47, "listed_count_str": "47", "like_count": 8010, "like_count_str": "8010", "media_count": 79, "media_count_str": "79" }, "id": "1716450569358098432", "url": "https://t.co/OS6XL5y4m6", "protected": false, "created_at": "2023-10-23T13:44:53.000Z", "is_identity_verified": true, "verified": true, "entities": { "url": { "urls": [ { "start": 0, "start_str": "0", "end": 23, "end_str": "23", "url": "https://t.co/OS6XL5y4m6", "expanded_url": "https://console.x.com", "display_url": "console.x.com" } ] }, "description": { "mentions": [ { "start": 29, "start_str": "29", "end": 36, "end_str": "36", "username": "google" }, { "start": 38, "start_str": "38", "end": 47, "end_str": "47", "username": "coinbase" }, { "start": 49, "start_str": "49", "end": 51, "end_str": "51", "username": "X" }, { "start": 52, "start_str": "52", "end": 64, "end_str": "64", "username": "XDevelopers" } ] } }, "profile_image_url": "https://pbs.twimg.com/profile_images/2035547159203139584/BKh7KcEt_normal.jpg" } }, "2244994945": { "data": { "profile_banner_url": "https://pbs.twimg.com/profile_banners/2244994945/1690213128", "username": "XDevelopers", "affiliation": { "description": "X", "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg", "url": "https://twitter.com/X" }, "name": "Developers", "verified_type": "business", "description": "The voice of the X Dev team and your official source for updates, news, and events, related to the X API.", "location": "127.0.0.1", "public_metrics": { "followers_count": 694887, "followers_count_str": "694887", "following_count": 762, "following_count_str": "762", "tweet_count": 4309, "tweet_count_str": "4309", "listed_count": 2978, "listed_count_str": "2978", "like_count": 2626, "like_count_str": "2626", "media_count": 829, "media_count_str": "829" }, "id": "2244994945", "url": "https://t.co/NIwHVIVyrN", "protected": false, "created_at": "2013-12-14T04:35:55.000Z", "is_identity_verified": false, "verified": true, "entities": { "url": { "urls": [ { "start": 0, "start_str": "0", "end": 23, "end_str": "23", "url": "https://t.co/NIwHVIVyrN", "expanded_url": "https://docs.x.com/", "display_url": "docs.x.com" } ] } }, "profile_image_url": "https://pbs.twimg.com/profile_images/1683501992314798080/xl1POYLw_normal.jpg" } } } } } } ``` ### `dm.received` Disparado quando o usuário filtrado recebe um DM não criptografado. Mesma estrutura de payload que `dm.sent` (`direct_message_events` e um mapa `users`). Evento privado — requer autenticação no contexto do usuário. ```json title="dm.received" expandable lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "-6850472171600526495", "filter": { "user_id": "1716450569358098432" }, "event_type": "dm.received", "tag": "my dm received", "payload": { "direct_message_events": [ { "type": "message_create", "id": "2080765901528535096", "created_timestamp": "1784928224372", "message_create": { "target": { "recipient_id": "1716450569358098432" }, "sender_id": "2046316926083764224", "message_data": { "text": "hello!", "entities": { "hashtags": [], "symbols": [], "user_mentions": [], "urls": [] } } } } ], "users": { "2046316926083764224": { "data": { "description": "", "profile_banner_url": "", "public_metrics": { "followers_count": 97, "followers_count_str": "97", "following_count": 1, "following_count_str": "1", "tweet_count": 50, "tweet_count_str": "50", "listed_count": 4, "listed_count_str": "4", "like_count": 27, "like_count_str": "27", "media_count": 3, "media_count_str": "3" }, "protected": false, "url": "", "affiliation": { "description": "Automated", "badge_url": "https://pbs.twimg.com/semantic_core_img/1428827730364096519/4ZXpTBhS?format=png&name=orig" }, "is_identity_verified": false, "id": "2046316926083764224", "profile_image_url": "https://pbs.twimg.com/profile_images/2050311008334598144/EX0NG310_normal.jpg", "verified_type": "none", "created_at": "2026-04-20T19:55:59.000Z", "username": "paypertaylor2", "verified": false, "name": "paypertaylor2" } }, "1716450569358098432": { "data": { "description": "X Developer Platform • prev @google, @coinbase\n\n@X @XDevelopers", "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1784928028", "entities": { "url": { "urls": [ { "start": 0, "start_str": "0", "end": 23, "end_str": "23", "url": "https://t.co/7SzJl0jTOo", "expanded_url": "https://developer.x.com", "display_url": "developer.x.com" } ] }, "description": { "mentions": [ { "start": 28, "start_str": "28", "end": 35, "end_str": "35", "username": "google" }, { "start": 37, "start_str": "37", "end": 46, "end_str": "46", "username": "coinbase" }, { "start": 48, "start_str": "48", "end": 50, "end_str": "50", "username": "X" }, { "start": 51, "start_str": "51", "end": 63, "end_str": "63", "username": "XDevelopers" } ] } }, "public_metrics": { "followers_count": 5502, "followers_count_str": "5502", "following_count": 651, "following_count_str": "651", "tweet_count": 789, "tweet_count_str": "789", "listed_count": 46, "listed_count_str": "46", "like_count": 8010, "like_count_str": "8010", "media_count": 79, "media_count_str": "79" }, "location": "San Francisco, CA", "protected": false, "url": "https://t.co/7SzJl0jTOo", "affiliation": { "description": "X", "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg", "url": "https://twitter.com/X" }, "is_identity_verified": true, "id": "1716450569358098432", "profile_image_url": "https://pbs.twimg.com/profile_images/2080765075858825216/iZCZNCsV_normal.jpg", "verified_type": "blue", "created_at": "2023-10-23T13:44:53.000Z", "username": "taycaldwell", "verified": true, "name": "Taylor Caldwell" } } } } } } ``` ### `dm.read` Disparado quando um participante lê o DM não criptografado do usuário filtrado (confirmação de leitura). Evento privado — requer autenticação no contexto do usuário. ### `dm.indicate_typing` Disparado quando um participante está digitando uma mensagem para o usuário filtrado. Evento privado — requer autenticação no contexto do usuário. *** ## Eventos de notícias ### `news.new` Filtre por `keyword`. O `payload` inclui campos de notícias selecionadas pelo Grok, como categoria, nome, chamada, resumo, contextos e resultados de posts do cluster relacionado. | Campo | Descrição | | ----------------------- | --------------------------------------------- | | `id` | ID do item de notícia | | `name` | Manchete / nome do tópico | | `category` | Categoria da notícia | | `hook` | Chamada curta / teaser | | `summary` | Resumo mais longo | | `contexts` | Contextos de tópicos / entidades relacionadas | | `cluster_posts_results` | Posts relacionados, quando disponíveis | | `updated_at` | Timestamp da última atualização | | `disclaimer` | Texto de aviso opcional | ```json title="news.new" expandable lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "2080756868147019827", "filter": { "keyword": "OpenAI" }, "event_type": "news.new", "tag": "openai news", "payload": { "summary": "OpenAI rolled out a new feature in ChatGPT's web version that lets users create virtual pets by describing them, generating fun companions like a fluffy gray cat or a seal in a yellow bow tie. Creators can copy a shareable link from personalization settings, allowing friends to adopt the pet easily, with spritesheets downloadable for the desktop app. Reactions lean lighthearted, with users calling the pets underrated and dreaming up Pokémon-style trading and battles, though some wonder about better uses for the tech.", "contexts": { "entities": { "events": [], "organizations": [ "OpenAI" ], "people": [], "places": [], "products": [] }, "topics": [ "Technology" ], "finance": { "tickers": [] }, "sports": { "teams": [] } }, "id": "2080756868147019827", "updated_at": "2026-07-24T20:53:37.000Z", "hook": "Imagine designing a green dinosaur with a bow tie, then sharing it with friends to adopt as their own ChatGPT companion.", "category": "News", "disclaimer": "This story is a summary of posts on X and may evolve over time. Grok can make mistakes, verify its outputs.", "cluster_posts_results": [ { "post_id": "2080756403493560652" }, { "post_id": "2080747505474736162" }, { "post_id": "2080750142437880021" }, { "post_id": "2080748929197523160" }, { "post_id": "2080747522323308860" }, { "post_id": "2080755240777736204" }, { "post_id": "2080749609681641909" }, { "post_id": "2080752936594903495" }, { "post_id": "2080752950692172087" }, { "post_id": "2080755140794237414" } ], "name": "ChatGPT Adds Custom Virtual Pets for Sharing" } } } ``` *** ## Eventos de Spaces ### `spaces.start` Disparado quando o usuário filtrado inicia um Space. O `payload` inclui o `user` host, `broadcast_id` e um `event_type` interno igual a `start`. ```json title="spaces.start" expandable lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "4093201169289922041", "filter": { "user_id": "1716450569358098432" }, "event_type": "spaces.start", "tag": "my spaces start", "payload": { "user": { "data": { "affiliation": { "description": "X", "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg", "url": "https://twitter.com/X" }, "location": "San Francisco, CA", "name": "Taylor Caldwell", "profile_image_url": "https://pbs.twimg.com/profile_images/2080765075858825216/iZCZNCsV_normal.jpg", "created_at": "2023-10-23T13:44:53.000Z", "protected": false, "verified": true, "url": "https://t.co/7SzJl0jTOo", "public_metrics": { "followers_count": 5502, "followers_count_str": "5502", "following_count": 651, "following_count_str": "651", "tweet_count": 789, "tweet_count_str": "789", "listed_count": 46, "listed_count_str": "46", "like_count": 8010, "like_count_str": "8010", "media_count": 79, "media_count_str": "79" }, "is_identity_verified": true, "description": "X Developer Platform • prev @google, @coinbase\n\n@X @XDevelopers", "verified_type": "blue", "entities": { "url": { "urls": [ { "start": 0, "start_str": "0", "end": 23, "end_str": "23", "url": "https://t.co/7SzJl0jTOo", "expanded_url": "https://developer.x.com", "display_url": "developer.x.com" } ] }, "description": { "mentions": [ { "start": 28, "start_str": "28", "end": 35, "end_str": "35", "username": "google" }, { "start": 37, "start_str": "37", "end": 46, "end_str": "46", "username": "coinbase" }, { "start": 48, "start_str": "48", "end": 50, "end_str": "50", "username": "X" }, { "start": 51, "start_str": "51", "end": 63, "end_str": "63", "username": "XDevelopers" } ] } }, "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1784928028", "username": "taycaldwell", "id": "1716450569358098432" } }, "broadcast_id": "1qxvvvyLLdnxB", "event_type": "spaces_start" } } } ``` ### `spaces.end` Disparado quando o usuário filtrado encerra um Space. Mesma estrutura que `spaces.start`, com um `event_type` interno igual a `end`. ```json title="spaces.end" expandable lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "-498317022904955631", "filter": { "user_id": "1716450569358098432" }, "event_type": "spaces.end", "tag": "my spaces end", "payload": { "user": { "data": { "description": "X Developer Platform • prev @google, @coinbase\n\n@X @XDevelopers", "protected": false, "is_identity_verified": true, "affiliation": { "url": "https://twitter.com/X", "badge_url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg", "description": "X" }, "entities": { "url": { "urls": [ { "start": 0, "start_str": "0", "end": 23, "end_str": "23", "url": "https://t.co/7SzJl0jTOo", "expanded_url": "https://developer.x.com", "display_url": "developer.x.com" } ] }, "description": { "mentions": [ { "start": 28, "start_str": "28", "end": 35, "end_str": "35", "username": "google" }, { "start": 37, "start_str": "37", "end": 46, "end_str": "46", "username": "coinbase" }, { "start": 48, "start_str": "48", "end": 50, "end_str": "50", "username": "X" }, { "start": 51, "start_str": "51", "end": 63, "end_str": "63", "username": "XDevelopers" } ] } }, "profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1784928028", "public_metrics": { "followers_count": 5502, "followers_count_str": "5502", "following_count": 651, "following_count_str": "651", "tweet_count": 789, "tweet_count_str": "789", "listed_count": 46, "listed_count_str": "46", "like_count": 8010, "like_count_str": "8010", "media_count": 79, "media_count_str": "79" }, "id": "1716450569358098432", "verified_type": "blue", "profile_image_url": "https://pbs.twimg.com/profile_images/2080765075858825216/iZCZNCsV_normal.jpg", "name": "Taylor Caldwell", "url": "https://t.co/7SzJl0jTOo", "username": "taycaldwell", "location": "San Francisco, CA", "verified": true, "created_at": "2023-10-23T13:44:53.000Z" } }, "broadcast_id": "1qxvvvyLLdnxB", "event_type": "spaces_end" } } } ``` *** ## Eventos de silenciamento Os eventos de silenciamento usam um par de usuários `source` / `target` semelhante aos eventos de seguir. Eventos privados — requerem autenticação no contexto do usuário com o escopo `mute.read`. O filtro `user_id` corresponde ao usuário que **executa** o silenciamento ou o dessilenciamento (não à conta que está sendo silenciada). ### `mute.mute` Disparado quando o usuário filtrado silencia outro usuário. ### `mute.unmute` Disparado quando o usuário filtrado dessilencia outro usuário. *** ## Eventos de bloqueio Os eventos de bloqueio usam um par de usuários `source` / `target` semelhante aos eventos de seguir. Eventos privados — requerem autenticação no contexto do usuário com o escopo `block.read`. O filtro `user_id` corresponde ao usuário que **executa** o bloqueio ou o desbloqueio (não à conta que está sendo bloqueada). ### `block.block` Disparado quando o usuário filtrado bloqueia outro usuário. ### `block.unblock` Disparado quando o usuário filtrado desbloqueia outro usuário. *** ## Eventos de OAuth ### `oauth.revoke` Disparado quando um usuário revoga o acesso da sua aplicação. O `filter` pode estar vazio. Use este evento para limpar o estado local do usuário revogado. ```json title="oauth.revoke" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" theme={null} { "data": { "event_uuid": "5934540941047412905", "filter": {}, "event_type": "oauth.revoke", "payload": { "date_time": "2026-07-23T21:44:05+00:00", "user_id": "1830023695835787264", "app_id": "29820954" } } } ``` *** ## Próximos passos Tipos de evento suportados, privacidade e autenticação Crie uma assinatura e receba eventos Conecte-se ao stream HTTP persistente Entregue eventos de atividade à URL do seu webhook