Udostępnij przez

WorkSpan

WorkSpan to platforma współpracy umożliwiająca planowanie, wykonywanie i wspieranie przychodów z partnerami. Zarządzanie programami partnerskimi i inicjatywami partnerskimi w narzędziu WorkSpan oraz bezproblemowe łączenie się z aplikacjami wewnętrznymi i partnerskimi. Możesz zintegrować rozwiązania CRM, Centrum partnerskie, narzędzia do współpracy i narzędzia zwiększające produktywność w narzędziu WorkSpan.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Obsługa interfejsu API WorkSpan
adres URL https://support.workspan.com
Email api-team@workspan.com
Metadane łącznika
Publisher WorkSpan
Witryna internetowa https://www.workspan.com
Kategorie Marketing; Sprzedaż i CRM
Zasady ochrony prywatności https://www.workspan.com/privacy-policy

WorkSpan to platforma współpracy umożliwiająca łączenie się z partnerami i zarządzanie programami partnerskimi. WorkSpan napędza udane programy partnerskie dla niektórych wiodących na świecie firm technologicznych. Połącz popularne i preferowane aplikacje z usługą WorkSpan Ecosystem Cloud, aby wzbogacić wartość szans sprzedaży dzięki możliwościom ekosystemu partnerskiego. Dzięki łącznikowi WorkSpan użytkownicy mogą doładować i przyspieszyć ich ekosystem i ruch partnerski, łącząc się bezproblemowo z wieloma aplikacjami biznesowymi, takimi jak Dynamics 365 CRM i Salesforce CRM. Użytkownicy mogą synchronizować dane w swoich aplikacjach premier CRM za pomocą narzędzia WorkSpan. Użytkownicy mogą również łączyć się z aplikacjami do współpracy i produktywności, takimi jak Microsoft Teams, Slack i OneDrive. Użytkownicy mogą otrzymywać powiadomienia o różnych zdarzeniach związanych z współpracą w narzędziu WorkSpan, takich jak przydzielone zadania, komentarze dotyczące obiektów i wystąpienia związane z członkostwem w obiektach. Łącznik WorkSpan zwiększa produktywność, utrzymuje integralność danych w aplikacjach i dostarcza terminowe dane i wartości użytkownikom aplikacji biznesowych. W związku z tym organizacje korzystające z łącznika będą doświadczać oszczędności kosztów, zwiększenia przychodów, usprawnionych i przyspieszonych procesów sprzedaży oraz ulepszonego raportowania.

Wymagania wstępne

Organizacja musi być zarejestrowaną firmą w usłudze WorkSpan

Jak uzyskać poświadczenia

Użytkownicy powinni być uwierzytelniani w celu korzystania z łącznika. Aplikacja WorkSpan zapewnia dostęp do łącznika i danych w narzędziu WorkSpan dla skonfigurowanych użytkowników aplikacji w narzędziu WorkSpan. Szczegółowe kroki są dostępne pod adresem https://support.workspan.com

Znane problemy i ograniczenia

Brak znanych problemów

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Środowisko: piaskownica lub produkcja ciąg Środowisko piaskownicy lub środowisko produkcyjne Prawda
Identyfikator użytkownika aplikacji ciąg Identyfikator użytkownika aplikacji WorkSpan Prawda
Wpis tajny użytkownika aplikacji securestring Wpis tajny użytkownika aplikacji Prawda
Nazwa hosta aplikacji WorkSpan. Przykład: demo.workspan.com /app.workspan.com ciąg Wprowadź nazwę hosta (bez protokołu https) Przykład: demo.workspan.com /app.workspan.com Prawda
Notatki ciąg Uwagi dotyczące połączenia Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Dodawanie informacji inspekcji do obiektu WorkSpan

Dodawanie informacji inspekcji do obiektu WorkSpanObject
Możliwości ładowania zbiorczego (dane w treści)

Przekaż dane wejściowe jako treść żądania do integracji. Dozwolone formaty są .csv i .json
Możliwości ładowania zbiorczego (załącznik)

Przekaż plik wejściowy do integracji. Dozwolone formaty to .xlsx, .json i .csv
Odczytywanie danych raportu

Odczytywanie danych raportu
Pobieranie identyfikatora zewnętrznego dla identyfikatora WorkSpan

Pobieranie podstawowego unikatowego identyfikatora aplikacji zewnętrznej
Pobieranie listy raportów

Wyświetlanie listy raportów
Pobieranie stanu operacji ładowania zbiorczego

Pobieranie stanu operacji ładowania zbiorczego
Zbiorcze ładowanie danych (dane w treści)

Przekaż dane wejściowe jako treść żądania do integracji. Dozwolone formaty są .csv i .json
Zbiorcze ładowanie danych (załącznik)

