WorkSpan
WorkSpan ist eine kollaborative Plattform zum Planen, Ausführen und Steigern des Umsatzes mit Partnern. Verwalten Sie Ihre Partnerprogramme und Partnerinitiativen auf WorkSpan, und verbinden Sie sich nahtlos mit internen und Partneranwendungen. Sie können Ihre CRM-, Partner Center-, Tools für die Zusammenarbeit und Produktivitätstools in WorkSpan integrieren.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | WorkSpan-API-Unterstützung |
| URL | https://support.workspan.com |
| api-team@workspan.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | WorkSpan |
| Webseite | https://www.workspan.com |
| Kategorien | Marketing; Vertrieb und CRM |
| Datenschutzrichtlinie | https://www.workspan.com/privacy-policy |
WorkSpan ist eine kollaborative Plattform für die Verbindung mit Ihren Partnern und die Verwaltung Ihrer Partnerprogramme. WorkSpan unterstützt erfolgreiche Partnerprogramme für einige der weltweit führenden Technologieunternehmen. Verbinden Sie Ihre beliebten und bevorzugten Anwendungen mit der WorkSpan Ecosystem Cloud, um den Wert Ihrer Verkaufschancen mit der Leistungsfähigkeit Ihres Partnerökosystems zu bereichern. Mit dem WorkSpan Connector können Benutzer ihre Ökosystem- und Partnerbewegungen überladen und beschleunigen, indem sie sich nahtlos mit einer Reihe von Geschäftsanwendungen wie Dynamics 365 CRM und Salesforce CRM verbinden. Benutzer können Daten in ihren wichtigsten CRM-Anwendungen mit WorkSpan synchronisieren. Benutzer können auch eine Verbindung mit Zusammenarbeits- und Produktivitätsanwendungen wie Microsoft Teams, Slack und OneDrive herstellen. Benutzer können über die verschiedenen ereignisse im Zusammenhang mit der Zusammenarbeit in WorkSpan benachrichtigt werden, z. B. zugewiesene Aufgaben, Kommentare zu Objekten und mitgliedschaftsbezogene Vorkommen für Objekte. Der WorkSpan-Connector steigert die Produktivität, verwaltet die Datenintegrität in allen Anwendungen und liefert zeitnah Daten und Wert für die Geschäftsanwendungsbenutzer. Daher werden Organisationen, die den Connector verwenden, Kosteneinsparungen, höhere Einnahmen, optimierte und beschleunigte Vertriebsprozesse und verbesserte Berichte erfahren.
Voraussetzungen
Die Organisation muss ein registriertes Unternehmen in WorkSpan sein.
So erhalten Sie Anmeldeinformationen
Benutzer sollten authentifiziert werden, um den Connector zu verwenden. WorkSpan bietet Zugriff auf den Connector und daten in WorkSpan für konfigurierte Anwendungsbenutzer in WorkSpan. Detaillierte Schritte finden Sie unter https://support.workspan.com
Bekannte Probleme und Einschränkungen
Keine bekannten Probleme
Eine Verbindung wird erstellt
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Umgebung: Sandkasten oder Produktion | Schnur | Sandkastenumgebung oder Produktionsumgebung | Richtig |
| Anwendungsbenutzer-ID | Schnur | ID des WorkSpan-Anwendungsbenutzers | Richtig |
| Geheimer Anwendungsbenutzerschlüssel | securestring | Geheimer Anwendungsbenutzerschlüssel | Richtig |
| WorkSpan App Hostname. Beispiel: demo.workspan.com /app.workspan.com | Schnur | Geben Sie den Hostnamen (ohne https) ein: demo.workspan.com/app.workspan.com | Richtig |
| Hinweise | Schnur | Hinweise für die Verbindung | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
|
Abrufen der externen ID für Work |
Abrufen des primären eindeutigen Bezeichners der externen Anwendung |
| Abrufen des Status des Massenladevorgangs |
Abrufen des Status des Massenladevorgangs |
|
Hinzufügen von Überwachungsinformationen zum Work |
Hinzufügen von Überwachungsinformationen zu WorkSpanObject |
| Lesen von Berichtsdaten |
Lesen von Berichtsdaten |
| Liste der Berichte abrufen |
Berichte auflisten |
| Massenladedaten (Anlage) |
Laden Sie eine Eingabedatei in Ihre Integration hoch. Zulässige Formate sind .xlsx, .json und .csv |
| Massenladedaten (Daten im Textkörper) |
Laden Sie Eingabedaten als Anforderungstext in Ihre Integration hoch. Zulässige Formate sind .csv und .json |
| Massenlademöglichkeiten (Anlage) |
Laden Sie eine Eingabedatei in Ihre Integration hoch. Zulässige Formate sind .xlsx, .json und .csv |
| Massenlademöglichkeiten (Daten im Textkörper) |
Laden Sie Eingabedaten als Anforderungstext in Ihre Integration hoch. Zulässige Formate sind .csv und .json |
|
Verbinden einer externen ID mit einer Work |
Aktualisieren des WorkSpan-Objekts mit dem primären eindeutigen Bezeichner der externen Anwendung |
Abrufen der externen ID für WorkSpan-ID
Abrufen des primären eindeutigen Bezeichners der externen Anwendung
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Objekt-ID des WorkSpan-Objekts (lange ID)
|
object_id | True | string |
Objekt-ID des WorkSpan-Objekts (lange ID) |
Gibt zurück
Abrufen des Status des Massenladevorgangs
Abrufen des Status des Massenladevorgangs
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Integrations-ID
|
integration_id | True | string |
Integrations-ID |
|
Ausführungs-ID (zurückgegebener Bu-Massenladeschritt)
|
execution_id | True | string |
Ausführungs-ID einer Integrationsausführung, die von der Massen-API zurückgegeben wird |
|
Fehler in die Antwort einschließen, wenn Fehler vorhanden sind
|
include_errors | boolean |
Fehler in die Antwort einschließen, wenn Fehler vorhanden sind |
|
|
Maximale Anzahl von Fehlern, die in der Antwort zurückgegeben werden sollen
|
max_errors | number |
Maximale Anzahl von Fehlern, die in der Antwort zurückgegeben werden sollen |
Gibt zurück
Hinzufügen von Überwachungsinformationen zum WorkSpan-Objekt
Hinzufügen von Überwachungsinformationen zu WorkSpanObject
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
field_name
|
field_name | True | string |
Feldname des Überwachungsfelds in WorkSpan. |
|
integration_id
|
integration_id | string |
Integrations-ID (lange ID) der zugehörigen Integration |
|
|
external_id
|
external_id | string |
ID aus externem System (Beispiel. CRM-ID) |
|
|
status_code
|
status_code | True | string |
Code, der den Status der Überwachungsanforderung darstellt. |
|
message
|
message | True | string |
Zusätzliche Informationen zur Aufzeichnung im Überwachungsprotokoll |
|
WorkSpan-Objekt-ID (lange ID)
|
object_id | True | string |
Objekt-ID (lange ID) des WorkSpan-Objekts, das mit dem Integrationsstatus aktualisiert werden soll |
Gibt zurück
- Body
- audit_response
Lesen von Berichtsdaten
Lesen von Berichtsdaten
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Berichts-ID
|
reportId | True | integer |
Berichts-ID |
|
colId
|
colId | string | ||
|
negieren
|
negate | boolean | ||
|
op
|
op | string | ||
|
type
|
type | string | ||
|
op
|
op | string | ||
|
number
|
number | True | integer | |
|
size
|
size | True | integer |
Gibt zurück
- Body
- ReportDataResponse
Liste der Berichte abrufen
Berichte auflisten
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
number
|
number | integer |
number |
|
|
size
|
size | integer |
size |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
id
|
id | string |
id |
|
name
|
name | string |
name |
Massenladedaten (Anlage)
Laden Sie eine Eingabedatei in Ihre Integration hoch. Zulässige Formate sind .xlsx, .json und .csv
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Wählen Sie die in WorkSpan konfigurierte Integration aus.
|
integration_id | True | string |
Integrations-ID der CRM-Interoperabilität, die in WorkSpan konfiguriert ist |
|
Formatieren von Daten. Zulässige Formate sind .csv .xlsx und .json
|
data_format | string |
Formatieren von Daten. Zulässige Formate sind .csv .xlsx und .json |
|
|
Datei hochzuladen
|
file | True | file |
Datei hochzuladen |
Gibt zurück
- Body
- bulkload_response
Massenladedaten (Daten im Textkörper)
Laden Sie Eingabedaten als Anforderungstext in Ihre Integration hoch. Zulässige Formate sind .csv und .json
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Wählen Sie die in WorkSpan konfigurierte Integration aus.
|
integration_id | True | string |
Integrations-ID der CRM-Interoperabilität konfiguriert in WorkSpan |
|
Inhaltstyp der Daten. Zulässige Formate sind .csv und .json
|
data_format | string |
Datenformat. Zulässige Formate sind CSV und JSON |
|
|
Spaltentrennzeichen (wird verwendet, wenn content_type csv ist)
|
column_delimiter | string |
Spaltentrennzeichen (wird verwendet, wenn content_type csv ist) |
|
|
Inhaltstyp der Daten. text/csv oder application/json.
|
Content-Type | string |
Inhaltstyp der Daten. text/csv oder application/json. |
|
|
Hochzuladende Daten
|
bulkload_request |
Für den Inhaltstyp 'CSV': Datenzeilen als CSV. Die erste Zeile ist Spaltenüberschriften. Für den Inhaltstyp 'JSON' ist das Datenformat array: [ { key1 : value, key2 : value}, { key1 : value, key2 : value } |
Gibt zurück
- Body
- bulkload_response
Massenlademöglichkeiten (Anlage)
Laden Sie eine Eingabedatei in Ihre Integration hoch. Zulässige Formate sind .xlsx, .json und .csv
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Wählen Sie die in WorkSpan konfigurierte Integration aus.
|
integration_id | True | string |
Integrations-ID der CRM-Interoperabilität, die in WorkSpan konfiguriert ist |
|
Inhaltstyp der Daten. Zulässige Formate sind .csv .xlsx und .json
|
content_type | string |
Inhaltstyp der Daten. Zulässige Formate sind .csv .xlsx und .json |
|
|
Enthält die Excel-Datei Überschriftenzeilen?
|
has_header_row | boolean |
Enthält die Excel-Datei Überschriftenzeilen? |
|
|
Datei hochzuladen
|
file | True | file |
Datei hochzuladen |
Gibt zurück
Massenlademöglichkeiten (Daten im Textkörper)
Laden Sie Eingabedaten als Anforderungstext in Ihre Integration hoch. Zulässige Formate sind .csv und .json
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Wählen Sie die in WorkSpan konfigurierte Integration aus.
|
integration_id | True | string |
Integrations-ID der CRM-Interoperabilität konfiguriert in WorkSpan |
|
Inhaltstyp der Daten. Zulässige Formate sind .csv und .json
|
content_type | string |
Inhaltstyp der Daten. Zulässige Formate sind .csv und .json |
|
|
Spaltentrennzeichen (wird verwendet, wenn content_type csv ist)
|
column_delimiter | string |
Spaltentrennzeichen (wird verwendet, wenn content_type csv ist) |
|
|
Inhaltstyp der Daten. text/csv oder application/json.
|
Content-Type | string |
Inhaltstyp der Daten. text/csv oder application/json. |
|
|
Hochzuladende Daten
|
bulkload_opportunity_request |
Für den Inhaltstyp 'CSV': Datenzeilen als CSV. Die erste Zeile ist Spaltenüberschriften. Für den Inhaltstyp 'JSON' ist das Datenformat array: [ { key1 : value, key2 : value}, { key1 : value, key2 : value } |
Gibt zurück
Verbinden einer externen ID mit einer WorkSpan-ID
Aktualisieren des WorkSpan-Objekts mit dem primären eindeutigen Bezeichner der externen Anwendung
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Objekt-ID des WorkSpan-Objekts (lange ID)
|
object_id | True | string |
Objekt-ID des WorkSpan-Objekts (lange ID) |
|
field_name
|
field_name | string |
Feldname der externen ID in WorkSpan. Wenn leer, wird der Standardfeldname des externen ID-Felds verwendet. Standardfeldnamen sind: Verkaufschancenobjekt: 'sales_details.crm_opportunity_id'; Accound-Objekt: 'account_info.external_account_id' |
|
|
external_id
|
external_id | True | string |
ID aus externem System (z. B. CRM) |
Gibt zurück
- Body
- external_id_response
Auslöser
|
Abonnieren von Work |
Abonnieren Sie verschiedene Ereignisse für die Zusammenarbeit, z. B. Erstellen und Aktualisieren von Mitgliedschaften, Aufgaben und Kommentaren, um die Kommunikation mit Ihrem internen und Partnernetzwerk zu fördern und zu verbessern. |
|
Abonnieren von Work |
Abonnieren Sie verschiedene Objektereignisse, z. B. Erstellungen und Updates zu Verkaufschancen, um die Sichtbarkeit Ihres Partnereinflusses zu erhöhen |
|
Empfehlung an Microsoft Partner Center von Work |
Dieser Trigger wird ausgelöst, wenn der WorkSpan-Benutzer aufgefordert wird, eine Gelegenheit an das Microsoft Partner Center zu senden. |
Abonnieren von WorkSpan Collaboration-Ereignissen
Abonnieren Sie verschiedene Ereignisse für die Zusammenarbeit, z. B. Erstellen und Aktualisieren von Mitgliedschaften, Aufgaben und Kommentaren, um die Kommunikation mit Ihrem internen und Partnernetzwerk zu fördern und zu verbessern.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ereignisname
|
event | True | string | |
|
Abonnentenname
|
name | True | string |
Dem Webhook zugewiesener Name |
|
WorkSpan-Objekt-ID
|
object_ids | array of string |
Objekt-IDs, für die Webhook registriert ist |
|
|
Filterbeispiel: (Phase in [ "closed", "won", "lost" ]) AND (sales_details.partner = "P1")
|
filters | string |
Filter für Ereignisse |
Gibt zurück
Abonnieren von WorkSpan-Objektereignissen
Abonnieren Sie verschiedene Objektereignisse, z. B. Erstellungen und Updates zu Verkaufschancen, um die Sichtbarkeit Ihres Partnereinflusses zu erhöhen
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Abonnieren von Objektereignissen
|
event | True | array of string | |
|
name
|
name | True | string |
Name des Ereignisabonnents |
|
Wählen Sie die in WorkSpan konfigurierte Integration aus.
|
integration_id | True | string | |
|
object_ids
|
object_ids | array of string | ||
|
Filterbeispiel: (Phase in [ "closed", "won", "lost" ]) AND (sales_details.partner = "P1")
|
filters | string |
Filter für Ereignisse |
Gibt zurück
Empfehlung an Microsoft Partner Center von WorkSpan übermitteln
Dieser Trigger wird ausgelöst, wenn der WorkSpan-Benutzer aufgefordert wird, eine Gelegenheit an das Microsoft Partner Center zu senden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
name
|
name | True | string |
Name des Ereignisabonnents |
|
Wählen Sie die in WorkSpan konfigurierte Integration aus.
|
integration_id | True | string |
Gibt zurück
Definitionen
bulkload_opportunity_response
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
integration_id
|
integration_id | string |
Integrations-ID |
|
execution_id
|
execution_id | string |
Ausführungs-ID |
|
erstellt_am
|
created_at | date-time |
Erstellungszeit |
bulkload_response
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
integration_id
|
integration_id | string |
Integrations-ID |
|
execution_id
|
execution_id | string |
Ausführungs-ID |
|
data_format
|
data_format | string |
Datenformat |
|
erstellt_am
|
created_at | date-time |
Erstellungszeit |
bulkload_status_response
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
integration_id
|
integration_id | string |
Integrations-ID |
|
execution_id
|
execution_id | string |
Ausführungs-ID |
|
status
|
status | string |
Status der Ausführung |
|
succcess_count
|
succcess_count | number |
Anzahl der Datensätze, die erfolgreich verarbeitet wurden |
|
error_count
|
error_count | number |
Anzahl von Datensätzen mit Fehlern |
|
input_count
|
input_count | number |
Anzahl der empfangenen Datensätze |
|
skip_count
|
skip_count | number |
Anzahl der übersprungenen Datensätze |
|
started_at
|
started_at | date-time |
Zeitstempel des Startens der Ausführung |
|
abgeschlossen_am
|
completed_at | date-time |
Zeitstempel der Ausführung |
|
include_errors
|
include_errors | boolean |
Flag, das angibt, ob Fehler in der Antwort zurückgegeben werden, falls vorhanden |
|
Irrtümer
|
errors | array of object | |
|
message
|
errors.message | string |
Fehlermeldung |
|
id
|
errors.id | string |
ID des Datensatzes, der fehlgeschlagen ist |
|
data_row
|
errors.data_row | string |
Die Datenzeile, die fehlgeschlagen ist |
external_id_response
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
external_id
|
external_id | string |
ID aus externem System (z. B. CRM) |
|
object_id
|
object_id | string |
WorkSpan-Objekt-ID (lange ID) |
|
field_name
|
field_name | string |
Name des WorkSpan-Felds, in dem die external_id aus einem externen System gespeichert wird |
get_external_id_response
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
object_id
|
object_id | string |
Objekt-ID des WorkSpan-Objekts (lange ID) |
|
external_ids
|
external_ids | array of object | |
|
field_name
|
external_ids.field_name | string |
Name des WorkSpan-Felds, in dem die external_id aus einem externen System gespeichert wird |
|
external_id
|
external_ids.external_id | string |
ID aus externem System (z. B. CRM) |
audit_response
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
object_id
|
object_id | string |
WorkSpan-Objekt-ID (lange ID), die aktualisiert wurde |
|
field_name
|
field_name | string |
Name des WorkSpan-Felds, das aktualisiert wurde |
|
status_code
|
status_code | string |
Aktualisierungsstatus |
ReportDataResponse
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
endOfList
|
endOfList | boolean | |
|
results
|
results | array of | |
|
Ausgabe
|
version | integer |