通过

X

X，以前称为 Twitter，是一种在线社交网络服务，使用户能够发送和接收短篇帖子。 连接到 X 以管理帖子。 可以执行各种作，例如发送帖子、搜索、查看关注者等。

此连接器在以下产品和区域中可用：

服务 Class 区域
Copilot Studio 标准 除以下各项外的所有 Power Automate 区域 ：
     - 由世纪互联运营的中国云
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 中国区域
     - 美国国防部（DoD）
Power Apps 标准 除以下各项外的所有 Power Apps 区域 ：
     - 由世纪互联运营的中国云
Power Automate 标准 除以下各项外的所有 Power Automate 区域 ：
     - 由世纪互联运营的中国云
联系人​​
Name Microsoft
URL Microsoft LogicApps 支持
Microsoft Power Automate 支持
Microsoft Power Apps 支持
连接器元数据
发布者 Microsoft
Website https://x.com/
隐私策略 https://x.com/privacy

身份验证和自带应用程序

重要

默认共享应用程序（由 Microsoft 维护的 Twitter 客户端应用程序）不再可用。 连接器现在仅支持一种身份验证类型 - 自带应用程序。 从 2023 年 6 月起，它需要付费企业层应用程序。 然而，Twitter 的定价策略可能会继续改变。

使用“自带应用程序”选项，可以使用自己的 Twitter OAuth 客户端应用程序。 这允许你控制权限，并启用对连接器使用的某些限制。

若要将自己的 Twitter OAuth 客户端应用程序与 Twitter 连接器配合使用，需要执行以下步骤：

  1. 使用 Twitter 开发人员页面创建 OAuth 客户端应用程序 （https://developer.twitter.com）
  2. 在 Twitter 连接器中使用应用程序

在 Twitter 中创建 OAuth 客户端应用程序

若要创建自己的 Twitter OAuth 客户端应用程序，需要首先登录 https://developer.twitter.com。 导航到“项目和应用”部分，可在其中管理和创建 Twitter 应用程序。 此过程在 Twitter 的 Twitter 开发人员指南中介绍。 在开发人员页面上创建 Twitter 应用后，需要执行以下步骤才能正确设置：

  • 选择 Twitter 应用
  • 编辑应用权限以启用读取和写入。
  • 编辑身份验证设置
    • 启用第三方身份验证
    • https://global.consent.azure-apim.net/redirect添加回调 URL（注意：如果使用 Fairfax 订阅或 GCC 环境，请查看“Fairfax 和 GCC 回调”部分）
    • 设置“网站 URL”（必填字段，但它的值不会影响流）

Fairfax 和 GCC 回调

如果使用 Fairfax 订阅或 GCC 环境，请为 Twitter 应用的回调 URL 添加以下 URL：

  • 对于 Fairfax：
    • https://logic-apis-usgovvirginia.consent.azure-apihub.us/redirect
    • https://logic-apis-usgovtexas.consent.azure-apihub.us/redirect
    • https://logic-apis-usgovarizona.consent.azure-apihub.us/redirect
  • 对于 GCC：
    • https://power-apis-usgov001-public.consent.azure-apihub.us/redirect

完成后，选择 Twitter 应用并导航到“密钥和令牌”页。 在“使用者密钥”部分中，单击“查看密钥”按钮，获取应用的 API 密钥 和 API 密钥机密 。 现在可以在 Twitter 连接中使用这些值。

在 Twitter 连接器中使用自己的应用程序

创建 Twitter OAuth 客户端应用程序后，可以在创建 Twitter 连接时使用它。

  • 选择“ 自带应用程序”。
  • 从应用程序指定客户端 ID 和客户端机密值。 （使用 Twitter 应用的 API 密钥 和 API 密钥机密 ）

单击“ 登录 ”以登录到 Twitter 帐户。 这将提示你登录到 Twitter 帐户，然后授权访问上面创建的 Twitter 应用。

限制

以下是一些限制和限制：

  1. 每个用户的最大连接数：2
  2. POST作的 API 调用速率限制：每小时 12 个
  3. 其他作的 API 调用速率限制：每小时 600
  4. 触发器轮询的频率：1 小时
  5. 最大图像上传大小：5 MB
  6. 视频上传的最大大小：15 MB
  7. 搜索结果的最大数量：100
  8. 在一个轮询间隔内跟踪的新推文的最大数量：5
  9. 允许的最大“搜索文本”参数值长度为 470

Twitter API 的限制

  1. 搜索 API 会搜索过去 7 天内发布的最近发布的推文采样
  2. 标准搜索 API 侧重于相关性，而不是完整性。 这意味着某些推文和用户可能缺少搜索结果

POST作的其他限制