Przekaż plik wejściowy do integracji. Dozwolone formaty to .xlsx, .json i .csv
Łączenie identyfikatora zewnętrznego z identyfikatorem workSpan

Aktualizowanie obiektu WorkSpan przy użyciu podstawowego unikatowego identyfikatora aplikacji zewnętrznej

Dodawanie informacji inspekcji do obiektu WorkSpan

Identyfikator operacji:
ObjectAudit

Dodawanie informacji inspekcji do obiektu WorkSpanObject

Parametry

Nazwa Klucz Wymagane Typ Opis
field_name
 field_name True string

Nazwa pola Inspekcja w obszarze WorkSpan.
integration_id
 integration_id string

Identyfikator integracji (długi identyfikator) powiązanej integracji
external_id
 external_id string

Identyfikator z systemu zewnętrznego (na przykład. Identyfikator CRM)
status_code
 status_code True string

Kod reprezentujący stan żądania inspekcji.
komunikat
 message True string

Dodatkowe informacje dotyczące rejestrowania w dzienniku inspekcji
Identyfikator obiektu WorkSpan (długi identyfikator)
 object_id True string

Identyfikator obiektu (długi identyfikator) obiektu WorkSpan, który ma zostać zaktualizowany o stan integracji

Zwraca

Body
audit_response

Możliwości ładowania zbiorczego (dane w treści)

Identyfikator operacji:
BulkloadOpportunity

Przekaż dane wejściowe jako treść żądania do integracji. Dozwolone formaty są .csv i .json

Parametry

Nazwa Klucz Wymagane Typ Opis
Wybieranie pozycji Integracja skonfigurowana w narzędziu WorkSpan
 integration_id True string

Identyfikator integracji międzyoperacyjnej usługi CRM skonfigurowany w narzędziu WorkSpan
Typ zawartości danych. Dozwolone formaty są .csv i .json
 content_type string

Typ zawartości danych. Dozwolone formaty są .csv i .json
ogranicznik kolumn (używany, jeśli content_type to csv)
 column_delimiter string

ogranicznik kolumn (używany, jeśli content_type to csv)
Typ zawartości danych. text/csv lub application/json.
 Content-Type string

Typ zawartości danych. text/csv lub application/json.
dane, które mają zostać przekazane
 bulkload_opportunity_request

Dla typu zawartości "CSV": wiersze danych jako csv. pierwszy wiersz będzie nagłówkami kolumn. W przypadku typu zawartości "JSON" format danych to tablica: [ { key1 : value, key2 : value}, { key1 : value, key2 : value } ]

Zwraca

Body
bulkload_opportunity_response

Możliwości ładowania zbiorczego (załącznik)

Identyfikator operacji:
BulkloadOpportunityFileAttachment

Przekaż plik wejściowy do integracji. Dozwolone formaty to .xlsx, .json i .csv

Parametry

Nazwa Klucz Wymagane Typ Opis
Wybieranie pozycji Integracja skonfigurowana w narzędziu WorkSpan
 integration_id True string

Identyfikator integracji intergacji CRM skonfigurowany w narzędziu WorkSpan
Typ zawartości danych. Dozwolone formaty są .csv .xlsx i .json
 content_type string

Typ zawartości danych. Dozwolone formaty są .csv .xlsx i .json
Czy plik programu Excel ma wiersz nagłówka?
 has_header_row boolean

Czy plik programu Excel ma wiersz nagłówka?
plik do przekazania
 file True file

plik do przekazania

Zwraca

Body
bulkload_opportunity_response

Odczytywanie danych raportu

Identyfikator operacji:
GetReportData

Odczytywanie danych raportu

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator raportu
 reportId True integer

Identyfikator raportu
colId
 colId string
negować
 negate boolean
Op
 op string
typ
 type string
Op
 op string
Liczba
 number True integer
size
 size True integer

Zwraca

Body
ReportDataResponse

Pobieranie identyfikatora zewnętrznego dla identyfikatora WorkSpan

Identyfikator operacji:
GetExternalId

Pobieranie podstawowego unikatowego identyfikatora aplikacji zewnętrznej

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obiektu WorkSpan (identyfikator długi)
 object_id True string

Identyfikator obiektu WorkSpan (identyfikator długi)

Zwraca

Body
get_external_id_response

Pobieranie listy raportów

Identyfikator operacji:
GetReportList

Wyświetlanie listy raportów

Parametry

Nazwa Klucz Wymagane Typ Opis
Liczba
 number integer

Liczba
size
 size integer

size

Zwraca

Nazwa Ścieżka Typ Opis
id
 id string

id
nazwa
 name string

nazwa

Pobieranie stanu operacji ładowania zbiorczego

