Skip to main content

概览

Bubble.io 是一个流行的无代码平台,让你无需编写任何代码就可以构建 Web 和移动应用。 通过集成 Ayrshare 的社交媒体 API,你可以直接在 Bubble 应用中管理用户的社交媒体账户。 有两种实现方式:
  • Bubble Ayrshare 插件:这个选项操作简单、配置最少。不过相比 Bubble API Connector, 它的功能相对有限。
  • Bubble API Connector:如果需要更高的灵活性和控制度,可使用 Bubble API Connector。 通过它可以直接调用 Ayrshare 的 API,在你的 Bubble.io 应用中启用更广泛的 功能。
本指南将带你了解这两种集成方式。

快速上手:Bubble.io Ayrshare 插件

Bubble 是最强大的无代码软件开发平台之一。上手最简单的方式就是使用 Ayrshare 的 Bubble.io 插件。有关更进阶的 Bubble 集成方式请参见下文。
首先在 ayrshare.com 创建账号,然后连接你的社交媒体账户。

连接社交账户

账户连接完成后,你可以进入 API Dashboard 并复制你的 API key。
在 Bubble 应用中粘贴 API key 时,请务必在 API key 前加上单词 “Bearer”。例如:Bearer bf55cc6f-76ac-46ce-b497-439d766f6c12
在 Bubble 应用中通过 Bubble 插件市场添加 Ayrshare 插件。在插件的 “API Key” 字段中填入你的 API Key。 现在你就可以通过 Bubble 应用向你的社交媒体账户发帖了。 下图展示了一个 Bubble 中调用该插件、发送带图片帖子的工作流示例。 上方视频对此做了更详细的说明。请确保使用以下参数类型:
  • post:一段格式化为 JSON-safe 的文本
  • platforms:一个文本列表,每个文本用括号括起来,例如 "facebook","instagram"
  • media:一个格式化为 JSON-safe 的 URL 文本
  • date:一个格式化为 JSON-safe 的日期/时间
Ayrshare 插件支持发帖和删除帖子。要发挥 Ayrshare 的全部能力,我们建议使用 Bubble API Connector 插件,并按你应用所需的端点进行配置。

Bubble API Connector 插件

你也可以使用 Bubble API Connector 插件来使用 Ayrshare API 的全部能力。以下视频将带你开始使用 Bubble API Connector 与 Ayrshare 的集成,并演示如何在单条帖子中发布多张图片。
Bubble 的 API Connector 有时颇为讲究,缺少一个结尾引号或空格都可能导致连接失败。 我们建议仔细观看下方视频,如果遇到问题请多回顾几次。
以下是另一段教程视频,演示如何在 Bubble 中获取社交主页分析。

发布到多个社交媒体账户

以下是相关概览文章:

从 Bubble 发布到多个账户

校验 Bubble 的发帖数据

通过 API Connector 从 Bubble 发帖时,很难判断你发送的是否是合法的 JSON。发送到 Ayrshare 的 JSON 不合法时,返回的响应往往是 HTML。 Ayrshare 提供了 /validateJSON 这个 URL,你可以将请求发送到这里,而不是常规的 /post 接口。它会返回 “Valid” 或 “Not Valid”。请务必将 Content-Type 设为 text/plain,而不是常见的 application/json 请点击 “Response Returns as Bad Request” 的故障排查链接查看详情。

故障排查

在 Bubble 中上传媒体文件

使用 Bubble 的 File Uploader 上传你的媒体文件。这些文件将保存在 Amazon S3 上。你会得到一个 URL,可用于 /post 接口的 mediaUrls 请求体参数。

在 Bubble 中生成链接 URL

要在 Bubble 中生成链接 URL,请调用 /profiles/generateJWT 端点。不需要任何 private key:privateKey 已不再使用,因此通常 profileKey 是你唯一需要发送的 body 参数。只有当你的账户拥有多个链接域名时才发送 domain:它仍会被校验,未注册到你账户的域名会被拒绝。 步骤 1: 在你的 Bubble 应用中,按下图所示用 API Connector 创建一个新调用,并在 Body 区域填入你的 profileKey。截图中仍显示旧的参数集:privateKey 会被接受并忽略,但除非 domain 的值是已注册到你账户的域名,否则请删除该字段。 步骤 2: 点击 Initialize call 按钮并保存响应。响应中的 url 字段就是你的用户点击后进入社交媒体账户关联页面的链接。

让用户关联自己的社交账户

如果你使用的是 Launch Plan、Business Plan 或 Enterprise Plan,以下视频展示了如何在 Bubble 中配置,让所有用户都能关联自己的社交账户。

在 Bubble 中用 AI 改写文本并发布到社交平台

介绍如何使用 Ayrshare 和 Bubble.io 构建一个可以改写内容并发帖的应用。该应用接收一段文本,将其以 5 种不同方式改写,然后发布到你的社交账户。

Bubble API Connector

我们建议使用 Bubble API Connector 来发起你的 Ayrshare API 调用。 请注意,Bubble 会对所有 API 调用设置 150 秒的超时时限,超时后会再重试一次。较大的视频可能超过 150 秒,从而导致 Bubble 自动重试,最终报出重复发帖错误。对于较大的视频,我们建议使用定时发帖

有用的 Bubble 博客文章