Blackbaud Raisers Edge NXT 前景
Blackbaud Raiser 的 Edge NXT 是一款全面的基於雲的籌款和捐助者管理軟件解決方案，專為非營利組織和整個社會公益社區構建。 使用潛在客戶聯結器來管理潛在客戶、機會和評等。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Blackbaud 支持 |
| URL | https://www.blackbaud.com/support |
| skyapi@blackbaud.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 布萊克博德公司 |
| 網站 | https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt |
| 隱私策略 | https://www.blackbaud.com/privacy-shield |
| 類別 | 銷售和客戶關係管理;生產力 |
Raiser 的 Edge NXT 是一款全面的基於雲的籌款和捐助者管理軟件解決方案，專為非營利組織和整個社會公益社區構建。
該連接器建立在 Blackbaud 的 SKY API 之上，並提供操作來幫助管理 The Raiser's Edge NXT 中的潛在客戶和相關實體，包括：
- 前景
- 機會
- 評級
- 不勝枚舉...
如需詳細資訊，請檢視 文件。
先決條件
若要使用此連接器，您必須擁有 Blackbaud ID 帳戶，才能存取一或多個 Blackbaud 環境。
此外，您組織的管理員還必須在系統內執行管理員層級動作，才能讓此連接器存取您的 Blackbaud 環境。 有關這些先決條件的詳細資訊，請參閱 初始設定 文件。
如何取得憑證？
您組織的管理員將向您發送組織的 Raiser's Edge NXT 環境的邀請，並在環境中配置您的用戶帳戶權限。 使用此連接器不需要其他認證。
已知問題與限制
連接器將在您的使用者帳戶的內容中運作，因此將受限於您在環境中的使用者權限。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 列出商機附件 |
列出商機的附件。 |
| 列出成分評級 |
傳回選區的評等清單。 |
| 列出機會 |
傳回機會清單。 |
| 列出機會自訂欄位 |
列出機會的自訂欄位。 |
| 取得成份潛在客戶狀態 |
傳回選區的目前潛在客戶狀態。 |
| 建立商機 |
創造新的機會。 |
| 建立成分評等 |
建立新的成分評等。 |
| 建立機會自訂欄位 |
建立新的商機自訂欄位。 |
| 建立機會附件 |
建立新的機會附件。 |
| 更新商機 |
更新商機。 |
| 更新機會自訂欄位 |
更新機會自訂欄位。 |
| 更新機會附件 |
更新機會附件。 |
| 獲得機會 |
傳回商機的相關資訊。 附註：此端點會傳回延遲約為 10 分鐘的狀態屬性。 |
列出商機附件
列出商機的附件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
機會 ID
|
opportunity_id | True | string |
商機的系統記錄識別碼。 |
傳回
Attachments
列出成分評級
傳回選區的評等清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選區 ID
|
constituent_id | True | string |
成分的系統記錄 ID |
|
包括不活躍？
|
include_inactive | boolean |
包括不活躍的評級？ |
|
|
只有最近的？
|
most_recent_only | boolean |
只包含最新的評分？ |
傳回
評級
列出機會
傳回機會清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
清單
|
list_id | string |
定義用於將機會集篩選為指定清單中包含的機會集的清單識別碼。 如果設定此值，則會忽略其他指定的篩選器。 |
|
|
選區 ID
|
constituent_id | string |
代表組成系統記錄 ID 的逗點分隔清單，以過濾結果。 例如，「280,1232」只會傳回成分 280 或成分 1232 的機會。 |
|
|
限制
|
limit | integer |
代表要傳回的記錄數目。 預設值為 500。 最大值為 5000。 |
|
|
Offset
|
offset | integer |
代表要略過的記錄數。 用於分頁。 |
|
|
包括不活躍？
|
include_inactive | boolean |
包括不活躍的機會？ |
|
|
添加日期或之後
|
date_added | date-time |
將結果篩選為在指定日期或之後建立的機會 （例如：「2020-09-18T04：13：56Z」）。 |
|
|
修改日期或之後
|
last_modified | date-time |
將結果篩選為在指定日期或之後修改的機會 （例如：「2020-09-18T04：13：56Z」）。 |
傳回
機會
列出機會自訂欄位
列出機會的自訂欄位。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
機會 ID
|
opportunity_id | True | string |
商機的系統記錄識別碼。 |
傳回
自訂欄位
取得成份潛在客戶狀態
傳回選區的目前潛在客戶狀態。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選區 ID
|
constituent_id | True | string |
要擷取潛在客戶狀態之選件的系統記錄 ID。 |
傳回
潛在客戶狀態
建立商機
創造新的機會。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選區 ID
|
constituent_id | True | string |
與商機相關聯之選件的系統記錄識別碼。 |
|
目標
|
purpose | True | string |
因機會而籌集的任何資金的預期用途。 |
|
名稱
|
name | True | string |
在整個計劃中識別機會的名稱，例如在清單或組成記錄中。 字元限制：255。 |
|
地位
|
status | string |
指出機會在招攬程序中的位置的狀態。 |
|
|
Deadline
|
deadline | date-time |
獲得禮物的機會的目標日期 （例如：「2020-09-18T04：13：56Z」）。 |
|
|
詢問日期
|
ask_date | date-time |
發出招標的日期 （例如：「2020-09-18T04：13：56Z」）。 |
|
|
value
|
value | double |
貨幣價值。 |
|
|
預計日期
|
expected_date | date-time |
潛在客戶預期回應商機的日期 （例如：「2020-09-18T04：13：56Z」）。 |
|
|
value
|
value | double |
貨幣價值。 |
|
|
資助日期
|
funded_date | date-time |
潛在客戶回應商機的日期 （例如：「2020-09-18T04：13：56Z」）。 |
|
|
value
|
value | double |
貨幣價值。 |
|
|
行銷活動ID
|
campaign_id | string |
與商機相關聯之行銷活動的系統記錄 ID。 該活動設定了籌集資金的總體目標。 |
|
|
基金編號
|
fund_id | string |
與商機相關聯之基金的系統記錄識別碼。 該基金指定了禮物的具體財務目的，並確定了該禮物的財務帳戶。 |
|
|
選區 ID
|
constituent_id | string |
與籌款活動相關聯之選民的系統記錄 ID。 |
|
|
value
|
value | double |
貨幣價值。 |
|
|
㥩？
|
inactive | boolean |
商機是否處於非作用中狀態？ |
傳回
創造的機會
建立成分評等
建立新的成分評等。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
代表要建立的評等的物件。 |
傳回
創建成分評級
建立機會自訂欄位
建立新的商機自訂欄位。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
代表要建立的自訂欄位的物件。 |
傳回
建立商機附件
建立機會附件
建立新的機會附件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
機會 ID
|
parent_id | True | string |
與附件相關聯之機會的系統記錄識別碼。 |
|
類型
|
type | True | string |
附件類型。 實體附件是儲存在本機或網路上的上傳檔案，例如影像、PDF 或 Word 文件。 它們在系統中儲存和管理。 連結附件是指向線上或雲端儲存帳戶中的檔案（例如圖像、部落格文章或 YouTube 影片）的連結。 它們在外部儲存和管理。 |
|
名稱
|
name | string |
附件的名稱。 字元限制：150。 |
|
|
Date
|
date | date-time |
附件的日期 （例如：「2020-09-18T04：13：56Z」）。 如果未提供，此欄位預設為目前日期和時間。 |
|
|
URL
|
url | string |
附件的 URL。 這是連結附件所必需的，不適用於實體附件。 |
|
|
檔案名稱
|
file_name | string |
檔案的檔名。 字元限制：36 個。 僅適用於實體附件。 |
|
|
檔案 ID
|
file_id | string |
檔案的識別碼。 字元限制：36 個。 僅適用於實體附件。 |
|
|
縮圖 ID
|
thumbnail_id | string |
縮圖的識別碼。 字元限制：36 個。 僅適用於實體附件。 |
|
|
Tags
|
tags | array of string |
與附件相關聯的標籤。 |
傳回
建立商機附件
更新商機
更新商機。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
機會 ID
|
opportunity_id | True | string |
要更新的機會的系統記錄識別碼。 |
|
目標
|
purpose | string |
因機會而籌集的任何資金的預期用途。 |
|
|
名稱
|
name | string |
在整個計劃中識別機會的名稱，例如在清單或組成記錄中。 字元限制：255。 |
|
|
地位
|
status | string |
指出機會在招攬程序中的位置的狀態。 |
|
|
Deadline
|
deadline | date-time |
獲得禮物的機會的目標日期 （例如：「2020-09-18T04：13：56Z」）。 |
|
|
詢問日期
|
ask_date | date-time |
發出招標的日期 （例如：「2020-09-18T04：13：56Z」）。 |
|
|
value
|
value | double |
貨幣價值。 |
|
|
預計日期
|
expected_date | date-time |
潛在客戶預期回應商機的日期 （例如：「2020-09-18T04：13：56Z」）。 |
|
|
value
|
value | double |
貨幣價值。 |
|
|
資助日期
|
funded_date | date-time |
潛在客戶回應商機的日期 （例如：「2020-09-18T04：13：56Z」）。 |
|
|
value
|
value | double |
貨幣價值。 |
|
|
行銷活動ID
|
campaign_id | string |
與商機相關聯之行銷活動的系統記錄 ID。 該活動設定了籌集資金的總體目標。 |
|
|
基金編號
|
fund_id | string |
與商機相關聯之基金的系統記錄識別碼。 該基金指定了禮物的具體財務目的，並確定了該禮物的財務帳戶。 |
|
|
選區 ID
|
constituent_id | string |
與籌款活動相關聯之選民的系統記錄 ID。 |
|
|
value
|
value | double |
貨幣價值。 |
|
|
㥩？
|
inactive | boolean |
商機是否處於非作用中狀態？ |
更新機會自訂欄位
更新機會自訂欄位。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
自訂欄位ID
|
custom_field_id | True | string |
要更新之自訂欄位的系統記錄 ID。 |
|
body
|
body | True | dynamic |
代表要更新之自訂欄位屬性的物件。 |
更新機會附件
更新機會附件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
附件 ID
|
attachment_id | True | string |
要更新之附件的系統記錄 ID。 |
|
名稱
|
name | string |
附件的名稱。 字元限制：150。 |
|
|
Date
|
date | date-time |
附件的日期 （例如：「2020-09-18T04：13：56Z」）。 |
|
|
URL
|
url | string |
附件的 URL。 這是連結附件所必需的，不適用於實體附件。 |
|
|
Tags
|
tags | array of string |
與附件相關聯的標籤。 |
獲得機會
傳回商機的相關資訊。 附註：此端點會傳回延遲約為 10 分鐘的狀態屬性。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
機會 ID
|
opportunity_id | True | string |
機會取得的系統記錄識別碼。 |
傳回
商機
定義
ConstituentApi.ApiCollectionOfRatingRead
評級
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Count
|
count | integer |
套用任何要求參數之後，可擷取到集合中的項目數目。 limit和offset參數不會影響計數，但為了方便分頁，它們可能會影響值結果集中的項目數。 |
|
value
|
value | array of ConstituentApi.RatingRead |
回應中包含的專案集。 這可能是集合中項目的子集。 |
ConstituentApi.CreatedConstituentRating
創建成分評級
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | string |
新建立的成分評等的識別碼。 |
ConstituentApi.ProspectStatusRead
潛在客戶狀態
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
地位
|
status | string |
該成分股當前的前景狀態。 |
|
經過的天數
|
days_elapsed | integer |
根據開始日期，目前潛在客戶狀態的總天數。 |
|
開始日期
|
start | date-time |
潛在客戶狀態的開始日期。 |
|
評論
|
comments | string |
潛在客戶狀態的註解。 |
ConstituentApi.Rating閱讀
Rating
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | string |
評等的系統記錄識別碼。 |
|
選區 ID
|
constituent_id | string |
與評等相關聯之選件的系統記錄 ID。 |
|
來源
|
source | string |
新評級的來源。 |
|
類別
|
category | string |
評級的類別。 |
|
Date
|
date | date-time |
評等日期。 |
|
Description
|
value |
評級的價值。 |
|
|
評論
|
comment | string |
關於評級的評論。 |
|
㥩？
|
inactive | boolean |
評級是否處於非活動狀態？ |
|
類型
|
type | string |
此計算欄位會指出評等根據類別內容所代表的資料類型。 |
OpportunityApi.ApiCollectionOfOpportunityAttachmentRead
Attachments
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Count
|
count | integer |
套用任何要求參數之後，可擷取到集合中的項目數目。 limit和offset參數不會影響計數，但為了方便分頁，它們可能會影響值結果集中的項目數。 |
|
value
|
value | array of OpportunityApi.OpportunityAttachmentRead |
回應中包含的專案集。 這可能是集合中項目的子集。 |
OpportunityApi.ApiCollectionOfOpportunityCustomFieldRead
自訂欄位
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Count
|
count | integer |
套用任何要求參數之後，可擷取到集合中的項目數目。 limit和offset參數不會影響計數，但為了方便分頁，它們可能會影響值結果集中的項目數。 |
|
value
|
value | array of OpportunityApi.OpportunityCustomFieldRead |
回應中包含的專案集。 這可能是集合中項目的子集。 |
OpportunityApi.ApiCollectionOfOpportunityRead
機會
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Count
|
count | integer |
套用任何要求參數之後，可擷取到集合中的項目數目。 limit和offset參數不會影響計數，但為了方便分頁，它們可能會影響值結果集中的項目數。 |
|
value
|
value | array of OpportunityApi.OpportunityRead |
回應中包含的專案集。 這可能是集合中項目的子集。 |
OpportunityApi.CreatedOpportunity
創造的機會
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | string |
新建立機會的識別碼。 |
OpportunityApi.CreatedOpportunityAttachment
建立商機附件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | string |
新建立的機會附件的 ID。 |
OpportunityApi.CreatedOpportunityCustomField
建立商機附件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | string |
新建立的機會附件的 ID。 |
OpportunityApi.籌款活動
籌款活動
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
選區 ID
|
constituent_id | string |
與籌款活動相關聯之選民的系統記錄 ID。 |
|
value
|
credit_amount.value | double |
貨幣價值。 |
OpportunityApi.OpportunityAttachmentRead
Attachment
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | string |
附件的系統記錄 ID。 |
|
機會 ID
|
parent_id | string |
與附件相關聯之機會的系統記錄識別碼。 |
|
類型
|
type | string |
附件類型。 實體附件是儲存在本機或網路上的上傳檔案，例如影像、PDF 或 Word 文件。 它們在系統中儲存和管理。 連結附件是指向線上或雲端儲存帳戶中的檔案（例如圖像、部落格文章或 YouTube 影片）的連結。 它們在外部儲存和管理。 |
|
名稱
|
name | string |
附件的名稱。 字元限制：150。 |
|
Date
|
date | date-time |
附件的日期。 |
|
URL
|
url | string |
附件的 URL。 這是連結附件所必需的，不適用於實體附件。 |
|
檔案名稱
|
file_name | string |
檔案的檔名。 字元限制：36 個。 僅適用於實體附件。 |
|
檔案 ID
|
file_id | string |
檔案的識別碼。 字元限制：36 個。 僅適用於實體附件。 |
|
縮圖 ID
|
thumbnail_id | string |
縮圖的識別碼。 字元限制：36 個。 僅適用於實體附件。 |
|
縮圖網址
|
thumbnail_url | string |
縮圖的 URL。 適用於僅影像的實體附件。 包含限制存取時間限制為 60 分鐘的限時簽名。 |
|
內容類型
|
content_type | string |
內容類型。 僅適用於實體附件。 |
|
檔案大小
|
file_size | integer |
檔案大小 （以位元組為單位）。 僅適用於實體附件。 |
|
Tags
|
tags | array of string |
與附件相關聯的標籤。 |
OpportunityApi.OpportunityCustomFieldRead
自訂欄位
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | string |
自訂欄位的系統記錄 ID。 |
|
機會 ID
|
parent_id | string |
與自訂欄位相關聯之機會的系統記錄識別碼。 |
|
類別
|
category | string |
自訂欄位類別。 |
|
類型
|
type | string |
自訂欄位所代表的資料類型。 |
|
價值觀
|
value |
自訂欄位的值。 |
|
|
文字值
|
text_value | string |
自訂欄位的文字值。 |
|
數字值
|
number_value | integer |
自訂欄位的數值。 |
|
日期值
|
date_value | date |
自訂欄位的日期值。 |
|
貨幣價值
|
currency_value | double |
自訂欄位的貨幣值。 |
|
布林值
|
boolean_value | boolean |
自訂欄位的布林值。 |
|
表格項目值
|
codetableentry_value | string |
自訂欄位的表格項目值。 |
|
成分 ID 值
|
constituentid_value | string |
自訂欄位的組成 ID 值。 |
|
天
|
fuzzydate_value.d | integer |
模糊約會中的一天。 |
|
個月
|
fuzzydate_value.m | integer |
模糊日期中的月份。 |
|
年
|
fuzzydate_value.y | integer |
模糊日期中的年份。 |
|
Date
|
date | date |
自訂欄位上的日期。 |
|
評論
|
comment | string |
自訂欄位上的註解。 字元限制：50。 |
|
新增日期
|
date_added | date-time |
建立自訂欄位的日期。 |
|
修改日期
|
date_modified | date-time |
上次修改自訂欄位的日期。 |
OpportunityApi.OpportunityRead
商機
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | string |
商機的系統記錄識別碼。 |
|
選區 ID
|
constituent_id | string |
與商機相關聯之選件的系統記錄識別碼。 |
|
目標
|
purpose | string |
因機會而籌集的任何資金的預期用途。 |
|
名稱
|
name | string |
在整個計劃中識別機會的名稱，例如在清單或組成記錄中。 字元限制：255。 |
|
地位
|
status | string |
指出機會在招攬程序中的位置的狀態。 |
|
Deadline
|
deadline | date-time |
獲得禮物機會的目標日期。 |
|
詢問日期
|
ask_date | date-time |
進行招標的日期。 |
|
value
|
ask_amount.value | double |
貨幣價值。 |
|
預計日期
|
expected_date | date-time |
潛在客戶預期回應機會的日期。 |
|
value
|
expected_amount.value | double |
貨幣價值。 |
|
資助日期
|
funded_date | date-time |
潛在客戶回應機會的日期。 |
|
value
|
funded_amount.value | double |
貨幣價值。 |
|
行銷活動ID
|
campaign_id | string |
與商機相關聯之行銷活動的系統記錄 ID。 該活動設定了籌集資金的總體目標。 |
|
基金編號
|
fund_id | string |
與商機相關聯之基金的系統記錄識別碼。 該基金指定了禮物的具體財務目的，並確定了該禮物的財務帳戶。 |
|
籌款活動
|
fundraisers | array of OpportunityApi.Fundraiser |
指派給商機之籌款活動的系統記錄 ID 集。 |
|
㥩？
|
inactive | boolean |
商機是否處於非作用中狀態？ |
|
linked_gifts
|
linked_gifts | array of string |
系統會記錄與商機相關的禮物 ID。 |
|
新增日期
|
date_added | date-time |
建立商機的日期。 |
|
修改日期
|
date_modified | date-time |
上次修改商機的日期。 |