> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/message-links-explained.md).

# 消息链接详解

<a href="https://pxa.impact.com/student/activity/2359755?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=&#x26;utm_campaign=help-center" class="button primary">参加 PXA 课程</a>

消息链接允许你的客户倡导者向各种社交媒体平台分享预格式化消息。每条消息都包含你预先撰写的文案，并可包含你的倡导者的唯一分享链接。消息链接可包含在：

* 项目组件
* 交易邮件
* 你的应用或网站，作为嵌入式链接或按钮
* 外部电子邮件活动

<details>

<summary>调整消息链接内容</summary>

1. 在左侧导航菜单中，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → 项目规则**.
2. 在 *项目规则* 页面上，选择 **分享** 选项卡。
3. 如果你正在使用 *托管的* Open Graph 源，那么请更新 **标题**, **描述**，以及 **图片** ，这些内容将显示给最终用户。
4. 在 *其他分享媒介* 部分，选择所有你想设置消息的相关分享媒介，并在 *分享正文* 部分。

   <div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F8RQe6UXQs1fTTb7ijE4n%2FScreenshot%202026-05-19%20at%2009.21.21.png?alt=media&amp;token=7078d3ab-d86c-4b02-90fe-5f6fc50f8b15" alt="" width="563"><figcaption></figcaption></figure></div>
5. 选择 **保存分享消息** 以保存你的内容。

现在，你的消息链接可以包含在推荐计划的小组件和交易邮件中，或嵌入到你网站、应用或电子邮件活动中的其他位置。

</details>

<details>

<summary>将消息链接添加到项目触点</summary>

内容编辑器允许你将消息链接添加到你的 [项目组件](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-experiences/customize-program-widgets.md) 和 [交易邮件](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/email-experiences/create-and-customize-advocate-program-emails.md) ，设置几乎无需额外配置——只需要你的项目 ID。若要在其他位置插入消息链接，你可以嵌入一个遵循以下格式的链接。

```programlisting
https://app.referralsaasquatch.com/a/ 
{tenant_alias}/message/redirect/{share_medium}
?engagementMedium={engagement_medium}&accountId= 
{accountId}&userId={userId}&programId=
{program_ID}&rsLandingPage= {rsLandingPage}
```

花括号中的信息 **{ }** 应替换为受支持的参数值之一。

{% hint style="info" %}
**注意：** 该 `accountId` 和 `userId` 这些值必须从你的项目数据中动态填充。如需帮助提取数据，请联系你的开发团队。
{% endhint %}

| 参数                   | 示例                                   | 说明                                                                                                                                                                                                                                                                                                                                                                                        |
| -------------------- | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tenant_alias`       | `test_bpinhag9gag`                   | <p>你的项目的租户别名。要查找你的租户别名：</p><p>1. 从顶部导航栏中，选择 <img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media&amp;token=f84c5b17-fae4-4a30-990a-9de5e57a150b" alt=""> <strong>\[用户资料] → 设置</strong>.</p><p>2. 在左侧，位于 <em>Advocate 设置</em>，选择 <strong>常规</strong>.</p> |
| `share_medium`       | `WHATSAPP`                           | <p>倡导者将通过此媒介分享该推荐。</p><p>支持的值：</p><p>• <code>EMAIL</code></p><p>• <code>FACEBOOK</code></p><p>• <code>FBMESSENGER</code></p><p>• <code>LINEMESSENGER</code></p><p>• <code>LINKEDIN</code></p><p>• <code>PINTEREST</code></p><p>• <code>SMS</code></p><p>• <code>TWITTER</code></p><p>• <code>WHATSAPP</code></p>                                                                          |
| `engagement_medium`  | `EMBED`                              | <p>倡导者与推荐计划互动的媒介（例如嵌入式组件）。</p><p>支持的值：</p><p>• <code>EMAIL</code></p><p>• <code>EMBED</code></p><p>• <code>MOBILE</code></p><p>• <code>POPUP</code></p>                                                                                                                                                                                                                                   |
| `accountId`          | \[基于电子邮件地址的哈希 ID]                    | 正在为其生成此消息链接的账户 ID。对于大多数参与者来说，用户 ID 和账户 ID 字段的值相同。                                                                                                                                                                                                                                                                                                                                         |
| `userId`             | \[基于电子邮件地址的哈希 ID]                    | 正在为其生成此消息链接的用户 ID。对于大多数参与者来说，用户 ID 和账户 ID 字段的值相同。                                                                                                                                                                                                                                                                                                                                         |
| `programId`          | `21789`                              | 你的项目 ID。可在 **项目规则** 项目名称下方的页面上找到。                                                                                                                                                                                                                                                                                                                                                         |
| `rsLandingPage` (可选) | `https://example.com/driver-program` | <p>覆盖项目的落地页，将生成的分享链接重定向到不同的 URL。</p><p>仅支持你项目落地页 URL 上不同的路径。出于安全原因，重定向不能指向不同的域。</p>                                                                                                                                                                                                                                                                                                       |

{% hint style="info" %}
**示例：** 使用上述格式，以下是对于具有用户 ID 和账户 ID 的参与者来说，消息链接 URL 的示例，看起来会像这样 `messageLink` 在 impact.com 演示项目中， `klip-referral-program`。此链接将通过电子邮件提供给参与者，以便其通过移动端链接分享。

```programlisting
https://app.referralsaasquatch.com/a/test_aut32av0b11uc
/message/redirect/EMAIL?engagementMedium=
MOBILE&accountId=messageLink&userId=
messageLink&programId=klip-referral-program
```

{% endhint %}

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/message-links-explained.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.