Identyfikator operacji:
GetBulkloadStatus

Pobieranie stanu operacji ładowania zbiorczego

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator integracji
 integration_id True string

Identyfikator integracji
Identyfikator wykonania (zwrócony krok zbiorczego ładowania bu)
 execution_id True string

Identyfikator wykonywania wykonania integracji, który jest zwracany z zbiorczego interfejsu API
Uwzględnij błędy w odpowiedzi, jeśli występują błędy
 include_errors boolean

Uwzględnij błędy w odpowiedzi, jeśli występują błędy
Maksymalna liczba błędów zwracanych z powrotem w odpowiedzi
 max_errors number

Maksymalna liczba błędów zwracanych z powrotem w odpowiedzi

Zwraca

Body
bulkload_status_response

Zbiorcze ładowanie danych (dane w treści)

Identyfikator operacji:
BulkloadData

Przekaż dane wejściowe jako treść żądania do integracji. Dozwolone formaty są .csv i .json

Parametry

Nazwa Klucz Wymagane Typ Opis
Wybieranie pozycji Integracja skonfigurowana w narzędziu WorkSpan
 integration_id True string

Identyfikator integracji międzyoperacyjnej usługi CRM skonfigurowany w narzędziu WorkSpan
Typ zawartości danych. Dozwolone formaty są .csv i .json
 data_format string

Format danych. Dozwolone formaty to csv i json
ogranicznik kolumn (używany, jeśli content_type to csv)
 column_delimiter string

ogranicznik kolumn (używany, jeśli content_type to csv)
Typ zawartości danych. text/csv lub application/json.
 Content-Type string

Typ zawartości danych. text/csv lub application/json.
dane, które mają zostać przekazane
 bulkload_request

Dla typu zawartości "CSV": wiersze danych jako csv. pierwszy wiersz będzie nagłówkami kolumn. W przypadku typu zawartości "JSON" format danych to tablica: [ { key1 : value, key2 : value}, { key1 : value, key2 : value } ]

Zwraca

Body
bulkload_response

Zbiorcze ładowanie danych (załącznik)

Identyfikator operacji:
BulkloadDataFileAttachment

Przekaż plik wejściowy do integracji. Dozwolone formaty to .xlsx, .json i .csv

Parametry

Nazwa Klucz Wymagane Typ Opis
Wybieranie pozycji Integracja skonfigurowana w narzędziu WorkSpan
 integration_id True string

Identyfikator integracji intergacji CRM skonfigurowany w narzędziu WorkSpan
Formatuj dane. Dozwolone formaty są .csv .xlsx i .json
 data_format string

Formatuj dane. Dozwolone formaty są .csv .xlsx i .json
plik do przekazania
 file True file

plik do przekazania

Zwraca

Body
bulkload_response

Łączenie identyfikatora zewnętrznego z identyfikatorem workSpan

Identyfikator operacji:
UpdateExternalId

Aktualizowanie obiektu WorkSpan przy użyciu podstawowego unikatowego identyfikatora aplikacji zewnętrznej

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obiektu WorkSpan (identyfikator długi)
 object_id True string

Identyfikator obiektu WorkSpan (identyfikator długi)
field_name
 field_name string

Nazwa pola identyfikatora zewnętrznego w narzędziu WorkSpan. Jeśli pole jest puste, zostanie użyta domyślna nazwa pola identyfikatora zewnętrznego. Domyślne nazwy pól to: obiekt opportunity: "sales_details.crm_opportunity_id"; Obiekt Accound: "account_info.external_account_id"
external_id
 external_id True string

Identyfikator z systemu zewnętrznego (np. CRM)

Zwraca

Body
external_id_response

Wyzwalacze

Przesyłanie poleceń do Centrum partnerskiego firmy Microsoft z poziomu narzędzia WorkSpan

Ten wyzwalacz jest wyzwalany, gdy użytkownik WorkSpan prosi o przesłanie możliwości do Centrum partnerskiego firmy Microsoft
Subskrybowanie zdarzeń obiektu WorkSpan

Subskrybowanie różnych zdarzeń obiektów, takich jak tworzenie i aktualizowanie szans sprzedaży w celu zwiększenia widoczności wpływu partnera
Subskrybowanie zdarzeń współpracy workSpan

Zasubskrybuj różne zdarzenia współpracy, takie jak tworzenie i aktualizowanie członkostwa, zadań i komentarzy w celu kierowania i ulepszania komunikacji z siecią wewnętrzną i partnerską.

Przesyłanie poleceń do Centrum partnerskiego firmy Microsoft z poziomu narzędzia WorkSpan

Identyfikator operacji:
SubmitToPartnerCenterObjectEvent