@user不支持在发布推文时提及。 具体而言，发布推文时，“@”字符将被剥离。

常规限制

Name 价值
每个帐户的连接数 2

正在创建连接

连接器支持以下身份验证类型：
自带应用程序 使用自己的 Twitter 应用登录。 有关详细信息，请参阅此页面上的“身份验证和自带应用程序”部分。 所有区域 不可共享
默认值 [已弃用] 此选项仅适用于没有显式身份验证类型的较旧连接，并且仅用于向后兼容性。 所有区域 不可共享

自带应用程序

身份验证 ID：byoa

适用：所有区域

使用自己的 Twitter 应用登录。 有关详细信息，请参阅此页面上的“身份验证和自带应用程序”部分。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name 类型 Description 必选
使用者密钥 字符串 Twitter 应用程序的使用者密钥 True
使用者机密 securestring Twitter 应用程序的客户端密码 True

默认值 [已弃用]

适用：所有区域

此选项仅适用于没有显式身份验证类型的较旧连接，并且仅用于向后兼容性。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

操作

Retweet

此作将转推推推文。
发布推文

此作发布一条新推文。
搜索推文

此作获取与搜索查询匹配的相关推文列表。
获取主页时间线

此作获取我和我的追随者发布的最新推文和重新推文。
获取以下内容

该作获取给定用户关注的人员列表。
获取关注者

此作获取遵循给定用户的用户的列表。
获取我的以下内容

此作获取我关注的用户列表。
获取我的追随者

此作获取关注我的用户列表。
获取用户

此作获取给定用户的配置文件详细信息，例如用户名、说明、关注者计数等。
获取用户时间线

此作获取给定用户发布的最新推文的列表。

Retweet

操作 ID:
Retweet

此作将转推推推文。

参数

名称 密钥 必需 类型 说明
推文 ID
 tweetId True string

要转推的推文。
剪裁用户
 trimUser boolean

用于指示是否剪裁用户信息的布尔值。

返回

表示推文文章的响应。

Body
TweetResponseModel

发布推文

操作 ID:
Tweet

此作发布一条新推文。

参数

名称 密钥 必需 类型 说明
推文文本
 tweetText string

要发布的文本。
媒体
 body binary

要发布的媒体。

返回

表示推文文章的响应。

Body
TweetResponseModel

搜索推文

操作 ID:
SearchTweet

此作获取与搜索查询匹配的相关推文列表。

参数

名称 密钥 必需 类型 说明
搜索文本
 searchQuery True string

搜索词，如“欢乐时光”，#haiku，来自：@username，爱或恨。
最大结果
 maxResults integer

要返回的最大推文数。
sinceId
 sinceId string

返回指定推文 ID 之后的推文。

返回

response
array of TweetModel

获取主页时间线

操作 ID:
HomeTimeline

此作获取我和我的追随者发布的最新推文和重新推文。

参数

名称 密钥 必需 类型 说明
最大结果
 maxResults integer

要返回的最大推文数。

返回

response
array of TweetModel

获取以下内容

操作 ID:
Following

该作获取给定用户关注的人员列表。

参数

名称 密钥 必需 类型 说明
用户名
 userName True string

用户的 X 句柄。
最大结果
 maxResults integer

要返回的最大用户数。

返回

response
array of UserDetailsModel

获取关注者

操作 ID:
Followers

此作获取遵循给定用户的用户的列表。

参数

名称 密钥 必需 类型 说明
用户名
 userName True string

用户的 X 句柄。
最大结果
 maxResults integer

要返回的最大用户数。

返回

response
array of UserDetailsModel

获取我的以下内容

操作 ID:
MyFollowing

此作获取我关注的用户列表。

参数

名称 密钥 必需 类型 说明
最大结果
 maxResults integer

要返回的最大用户数。

返回

response
array of UserDetailsModel

获取我的追随者

操作 ID:
MyFollowers

此作获取关注我的用户列表。

参数

名称 密钥 必需 类型 说明
最大结果
 maxResults integer

要获取的最大用户数。

返回

response
array of UserDetailsModel

获取用户

操作 ID:
User

此作获取给定用户的配置文件详细信息，例如用户名、说明、关注者计数等。

参数

名称 密钥 必需 类型 说明
用户名
 userName True string

用户的 X 句柄。

返回

表示用户。

Body
UserDetailsModel

获取用户时间线

操作 ID:
UserTimeline

此作获取给定用户发布的最新推文的列表。

参数

名称 密钥 必需 类型 说明
用户名
 userName True string

用户的 X 句柄。
最大结果
 maxResults integer

要返回的最大推文数。

返回

response
array of TweetModel

触发器

发布新推文时

