Sdílet prostřednictvím

WorkSpan

WorkSpan je platforma pro spolupráci, která umožňuje plánovat, spouštět a řídit výnosy s partnery. Spravujte partnerské programy a partnerské iniciativy v WorkSpanu a bezproblémově se připojujte k interním a partnerským aplikacím. Aplikaci CRM, Partnerské centrum, nástroje pro spolupráci a nástroje pro produktivitu můžete integrovat do aplikace WorkSpan.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Oblasti Azure Government
     – Oblasti Azure China
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Power Automate Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
Název Podpora rozhraní WorkSpan API
URL https://support.workspan.com
Email api-team@workspan.com
Metadata konektoru
Vydavatel WorkSpan
Internetová stránka https://www.workspan.com
Kategorie Marketing; Sales and CRM
Zásady ochrany osobních údajů https://www.workspan.com/privacy-policy

WorkSpan je platforma pro spolupráci pro propojení s partnery a správu partnerských programů. WorkSpan zajišťuje úspěšné partnerské programy pro některé špičkové technologické společnosti na světě. Připojte své oblíbené a upřednostňované aplikace s Cloudem ekosystému WorkSpan k obohacení hodnoty prodejních příležitostí o sílu vašeho partnerského ekosystému. Uživatelé konektoru WorkSpan můžou zvýšit a urychlit jejich ekosystém a partnerské pohyby díky bezproblémovému propojení s řadou obchodních aplikací, jako jsou Dynamics 365 CRM a Salesforce CRM. Uživatelé můžou synchronizovat data ve svých aplikacích PREMIER CRM s aplikací WorkSpan. Uživatelé se také můžou spojit s aplikacemi pro spolupráci a produktivitu, jako jsou Microsoft Teams, Slack a OneDrive. Uživatelé můžou zůstat informováni o různých událostech souvisejících se spolupráci v aplikaci WorkSpan, jako jsou přiřazené úkoly, komentáře k objektům a výskyty související s členstvím v objektech. Konektor WorkSpan zvyšuje produktivitu, udržuje integritu dat napříč aplikacemi a poskytuje včasná data a hodnotu uživatelům obchodních aplikací. V důsledku toho budou organizace používající konektor využívat úspory nákladů, vyšší výnosy, zjednodušené a akcelerované prodejní procesy a vylepšené vykazování.

Požadavky

Organizace musí být registrovaná společnost v WorkSpanu.

Jak získat přihlašovací údaje

Uživatelé by měli být ověřeni pro použití konektoru. WorkSpan poskytuje přístup ke konektoru a datům v aplikaci WorkSpan pro nakonfigurované uživatele aplikací v aplikaci WorkSpan. Podrobné kroky jsou k dispozici na adrese https://support.workspan.com

Známé problémy a omezení

Žádné známé problémy

Vytvoření připojení

Konektor podporuje následující typy ověřování:
výchozí Parametry pro vytvoření připojení Všechny oblasti Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název Typ Description Povinné
Prostředí: Sandbox nebo produkční prostředí řetězec Prostředí sandboxu nebo produkční prostředí Pravdivé
ID uživatele aplikace řetězec Id uživatele aplikace WorkSpan Pravdivé
Tajný kód uživatele aplikace securestring Tajný kód uživatele aplikace Pravdivé
Název hostitele aplikace WorkSpan Příklad: demo.workspan.com /app.workspan.com řetězec Zadejte název hostitele (bez https): demo.workspan.com / app.workspan.com Pravdivé
Poznámky řetězec Poznámky pro připojení Pravdivé

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 100 60 sekund

Akce

Hromadné načtení dat (data v těle)

Nahrajte vstupní data jako text požadavku do vaší integrace. Povolené formáty jsou .csv a .json
Hromadné načtení dat (příloha)

Nahrajte vstupní soubor do integrace. Povolené formáty jsou .xlsx, .json a .csv
Hromadné načítání příležitostí (data v textu)

Nahrajte vstupní data jako text požadavku do vaší integrace. Povolené formáty jsou .csv a .json
Hromadné načítání příležitostí (příloha)

Nahrajte vstupní soubor do integrace. Povolené formáty jsou .xlsx, .json a .csv
Přidání informací o auditu do objektu WorkSpan

Přidání informací o auditu do WorkSpanObject
Připojení externího ID k ID WorkSpan