Ten wyzwalacz jest wyzwalany, gdy użytkownik WorkSpan prosi o przesłanie możliwości do Centrum partnerskiego firmy Microsoft

Parametry

Nazwa Klucz Wymagane Typ Opis
nazwa
 name True string

Nazwa subskrybenta zdarzenia
Wybieranie pozycji Integracja skonfigurowana w narzędziu WorkSpan
 integration_id True string

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Subskrybowanie zdarzeń obiektu WorkSpan

Identyfikator operacji:
SubscribeObjectEvent

Subskrybowanie różnych zdarzeń obiektów, takich jak tworzenie i aktualizowanie szans sprzedaży w celu zwiększenia widoczności wpływu partnera

Parametry

Nazwa Klucz Wymagane Typ Opis
Subskrybowanie zdarzeń obiektów
 event True array of string
nazwa
 name True string

Nazwa subskrybenta zdarzenia
Wybieranie pozycji Integracja skonfigurowana w narzędziu WorkSpan
 integration_id True string
object_ids
 object_ids array of string
Przykład filtru: (etap w [ "closed", "won", "lost" ]) AND (sales_details.partner = "P1")
 filters string

Filtry dla zdarzeń

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Subskrybowanie zdarzeń współpracy workSpan

Identyfikator operacji:
Subscribe

Zasubskrybuj różne zdarzenia współpracy, takie jak tworzenie i aktualizowanie członkostwa, zadań i komentarzy w celu kierowania i ulepszania komunikacji z siecią wewnętrzną i partnerską.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa zdarzenia
 event True string
Nazwa subskrybenta
 name True string

Nazwa przypisana do elementu webhook
Identyfikator obiektu WorkSpan
 object_ids array of string

Identyfikatory obiektów, dla których zarejestrowano element webhook
Przykład filtru: (etap w [ "closed", "won", "lost" ]) AND (sales_details.partner = "P1")
 filters string

Filtry dla zdarzeń

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Definicje

bulkload_opportunity_response

Nazwa Ścieżka Typ Opis
integration_id
 integration_id string

Identyfikator integracji
execution_id
 execution_id string

Identyfikator wykonania
utworzono_o
 created_at date-time

Godzina utworzenia

bulkload_response

Nazwa Ścieżka Typ Opis
integration_id
 integration_id string

Identyfikator integracji
execution_id
 execution_id string

Identyfikator wykonania
data_format
 data_format string

Format danych
utworzono_o
 created_at date-time

Godzina utworzenia

bulkload_status_response

Nazwa Ścieżka Typ Opis
integration_id
 integration_id string

Identyfikator integracji
execution_id
 execution_id string

Identyfikator wykonania
stan
 status string

Stan wykonania
succcess_count
 succcess_count number

Liczba rekordów, które zostały pomyślnie przetworzone
error_count
 error_count number

Liczba rekordów z błędami
input_count
 input_count number

Liczba odebranych rekordów
skip_count
 skip_count number

Liczba pominiętych rekordów
started_at
 started_at date-time

Sygnatura czasowa uruchamiania wykonywania
zakończono_o
 completed_at date-time

Sygnatura czasowa kończenia wykonywania
include_errors
 include_errors boolean

Flaga wskazująca, czy błędy zostaną zwrócone w odpowiedzi, jeśli istnieją
Błędy
 errors array of object
komunikat
 errors.message string

Komunikat o błędzie
id
 errors.id string

Identyfikator rekordu, który zakończył się niepowodzeniem
data_row
 errors.data_row string

Wiersz danych, który zakończył się niepowodzeniem

external_id_response

Nazwa Ścieżka Typ Opis
external_id
 external_id string

Identyfikator z systemu zewnętrznego (np. CRM)
object_id
 object_id string

Identyfikator obiektu WorkSpan (długi identyfikator)
field_name
 field_name string

Nazwa pola WorkSpan, w którym jest przechowywana external_id z systemu zewnętrznego

get_external_id_response

Nazwa Ścieżka Typ Opis
object_id
 object_id string

Identyfikator obiektu WorkSpan (identyfikator długi)
external_ids
 external_ids array of object
field_name
 external_ids.field_name string

Nazwa pola WorkSpan, w którym jest przechowywana external_id z systemu zewnętrznego
external_id
 external_ids.external_id string

Identyfikator z systemu zewnętrznego (np. CRM)

audit_response

Nazwa Ścieżka Typ Opis
object_id
 object_id string

Identyfikator obiektu WorkSpan (długi identyfikator), który został zaktualizowany
field_name
 field_name string

Nazwa zaktualizowanego pola WorkSpan
status_code
 status_code string

Stan aktualizacji

ReportDataResponse

Nazwa Ścieżka Typ Opis
endOfList
 endOfList boolean
results
 results array of
wersja
 version integer