Automatisch 集成 TwitterOAuth 1.0a 连接配置完全指南【免费下载链接】automatischThe open source Zapier alternative. Build workflow automation without spending time and money.项目地址: https://gitcode.com/GitHub_Trending/au/automatisch本文基于 Automatisch 官方文档packages/docs/pages/apps/twitter/connection.md系统讲解如何在 Automatisch 中完成 Twitter现为 X应用连接的全流程从 Twitter Developer Portal 申请开发者账号、创建 Project 与 App、配置 OAuth 1.0a 用户认证设置到将 API Key 与 API Secret 填入 Automatisch 完成授权。读完本文你将掌握可复现的连接配置步骤并通过源码了解 Automatisch 后端 OAuth 握手、凭据校验与签名请求的底层实现为后续使用发推、搜索等触发器与动作打好基础。一、连接 Twitter 前需要了解的背景Automatisch 是一款开源的工作流自动化平台被广泛视为 Zapier 的开源替代方案。Twitter 是其众多应用集成之一连接建立后即可在流程中触发我的推文新粉丝推文搜索等事件或执行发推搜索用户等动作。从源码看Twitter 应用定义位于 packages/backend/src/apps/twitter/index.jsexport default defineApp({ name: Twitter, key: twitter, iconUrl: {BASE_URL}/apps/twitter/assets/favicon.svg, authDocUrl: {DOCS_URL}/apps/twitter/connection, supportsConnections: true, baseUrl: https://twitter.com, apiBaseUrl: https://api.twitter.com, primaryColor: #1da1f2, beforeRequest: [addAuthHeader], auth, triggers, actions, });几个关键点authDocUrl直接指向本文所基于的连接文档说明该文档就是官方指定的 Twitter 连接配置入口baseUrl与apiBaseUrl分别指向https://twitter.com授权页与https://api.twitter.comAPI 请求supportsConnections: true表示 Twitter 属于需要建立连接connection的应用类型这也是需要完整走一遍 OAuth 流程的原因beforeRequest: [addAuthHeader]表明所有外发请求都会先经过签名中间件自动附加 OAuth 1.0a 的 Authorization 头。二、连接建立的整体流程概览根据文档与源码Twitter 连接采用的是OAuth 1.0a三方授权模式完整链路如下你在 Twitter Developer Portal 创建应用获得API Keyconsumer key与API Key Secretconsumer secret在 Automatisch 的添加连接页面填入上述两把密钥Automatisch 会向你展示OAuth Redirect URL将该 Redirect URL 填入 Twitter 应用的Callback URI / Redirect URL字段Automatisch 调用 Twitter 的/oauth/request_token接口获取临时 token并将浏览器重定向到 Twitter 授权页用户授权后Twitter 携带oauth_verifier回调 Automatisch后端再调用/oauth/access_token换取长期 access token此后所有 API 请求都通过 HMAC-SHA1 签名携带凭据。下面的小节将逐一展开这些步骤的具体操作与背后的源码实现。三、前置条件创建 Twitter 开发者账号与项目在开始连接之前你需要拥有一个 Twitter 账号并完成开发者计划申请。文档中的步骤 1–3 如下打开 Twitter Developer Portal原文档给出的入口完成问卷后点击Lets do this按钮在接下来的页面接受条款与条件点击SubmitTwitter 会发送一封验证邮件点击邮件中的Confirm your email按钮完成邮箱确认。:::warning 常见阻塞点 文档特别提示如果在第 2 步遇到报错There was a problem completing your request. User must have a verified phone number on file prior to submitting application.说明你的 Twitter 账号尚未绑定手机号。需要先前往 Twitter 的 phone settings 页面完成手机号绑定才能继续申请开发者权限。 :::该阻塞点本质上是 Twitter 开发者计划对账号安全等级的强制要求与 Automatisch 无关但却是新账号最容易卡住的环节建议提前确认账号已绑定并验证手机号。四、创建 App 并获取 API Key 与 API Key Secret完成开发者申请后按文档步骤 4–6 创建应用并保存密钥在创建应用的页面中填写App name字段点击Get keys按钮复制页面给出的API Key与API Key Secret两个值并妥善保存后续步骤会用到依次点击Dashboard与Yes, I saved them按钮确认已保存密钥。:::warning 密钥安全 API Key Secret 仅在创建瞬间完整展示一次之后在 Dashboard 中只能重新生成。请务必在点击Yes, I saved them之前将两份密钥复制到安全的位置如密码管理器否则只能重置密钥后重新配置。 :::五、配置 User authentication settingsOAuth 1.0a获取密钥后还需要为应用开启用户认证User authentication这样 Automatisch 才能代表你的账号发起 API 调用。按文档步骤 7–12 操作在 Dashboard 中进入你创建的项目Project点击App settings链接进入应用设置页找到User authentication settings区域点击Set up在下一页启用OAuth 1.0a在OAuth 1.0A Settings区域将 App permissions 选择为Read and write从 Automatisch 的添加连接页面复制OAuth Redirect URL粘贴到 Twitter 的Callback URI / Redirect URL字段填写Website URL后点击Save保存。5.1 Automatisch 的 OAuth Redirect URL 从哪来文档第 11 步要求从 Automatisch 复制 OAuth Redirect URL该 URL 并非随机生成而是由 Twitter 应用的认证字段定义在源码中的。见 packages/backend/src/apps/twitter/auth/index.jsexport default { fields: [ { key: oAuthRedirectUrl, label: OAuth Redirect URL, type: string, required: true, readOnly: true, value: {WEB_APP_URL}/app/twitter/connections/add, description: When asked to input an OAuth callback or redirect URL in Twitter OAuth, enter the URL above., clickToCopy: true, }, { key: consumerKey, label: API Key, type: string, required: true, readOnly: false, value: null, ... }, { key: consumerSecret, label: API Secret, type: string, required: true, readOnly: false, value: null, ... }, ], generateAuthUrl, verifyCredentials, isStillVerified, };要点解读oAuthRedirectUrl字段是readOnly且带有clickToCopy: true即用户无需手动输入、只需一键复制其实际取值为{WEB_APP_URL}占位符展开后的地址默认形态是你的Web地址/app/twitter/connections/addconsumerKey与consumerSecret就是你在 Twitter 开发者门户拿到的API Key与API Key Secret两者均必填required: true——这正好对应文档第 13 步中把它们分别粘贴为 Automatisch 里的API Key和API Secret三个字段依次构成添加连接表单的全部输入项字段定义同时驱动前端表单渲染与后端认证流程。5.2 为什么选择 Read and write 权限文档第 10 步要求选择Read and write而非只读Read only。这与 Twitter 应用的实际能力直接相关从 triggers.md 和 actions.md 可以看到该应用既包含只读型触发器我的推文、新粉丝、搜索推文、用户推文也包含写操作动作Create tweet见 packages/backend/src/apps/twitter/actions/create-tweet/index.js其run通过POST /2/tweets发布推文。若只授予只读权限后续执行发推动作时将因权限不足而失败。因此建议按文档选择Read and write如需更高级能力如发送私信可再评估Read and write and Direct message但文档标准流程以 Read and write 为准。六、在 Automatisch 中完成连接文档步骤 13–14 是收尾操作将第 5 步保存的API Key与API Key Secret分别粘贴到 Automatisch 的API Key与API Secret输入框点击保存后连接建立成功即可在流程中开始使用新的 Twitter 连接。保存时Automatisch 后端会依次执行以下三件关键事情源码可见生成授权 URLgenerate-auth-url.js 使用consumerKey/consumerSecret向https://api.twitter.com/oauth/request_token发起POST请求携带oauth_callback参数并从响应中解析出oauth_token、oauth_token_secret随后把用户浏览器重定向到${baseUrl}/oauth/authorize?oauth_token...即https://twitter.com/oauth/authorize?...让用户确认授权换取访问令牌用户授权后 Twitter 回调并携带oauth_verifierverify-credentials.js 调用/oauth/access_token?oauth_verifier...oauth_token...换取正式的oauth_token与oauth_token_secret同时保存user_id与screen_name到连接凭据中校验连接有效性is-still-verified.js 通过 get-current-user.js 调用当前用户接口若返回用户对象则认为连接仍然有效一旦令牌失效或账号被取消授权连接会被标记为需重新认证。6.1 底层签名机制OAuth 1.0a 请求头整个流程中所有请求包括获取 token 与后续业务 API 调用都由beforeRequest钩子统一签名见 add-auth-header.js。其核心逻辑是用consumerKey/consumerSecret与已保存的accessToken/accessSecret构造 OAuth token基于oauth-1.0a库以HMAC-SHA1算法生成签名见 oauth-client.js内部使用 Node 内置crypto.createHmac(sha1, key)完成 base64 签名将生成的Authorization头注入请求配置从而保证每一次 API 调用都携带合法的 OAuth 1.0a 凭据。这意味着连接建立后你无需在后续每个步骤中重复配置密钥——Automate 的签名层已自动完成凭据管理。七、常见问题排查结合文档与实现以下是连接配置时最可能遇到的几个问题现象原因解决办法开发者申请报错 User must have a verified phone number on file账号未绑定手机号前往 Twitter 手机号设置页完成绑定后再提交文档第 2 步提示回调时报 redirect_uri 不匹配Twitter 应用中的 Callback URI 与 Automatisch 的 OAuth Redirect URL 不一致从 Automatisch 连接页复制完整 URL含末尾/app/twitter/connections/add粘贴注意不要多空格或截断授权后连接仍提示无效API Key/API Secret 填写错误或密钥在开发者门户被重置核对第 5 步保存的密钥如已重置需用新密钥重新创建连接后续动作提示权限不足应用权限未设置为 Read and write回开发者门户将 App permissions 改为 Read and write 并重新走授权流程连接被标记失效用户在 Twitter 端撤销了应用授权或令牌过期在 Automatisch 中删除连接并重新执行上述全部步骤八、连接成功后的下一步触发器与动作连接就绪后Twitter 应用即可直接用于流程编辑器中。从 triggers.md 可见可用触发器包括My tweets当你发布新推文时触发New followers of me当你有新粉丝时触发Search tweets当出现包含特定关键词、短语、用户名或话题标签的新推文时触发User tweets当某个指定用户发布新推文时触发。可用动作见 actions.mdCreate tweet发布一条新推文正文为必填参数对应源码中POST /2/tweets的text字段Search user搜索用户。这些触发器与动作在运行时复用的是同一条连接中的访问凭据由 packages/backend/src/apps/twitter 目录下的triggers/与actions/子目录实现底层均通过统一签名层访问apiBaseUrlhttps://api.twitter.com。九、总结本文完整复现了 Automatisch 官方文档中 Twitter 连接的 14 步配置流程并将其与源码一一对应OAuth Redirect URL 来自认证字段定义、OAuth 1.0a 授权链路由generate-auth-url.js与verify-credentials.js实现、请求签名由add-auth-header.js统一处理、连接有效性由is-still-verified.js持续校验。只要严格按文档顺序操作——申请开发者账号、绑定手机号、创建 App、开启 OAuth 1.0a、配置回调地址、正确填入密钥——即可稳定建立连接并立即开始编排基于 Twitter 的自动化工作流。【免费下载链接】automatischThe open source Zapier alternative. Build workflow automation without spending time and money.项目地址: https://gitcode.com/GitHub_Trending/au/automatisch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Automatisch 集成 TwitterOAuth 1.0a 连接配置完全指南【免费下载链接】automatischThe open source Zapier alternative. Build workflow automation without spending time and money.项目地址: https://gitcode.com/GitHub_Trending/au/automatisch本文基于 Automatisch 官方文档packages/docs/pages/apps/twitter/connection.md系统讲解如何在 Automatisch 中完成 Twitter现为 X应用连接的全流程从 Twitter Developer Portal 申请开发者账号、创建 Project 与 App、配置 OAuth 1.0a 用户认证设置到将 API Key 与 API Secret 填入 Automatisch 完成授权。读完本文你将掌握可复现的连接配置步骤并通过源码了解 Automatisch 后端 OAuth 握手、凭据校验与签名请求的底层实现为后续使用发推、搜索等触发器与动作打好基础。一、连接 Twitter 前需要了解的背景Automatisch 是一款开源的工作流自动化平台被广泛视为 Zapier 的开源替代方案。Twitter 是其众多应用集成之一连接建立后即可在流程中触发我的推文新粉丝推文搜索等事件或执行发推搜索用户等动作。从源码看Twitter 应用定义位于 packages/backend/src/apps/twitter/index.jsexport default defineApp({ name: Twitter, key: twitter, iconUrl: {BASE_URL}/apps/twitter/assets/favicon.svg, authDocUrl: {DOCS_URL}/apps/twitter/connection, supportsConnections: true, baseUrl: https://twitter.com, apiBaseUrl: https://api.twitter.com, primaryColor: #1da1f2, beforeRequest: [addAuthHeader], auth, triggers, actions, });几个关键点authDocUrl直接指向本文所基于的连接文档说明该文档就是官方指定的 Twitter 连接配置入口baseUrl与apiBaseUrl分别指向https://twitter.com授权页与https://api.twitter.comAPI 请求supportsConnections: true表示 Twitter 属于需要建立连接connection的应用类型这也是需要完整走一遍 OAuth 流程的原因beforeRequest: [addAuthHeader]表明所有外发请求都会先经过签名中间件自动附加 OAuth 1.0a 的 Authorization 头。二、连接建立的整体流程概览根据文档与源码Twitter 连接采用的是OAuth 1.0a三方授权模式完整链路如下你在 Twitter Developer Portal 创建应用获得API Keyconsumer key与API Key Secretconsumer secret在 Automatisch 的添加连接页面填入上述两把密钥Automatisch 会向你展示OAuth Redirect URL将该 Redirect URL 填入 Twitter 应用的Callback URI / Redirect URL字段Automatisch 调用 Twitter 的/oauth/request_token接口获取临时 token并将浏览器重定向到 Twitter 授权页用户授权后Twitter 携带oauth_verifier回调 Automatisch后端再调用/oauth/access_token换取长期 access token此后所有 API 请求都通过 HMAC-SHA1 签名携带凭据。下面的小节将逐一展开这些步骤的具体操作与背后的源码实现。三、前置条件创建 Twitter 开发者账号与项目在开始连接之前你需要拥有一个 Twitter 账号并完成开发者计划申请。文档中的步骤 1–3 如下打开 Twitter Developer Portal原文档给出的入口完成问卷后点击Lets do this按钮在接下来的页面接受条款与条件点击SubmitTwitter 会发送一封验证邮件点击邮件中的Confirm your email按钮完成邮箱确认。:::warning 常见阻塞点 文档特别提示如果在第 2 步遇到报错There was a problem completing your request. User must have a verified phone number on file prior to submitting application.说明你的 Twitter 账号尚未绑定手机号。需要先前往 Twitter 的 phone settings 页面完成手机号绑定才能继续申请开发者权限。 :::该阻塞点本质上是 Twitter 开发者计划对账号安全等级的强制要求与 Automatisch 无关但却是新账号最容易卡住的环节建议提前确认账号已绑定并验证手机号。四、创建 App 并获取 API Key 与 API Key Secret完成开发者申请后按文档步骤 4–6 创建应用并保存密钥在创建应用的页面中填写App name字段点击Get keys按钮复制页面给出的API Key与API Key Secret两个值并妥善保存后续步骤会用到依次点击Dashboard与Yes, I saved them按钮确认已保存密钥。:::warning 密钥安全 API Key Secret 仅在创建瞬间完整展示一次之后在 Dashboard 中只能重新生成。请务必在点击Yes, I saved them之前将两份密钥复制到安全的位置如密码管理器否则只能重置密钥后重新配置。 :::五、配置 User authentication settingsOAuth 1.0a获取密钥后还需要为应用开启用户认证User authentication这样 Automatisch 才能代表你的账号发起 API 调用。按文档步骤 7–12 操作在 Dashboard 中进入你创建的项目Project点击App settings链接进入应用设置页找到User authentication settings区域点击Set up在下一页启用OAuth 1.0a在OAuth 1.0A Settings区域将 App permissions 选择为Read and write从 Automatisch 的添加连接页面复制OAuth Redirect URL粘贴到 Twitter 的Callback URI / Redirect URL字段填写Website URL后点击Save保存。5.1 Automatisch 的 OAuth Redirect URL 从哪来文档第 11 步要求从 Automatisch 复制 OAuth Redirect URL该 URL 并非随机生成而是由 Twitter 应用的认证字段定义在源码中的。见 packages/backend/src/apps/twitter/auth/index.jsexport default { fields: [ { key: oAuthRedirectUrl, label: OAuth Redirect URL, type: string, required: true, readOnly: true, value: {WEB_APP_URL}/app/twitter/connections/add, description: When asked to input an OAuth callback or redirect URL in Twitter OAuth, enter the URL above., clickToCopy: true, }, { key: consumerKey, label: API Key, type: string, required: true, readOnly: false, value: null, ... }, { key: consumerSecret, label: API Secret, type: string, required: true, readOnly: false, value: null, ... }, ], generateAuthUrl, verifyCredentials, isStillVerified, };要点解读oAuthRedirectUrl字段是readOnly且带有clickToCopy: true即用户无需手动输入、只需一键复制其实际取值为{WEB_APP_URL}占位符展开后的地址默认形态是你的Web地址/app/twitter/connections/addconsumerKey与consumerSecret就是你在 Twitter 开发者门户拿到的API Key与API Key Secret两者均必填required: true——这正好对应文档第 13 步中把它们分别粘贴为 Automatisch 里的API Key和API Secret三个字段依次构成添加连接表单的全部输入项字段定义同时驱动前端表单渲染与后端认证流程。5.2 为什么选择 Read and write 权限文档第 10 步要求选择Read and write而非只读Read only。这与 Twitter 应用的实际能力直接相关从 triggers.md 和 actions.md 可以看到该应用既包含只读型触发器我的推文、新粉丝、搜索推文、用户推文也包含写操作动作Create tweet见 packages/backend/src/apps/twitter/actions/create-tweet/index.js其run通过POST /2/tweets发布推文。若只授予只读权限后续执行发推动作时将因权限不足而失败。因此建议按文档选择Read and write如需更高级能力如发送私信可再评估Read and write and Direct message但文档标准流程以 Read and write 为准。六、在 Automatisch 中完成连接文档步骤 13–14 是收尾操作将第 5 步保存的API Key与API Key Secret分别粘贴到 Automatisch 的API Key与API Secret输入框点击保存后连接建立成功即可在流程中开始使用新的 Twitter 连接。保存时Automatisch 后端会依次执行以下三件关键事情源码可见生成授权 URLgenerate-auth-url.js 使用consumerKey/consumerSecret向https://api.twitter.com/oauth/request_token发起POST请求携带oauth_callback参数并从响应中解析出oauth_token、oauth_token_secret随后把用户浏览器重定向到${baseUrl}/oauth/authorize?oauth_token...即https://twitter.com/oauth/authorize?...让用户确认授权换取访问令牌用户授权后 Twitter 回调并携带oauth_verifierverify-credentials.js 调用/oauth/access_token?oauth_verifier...oauth_token...换取正式的oauth_token与oauth_token_secret同时保存user_id与screen_name到连接凭据中校验连接有效性is-still-verified.js 通过 get-current-user.js 调用当前用户接口若返回用户对象则认为连接仍然有效一旦令牌失效或账号被取消授权连接会被标记为需重新认证。6.1 底层签名机制OAuth 1.0a 请求头整个流程中所有请求包括获取 token 与后续业务 API 调用都由beforeRequest钩子统一签名见 add-auth-header.js。其核心逻辑是用consumerKey/consumerSecret与已保存的accessToken/accessSecret构造 OAuth token基于oauth-1.0a库以HMAC-SHA1算法生成签名见 oauth-client.js内部使用 Node 内置crypto.createHmac(sha1, key)完成 base64 签名将生成的Authorization头注入请求配置从而保证每一次 API 调用都携带合法的 OAuth 1.0a 凭据。这意味着连接建立后你无需在后续每个步骤中重复配置密钥——Automate 的签名层已自动完成凭据管理。七、常见问题排查结合文档与实现以下是连接配置时最可能遇到的几个问题现象原因解决办法开发者申请报错 User must have a verified phone number on file账号未绑定手机号前往 Twitter 手机号设置页完成绑定后再提交文档第 2 步提示回调时报 redirect_uri 不匹配Twitter 应用中的 Callback URI 与 Automatisch 的 OAuth Redirect URL 不一致从 Automatisch 连接页复制完整 URL含末尾/app/twitter/connections/add粘贴注意不要多空格或截断授权后连接仍提示无效API Key/API Secret 填写错误或密钥在开发者门户被重置核对第 5 步保存的密钥如已重置需用新密钥重新创建连接后续动作提示权限不足应用权限未设置为 Read and write回开发者门户将 App permissions 改为 Read and write 并重新走授权流程连接被标记失效用户在 Twitter 端撤销了应用授权或令牌过期在 Automatisch 中删除连接并重新执行上述全部步骤八、连接成功后的下一步触发器与动作连接就绪后Twitter 应用即可直接用于流程编辑器中。从 triggers.md 可见可用触发器包括My tweets当你发布新推文时触发New followers of me当你有新粉丝时触发Search tweets当出现包含特定关键词、短语、用户名或话题标签的新推文时触发User tweets当某个指定用户发布新推文时触发。可用动作见 actions.mdCreate tweet发布一条新推文正文为必填参数对应源码中POST /2/tweets的text字段Search user搜索用户。这些触发器与动作在运行时复用的是同一条连接中的访问凭据由 packages/backend/src/apps/twitter 目录下的triggers/与actions/子目录实现底层均通过统一签名层访问apiBaseUrlhttps://api.twitter.com。九、总结本文完整复现了 Automatisch 官方文档中 Twitter 连接的 14 步配置流程并将其与源码一一对应OAuth Redirect URL 来自认证字段定义、OAuth 1.0a 授权链路由generate-auth-url.js与verify-credentials.js实现、请求签名由add-auth-header.js统一处理、连接有效性由is-still-verified.js持续校验。只要严格按文档顺序操作——申请开发者账号、绑定手机号、创建 App、开启 OAuth 1.0a、配置回调地址、正确填入密钥——即可稳定建立连接并立即开始编排基于 Twitter 的自动化工作流。【免费下载链接】automatischThe open source Zapier alternative. Build workflow automation without spending time and money.项目地址: https://gitcode.com/GitHub_Trending/au/automatisch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