Aktualizace objektu WorkSpan s primárním jedinečným identifikátorem externí aplikace
Získání externího ID pro WorkSpan ID

Získání primárního jedinečného identifikátoru externí aplikace
Získání seznamu sestav

Výpis sestav
Získání stavu operace hromadného načítání

Získání stavu operace hromadného načítání
Čtení dat sestavy

Čtení dat sestavy

Hromadné načtení dat (data v těle)

ID operace:
BulkloadData

Nahrajte vstupní data jako text požadavku do vaší integrace. Povolené formáty jsou .csv a .json

Parametry

Name Klíč Vyžadováno Typ Description
Výběr možnosti Integrace nakonfigurovaná v aplikaci WorkSpan
 integration_id True string

ID integrace intergace CRM nakonfigurované v WorkSpan
Typ obsahu dat Povolené formáty jsou .csv a .json
 data_format string

Formát dat Povolené formáty jsou csv a json.
oddělovač sloupců (používá se, pokud je content_type csv)
 column_delimiter string

oddělovač sloupců (používá se, pokud je content_type csv)
Typ obsahu dat text/csv nebo application/json.
 Content-Type string

Typ obsahu dat text/csv nebo application/json.
nahrání dat
 bulkload_request

Pro typ obsahu CSV: Řádky dat jako csv. první řádek bude záhlaví sloupců. Pro typ obsahu JSON je datový formát pole: [ { key1 : value, key2 : value}, { key1 : value}, { key1 : value, key2 : value } ]

Návraty

Body
bulkload_response

Hromadné načtení dat (příloha)

ID operace:
BulkloadDataFileAttachment

Nahrajte vstupní soubor do integrace. Povolené formáty jsou .xlsx, .json a .csv

Parametry

Name Klíč Vyžadováno Typ Description
Výběr možnosti Integrace nakonfigurovaná v aplikaci WorkSpan
 integration_id True string

ID integrace intergace CRM, která je nakonfigurovaná v WorkSpanu
Formátování dat Povolené formáty jsou .csv .xlsx a .json
 data_format string

Formátování dat Povolené formáty jsou .csv .xlsx a .json
soubor k nahrání
 file True file

soubor k nahrání

Návraty

Body
bulkload_response

Hromadné načítání příležitostí (data v textu)

ID operace:
BulkloadOpportunity

Nahrajte vstupní data jako text požadavku do vaší integrace. Povolené formáty jsou .csv a .json

Parametry

Name Klíč Vyžadováno Typ Description
Výběr možnosti Integrace nakonfigurovaná v aplikaci WorkSpan
 integration_id True string

ID integrace intergace CRM nakonfigurované v WorkSpan
Typ obsahu dat Povolené formáty jsou .csv a .json
 content_type string

Typ obsahu dat Povolené formáty jsou .csv a .json
oddělovač sloupců (používá se, pokud je content_type csv)
 column_delimiter string

oddělovač sloupců (používá se, pokud je content_type csv)
Typ obsahu dat text/csv nebo application/json.
 Content-Type string

Typ obsahu dat text/csv nebo application/json.
nahrání dat
 bulkload_opportunity_request

Pro typ obsahu CSV: Řádky dat jako csv. první řádek bude záhlaví sloupců. Pro typ obsahu JSON je datový formát pole: [ { key1 : value, key2 : value}, { key1 : value}, { key1 : value, key2 : value } ]

Návraty

Body
bulkload_opportunity_response

Hromadné načítání příležitostí (příloha)

ID operace:
BulkloadOpportunityFileAttachment

Nahrajte vstupní soubor do integrace. Povolené formáty jsou .xlsx, .json a .csv

Parametry

Name Klíč Vyžadováno Typ Description
Výběr možnosti Integrace nakonfigurovaná v aplikaci WorkSpan
 integration_id True string

ID integrace intergace CRM, která je nakonfigurovaná v WorkSpanu
Typ obsahu dat Povolené formáty jsou .csv .xlsx a .json
 content_type string

Typ obsahu dat Povolené formáty jsou .csv .xlsx a .json
Obsahuje excelový soubor řádek záhlaví?
 has_header_row boolean

Obsahuje excelový soubor řádek záhlaví?
soubor k nahrání
 file True file

soubor k nahrání