当发布与给定搜索查询匹配的新推文时，此作将触发流。

发布新推文时

操作 ID:
OnNewTweet

当发布与给定搜索查询匹配的新推文时，此作将触发流。

参数

名称 密钥 必需 类型 说明
搜索文本
 searchQuery True string

搜索词，如“欢乐时光”，#haiku，来自：@username，爱或恨。

返回

表示批处理触发器响应的包装对象

Body
TriggerBatchResponse[TweetModel]

定义

TweetModel

表示推文文章。

名称 路径 类型 说明
推文文本
 TweetText string

推文的文本内容
推文 ID
 TweetId string

推文的 ID
创建时间
 CreatedAtIso string

发布推文的时间
Retweet 计数
 RetweetCount integer

推文的重新推文总数
推文作者
 TweetedBy string

发布推文的用户的名称
媒体 URL
 MediaUrls array of string

随推文一起发布的媒体的 URL
推文语言
 TweetLanguageCode string

推文的语言代码
in_reply_to_user_id
 TweetInReplyToUserId string

当前推文答复的推文作者的用户 ID
收藏夹
 Favorited boolean

指示推文是否标记为收藏
用户提及
 UserMentions array of UserMentionsModel

推文中提到的用户列表
OriginalTweet
 OriginalTweet OriginalTweetModel

表示原始推文文章。
用户详细信息
 UserDetails UserDetailsModel

表示用户。

UserMentionsModel

表示推文中提到的用户。

名称 路径 类型 说明
提及的用户 ID
 Id integer

用户的 X ID （句柄）
提及的用户全名
 FullName string

用户的全名
提及的用户名
 UserName string

用户的屏幕名称

OriginalTweetModel

表示原始推文文章。

名称 路径 类型 说明
原始推文文本
 TweetText string

原始检索的推文的文本内容
原始推文 ID
 TweetId string

原始推文的 ID
创建的原始推文
 CreatedAtIso string

发布原始推文的时间
原始推文转推计数
 RetweetCount integer

此原始推文的重新推文总数
原始推文由
 TweetedBy string

发布原始推文的人员的用户名
原始推文媒体 URL
 MediaUrls array of string

随原始推文一起发布的媒体的 URL
原始推文语言
 TweetLanguageCode string

原始推文的语言代码
原始推文in_reply_to_user_id
 TweetInReplyToUserId string

当前原始推文是回复的推文作者的用户 ID
收藏的原始推文
 Favorited boolean

指示原始推文是否标记为收藏
原始推文用户提及
 UserMentions array of OriginalTweetUserMentionsModel

推文中提到的用户列表
用户详细信息
 UserDetails OriginalTweetUserDetailsModel

表示发布原始推文的用户

UserDetailsModel

表示用户。

名称 路径 类型 说明
Name
 FullName string

用户名
位置
 Location string

用户的位置
用户 ID
 Id integer

用户的 X ID （句柄）
用户名
 UserName string

用户的屏幕名称
关注者计数
 FollowersCount integer

关注者数
Description
 Description string

用户说明
状态计数
 StatusesCount integer

用户状态计数
好友计数
 FriendsCount integer

好友数
收藏夹计数
 FavouritesCount integer

用户收藏的推文数
配置文件图像 URL
 ProfileImageUrl string

配置文件图像的 URL

OriginalTweetUserMentionsModel

表示原始推文中提到的用户。

名称 路径 类型 说明
提及用户 ID 的原始推文
 Id integer

用户的 X ID （句柄）
提及用户全名的原始推文
 FullName string

用户的全名
提及用户名的原始推文
 UserName string

用户的屏幕名称

OriginalTweetUserDetailsModel

表示发布原始推文的用户

名称 路径 类型 说明
原始推文用户全名
 FullName string

用户名
原始推文用户位置
 Location string

用户的位置
原始推文用户 ID
 Id integer

用户的 X ID （句柄）
原始推文用户名
 UserName string

用户的屏幕名称
原始推文用户关注者计数
 FollowersCount integer

关注者数
原始推文用户说明
 Description string

用户说明
原始推文用户状态计数
 StatusesCount integer

用户状态计数
原始推文用户好友计数
 FriendsCount integer

好友数
原始推文用户最喜欢的计数
 FavouritesCount integer

用户收藏的推文数
原始推文用户配置文件图像 URL
 ProfileImageUrl string

配置文件图像的 URL

TweetResponseModel

表示推文文章的响应。

名称 路径 类型 说明
推文 ID
 TweetId string

发布的推文的 ID

TriggerBatchResponse[TweetModel]

表示批处理触发器响应的包装对象

名称 路径 类型 说明
value
 value array of TweetModel

响应对象的列表