Návraty

Body
bulkload_opportunity_response

Přidání informací o auditu do objektu WorkSpan

ID operace:
ObjectAudit

Přidání informací o auditu do WorkSpanObject

Parametry

Name Klíč Vyžadováno Typ Description
field_name
 field_name True string

Název pole auditování v workSpanu
integration_id
 integration_id string

ID integrace (dlouhé ID) související integrace
external_id
 external_id string

ID z externího systému (příklad. CRM Id)
status_code
 status_code True string

Kód představující stav žádosti o audit
zpráva
 message True string

Další informace pro záznam v protokolu auditu
ID objektu WorkSpan (dlouhé ID)
 object_id True string

ID objektu (dlouhé ID) objektu WorkSpan, které se má aktualizovat stavem integrace

Návraty

Body
audit_response

Připojení externího ID k ID WorkSpan

ID operace:
UpdateExternalId

Aktualizace objektu WorkSpan s primárním jedinečným identifikátorem externí aplikace

Parametry

Name Klíč Vyžadováno Typ Description
ID objektu WorkSpan (dlouhé ID)
 object_id True string

ID objektu WorkSpan (dlouhé ID)
field_name
 field_name string

Název pole externího ID v workSpanu Pokud je pole prázdné, použije se výchozí název pole externího ID. Výchozí názvy polí jsou: opportunity object: 'sales_details.crm_opportunity_id'; Objekt Accound: 'account_info.external_account_id'
external_id
 external_id True string

ID z externího systému (např. CRM)

Návraty

Body
external_id_response

Získání externího ID pro WorkSpan ID

ID operace:
GetExternalId

Získání primárního jedinečného identifikátoru externí aplikace

Parametry

Name Klíč Vyžadováno Typ Description
ID objektu WorkSpan (dlouhé ID)
 object_id True string

ID objektu WorkSpan (dlouhé ID)

Návraty

Body
get_external_id_response

Získání seznamu sestav

ID operace:
GetReportList

Výpis sestav

Parametry

Name Klíč Vyžadováno Typ Description
číslo
 number integer

číslo
size
 size integer

size

Návraty

Name Cesta Typ Description
identifikační číslo
 id string

identifikační číslo
název
 name string

název

Získání stavu operace hromadného načítání

ID operace:
GetBulkloadStatus

Získání stavu operace hromadného načítání

Parametry

Name Klíč Vyžadováno Typ Description
ID integrace
 integration_id True string

ID integrace
ID spuštění (vrácený krok hromadného načítání bu)
 execution_id True string

ID spuštění integrace, které se vrátí z hromadného rozhraní API
Pokud dojde k nějakým chybám, zahrňte do odpovědi chyby.
 include_errors boolean

Pokud dojde k nějakým chybám, zahrňte do odpovědi chyby.
Maximální počet chyb, které se mají vrátit zpět v odpovědi
 max_errors number

Maximální počet chyb, které se mají vrátit zpět v odpovědi

Návraty

Body
bulkload_status_response

Čtení dat sestavy

ID operace:
GetReportData

Čtení dat sestavy

Parametry

Name Klíč Vyžadováno Typ Description
ID sestavy
 reportId True integer

ID sestavy
colId
 colId string
negovat
 negate boolean
Op
 op string
typ
 type string
Op
 op string
číslo
 number True integer
size
 size True integer

Návraty

Body
ReportDataResponse

Aktivační události

Odeslání doporučení do Partnerského centra Microsoftu z WorkSpan

Tato aktivační událost se aktivuje, když uživatel WorkSpan požádá o odeslání příležitosti do Partnerského centra Microsoftu.
Přihlášení k odběru událostí objektů WorkSpan

Přihlaste se k odběru různých událostí objektů, jako jsou vytváření a aktualizace příležitostí, abyste zvýšili viditelnost vašeho partnera.
Přihlášení k odběru událostí spolupráce WorkSpan

Přihlaste se k odběru různých událostí spolupráce, jako jsou vytváření a aktualizace členství, úkolů a komentářů, které podporují a zlepšují komunikaci s vaší interní a partnerskou sítí.

Odeslání doporučení do Partnerského centra Microsoftu z WorkSpan

ID operace:
SubmitToPartnerCenterObjectEvent

Tato aktivační událost se aktivuje, když uživatel WorkSpan požádá o odeslání příležitosti do Partnerského centra Microsoftu.

Parametry

Name Klíč Vyžadováno Typ Description
název
 name True string

Název odběratele události
Výběr možnosti Integrace nakonfigurovaná v aplikaci WorkSpan
 integration_id True string

Návraty

Výstupy této operace jsou dynamické.

Přihlášení k odběru událostí objektů WorkSpan

ID operace:
SubscribeObjectEvent

Přihlaste se k odběru různých událostí objektů, jako jsou vytváření a aktualizace příležitostí, abyste zvýšili viditelnost vašeho partnera.

Parametry

Name Klíč Vyžadováno Typ Description
Přihlášení k odběru událostí objektů
 event True array of string
název
 name True string

Název odběratele události
Výběr možnosti Integrace nakonfigurovaná v aplikaci WorkSpan
 integration_id True string
object_ids
 object_ids array of string
Příklad filtru: (fáze v [ "uzavřeno", "won", "lost" ]) AND (sales_details.partner = "P1")
 filters string

Filtry pro události

Návraty

Výstupy této operace jsou dynamické.

Přihlášení k odběru událostí spolupráce WorkSpan

ID operace:
Subscribe

Přihlaste se k odběru různých událostí spolupráce, jako jsou vytváření a aktualizace členství, úkolů a komentářů, které podporují a zlepšují komunikaci s vaší interní a partnerskou sítí.

Parametry

Name Klíč Vyžadováno Typ Description
Název události
 event True string
Název odběratele
 name True string

Název přiřazený webhooku
ID objektu WorkSpan
 object_ids array of string

ID objektů, pro které je webhook zaregistrovaný
Příklad filtru: (fáze v [ "uzavřeno", "won", "lost" ]) AND (sales_details.partner = "P1")
 filters string

Filtry pro události

Návraty

Výstupy této operace jsou dynamické.

Definice

bulkload_opportunity_response

Name Cesta Typ Description
integration_id
 integration_id string

ID integrace
execution_id
 execution_id string

ID spuštění
datum_vytvoření
 created_at date-time

Čas vytvoření

bulkload_response

Name Cesta Typ Description
integration_id
 integration_id string

ID integrace
execution_id
 execution_id string

ID spuštění
data_format
 data_format string

Formát dat
datum_vytvoření
 created_at date-time

Čas vytvoření

bulkload_status_response

Name Cesta Typ Description
integration_id
 integration_id string

ID integrace
execution_id
 execution_id string

ID spuštění
stav
 status string

Stav provádění
succcess_count
 succcess_count number

Počet úspěšně zpracovaných záznamů
error_count
 error_count number

Počet záznamů s chybami
input_count
 input_count number

Počet přijatých záznamů
skip_count
 skip_count number

Počet přeskočených záznamů
started_at
 started_at date-time

Časové razítko spuštění
dokončeno v
 completed_at date-time

Časové razítko dokončení provádění
include_errors
 include_errors boolean

Příznak označující, jestli se chyby vrátí v odpovědi, pokud existuje
chyby
 errors array of object
zpráva
 errors.message string

Zpráva o chybě
identifikační číslo
 errors.id string

ID záznamu, který selhal
data_row
 errors.data_row string

Řádek dat, který selhal

external_id_response

Name Cesta Typ Description
external_id
 external_id string

ID z externího systému (např. CRM)
object_id
 object_id string

ID objektu WorkSpan (dlouhé ID)
field_name
 field_name string

Název pole WorkSpan, kde je uložen external_id z externího systému

get_external_id_response

Name Cesta Typ Description
object_id
 object_id string

ID objektu WorkSpan (dlouhé ID)
external_ids
 external_ids array of object
field_name
 external_ids.field_name string

Název pole WorkSpan, kde je uložen external_id z externího systému
external_id
 external_ids.external_id string

ID z externího systému (např. CRM)

audit_response

Name Cesta Typ Description
object_id
 object_id string

ID objektu WorkSpan (dlouhé ID), které se aktualizovalo
field_name
 field_name string

Název pole WorkSpan, které bylo aktualizováno
status_code
 status_code string

Stav aktualizací

ReportDataResponse

Name Cesta Typ Description
endOfList
 endOfList boolean
results
 results array of
verze
 version integer