WorkSpan

WorkSpan è una piattaforma collaborativa per pianificare, eseguire e promuovere i ricavi con i partner. Gestire i programmi partner e le iniziative dei partner in WorkSpan e connettersi senza problemi alle applicazioni interne e partner. È possibile integrare crm, centro per i partner, strumenti di collaborazione e strumenti di produttività in WorkSpan.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio	Class	Regions
Copilot Studio	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Normale	Tutte le aree di App per la logica , ad eccezione delle seguenti:      - Aree di Azure per enti pubblici      - Aree di Azure Cina      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Di alta qualità	Tutte le aree di Power Apps , ad eccezione dei seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	Supporto dell'API WorkSpan
URL	https://support.workspan.com
Email	api-team@workspan.com

Metadati del connettore
Editore	WorkSpan
Sito web	https://www.workspan.com
Categorie	Marketing; Vendite e CRM
Informativa sulla privacy	https://www.workspan.com/privacy-policy

WorkSpan è una piattaforma collaborativa per la connessione con i partner e la gestione dei programmi dei partner. WorkSpan supporta programmi partner di successo per alcune delle principali aziende tecnologiche del mondo. Connettere le applicazioni più diffuse e preferite con WorkSpan Ecosystem Cloud per arricchire il valore delle opportunità di vendita con la potenza dell'ecosistema partner. Con il connettore WorkSpan gli utenti possono aumentare e accelerare il proprio ecosistema e i movimenti di partner connettendosi senza problemi con una serie di applicazioni aziendali, ad esempio Dynamics 365 CRM e Salesforce CRM. Gli utenti possono sincronizzare i dati nelle applicazioni CRM premier con WorkSpan. Gli utenti possono anche connettersi con applicazioni di collaborazione e produttività come Microsoft Teams, Slack e OneDrive. Gli utenti possono ricevere una notifica dei vari eventi correlati alla collaborazione in WorkSpan, ad esempio attività assegnate, commenti su oggetti e occorrenze correlate all'appartenenza sugli oggetti. Il connettore WorkSpan aumenta la produttività, mantiene l'integrità dei dati tra le applicazioni e fornisce dati e valore tempestivi agli utenti dell'applicazione aziendale. Di conseguenza, le organizzazioni che usano il connettore avranno un risparmio sui costi, un aumento dei ricavi, processi di vendita semplificati e accelerati e report avanzati.

Prerequisiti

L'organizzazione deve essere una società registrata in WorkSpan

Come ottenere le credenziali

Gli utenti devono essere autenticati per usare il connettore. WorkSpan consente l'accesso al connettore e ai dati in WorkSpan per gli utenti dell'applicazione configurati in WorkSpan. I passaggi dettagliati sono disponibili all'indirizzo https://support.workspan.com

Problemi noti e limitazioni

Nessun problema noto

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Predefinita	Parametri per la creazione della connessione.	Tutte le aree geografiche	Non condivisibile

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome	TIPO	Description	Obbligatorio
Ambiente: sandbox o produzione	corda	Ambiente sandbox o ambiente di produzione	Vero
ID utente applicazione	corda	ID dell'utente dell'applicazione WorkSpan	Vero
Segreto utente applicazione	securestring	Segreto utente applicazione	Vero
Nome host dell'app WorkSpan. Esempio: demo.workspan.com /app.workspan.com	corda	Immettere il nome host (senza https) Esempio: demo.workspan.com/app.workspan.com	Vero
Note	corda	Note per la connessione	Vero

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	100	60 secondi

Azioni

Aggiungere informazioni di controllo all'oggetto WorkSpan	Aggiungere informazioni di controllo a WorkSpanObject
Caricamento bulk dei dati (allegato)	Caricare un file di input nell'integrazione. I formati consentiti sono .xlsx, .json e .csv
Caricamento bulk dei dati (dati nel corpo)	Caricare i dati di input come corpo della richiesta nell'integrazione. I formati consentiti sono .csv e .json
Connettere un ID esterno a un ID WorkSpan	Aggiornare l'oggetto WorkSpan con l'identificatore univoco primario dell'applicazione esterna
Leggere i dati del report	Leggere i dati del report
Opportunità di caricamento bulk (allegato)	Caricare un file di input nell'integrazione. I formati consentiti sono .xlsx, .json e .csv
Opportunità di caricamento bulk (dati nel corpo)	Caricare i dati di input come corpo della richiesta nell'integrazione. I formati consentiti sono .csv e .json
Ottenere l'elenco dei report	Elencare i report
Ottenere l'ID esterno per l'ID WorkSpan	Ottenere l'identificatore univoco primario dell'applicazione esterna
Ottenere lo stato dell'operazione di bulkload	Ottenere lo stato dell'operazione di caricamento bulk

Aggiungere informazioni di controllo all'oggetto WorkSpan

ID operazione:

ObjectAudit

Aggiungere informazioni di controllo a WorkSpanObject

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
field_name	field_name	True	string	Nome del campo di controllo in WorkSpan.
integration_id	integration_id		string	ID integrazione (ID lungo) dell'integrazione correlata
external_id	external_id		string	ID del sistema esterno (ad esempio. CRM Id)
status_code	status_code	True	string	Codice che rappresenta lo stato della richiesta di controllo.
message	message	True	string	Informazioni aggiuntive per la registrazione nel log di controllo
ID oggetto WorkSpan (ID lungo)	object_id	True	string	ID oggetto (ID lungo) dell'oggetto WorkSpan da aggiornare con lo stato di integrazione

Restituisce

Corpo

audit_response

Caricamento bulk dei dati (allegato)

ID operazione:

BulkloadDataFileAttachment

Caricare un file di input nell'integrazione. I formati consentiti sono .xlsx, .json e .csv

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Selezionare Integrazione configurata in WorkSpan	integration_id	True	string	ID di integrazione dell'intergazione CRM configurato in WorkSpan
Formattare i dati. I formati consentiti sono .csv .xlsx e .json	data_format		string	Formattare i dati. I formati consentiti sono .csv .xlsx e .json
file da caricare	file	True	file	file da caricare

Restituisce

Corpo

bulkload_response

Caricamento bulk dei dati (dati nel corpo)

ID operazione:

BulkloadData

Caricare i dati di input come corpo della richiesta nell'integrazione. I formati consentiti sono .csv e .json

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Selezionare Integrazione configurata in WorkSpan	integration_id	True	string	ID integrazione dell'intergazione CRM configurata in WorkSpan
Tipo di contenuto di dati. I formati consentiti sono .csv e .json	data_format		string	Formato dei dati. I formati consentiti sono csv e json
delimitatore di colonna (usato se content_type è csv)	column_delimiter		string	delimitatore di colonna (usato se content_type è csv)
Tipo di contenuto di dati. text/csv o application/json.	Content-Type		string	Tipo di contenuto di dati. text/csv o application/json.
dati da caricare	bulkload_request			Per il tipo di contenuto 'CSV': righe di dati come csv. la prima riga sarà intestazioni di colonna. Per il tipo di contenuto 'JSON', il formato dati è array: [ { key1 : value, key2 : value}, { key1 : value, key2 : value } ]

Restituisce

Corpo

bulkload_response

Connettere un ID esterno a un ID WorkSpan

ID operazione:

UpdateExternalId

Aggiornare l'oggetto WorkSpan con l'identificatore univoco primario dell'applicazione esterna

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID oggetto dell'oggetto WorkSpan (ID lungo)	object_id	True	string	ID oggetto dell'oggetto WorkSpan (ID lungo)
field_name	field_name		string	Nome del campo dell'ID esterno in WorkSpan. Se vuoto, verrà usato il nome di campo predefinito del campo ID esterno. I nomi dei campi predefiniti sono: oggetto opportunità: 'sales_details.crm_opportunity_id'; Oggetto Accound: 'account_info.external_account_id'
external_id	external_id	True	string	ID del sistema esterno (ad esempio CRM)

Restituisce

Corpo

external_id_response

Leggere i dati del report

ID operazione:

GetReportData

Leggere i dati del report

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Report Id	reportId	True	integer	Report Id
colId	colId		string
negare	negate		boolean
Op	op		string
type	type		string
Op	op		string
numero	number	True	integer
size	size	True	integer

Restituisce

Corpo

ReportDataResponse

Opportunità di caricamento bulk (allegato)

ID operazione:

BulkloadOpportunityFileAttachment

Caricare un file di input nell'integrazione. I formati consentiti sono .xlsx, .json e .csv

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Selezionare Integrazione configurata in WorkSpan	integration_id	True	string	ID di integrazione dell'intergazione CRM configurato in WorkSpan
Tipo di contenuto di dati. I formati consentiti sono .csv .xlsx e .json	content_type		string	Tipo di contenuto di dati. I formati consentiti sono .csv .xlsx e .json
Il file di Excel ha una riga di intestazione?	has_header_row		boolean	Il file di Excel ha una riga di intestazione?
file da caricare	file	True	file	file da caricare

Restituisce

Corpo

bulkload_opportunity_response

Opportunità di caricamento bulk (dati nel corpo)

ID operazione:

BulkloadOpportunity

Caricare i dati di input come corpo della richiesta nell'integrazione. I formati consentiti sono .csv e .json

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Selezionare Integrazione configurata in WorkSpan	integration_id	True	string	ID integrazione dell'intergazione CRM configurata in WorkSpan
Tipo di contenuto di dati. I formati consentiti sono .csv e .json	content_type		string	Tipo di contenuto di dati. I formati consentiti sono .csv e .json
delimitatore di colonna (usato se content_type è csv)	column_delimiter		string	delimitatore di colonna (usato se content_type è csv)
Tipo di contenuto di dati. text/csv o application/json.	Content-Type		string	Tipo di contenuto di dati. text/csv o application/json.
dati da caricare	bulkload_opportunity_request			Per il tipo di contenuto 'CSV': righe di dati come csv. la prima riga sarà intestazioni di colonna. Per il tipo di contenuto 'JSON', il formato dati è array: [ { key1 : value, key2 : value}, { key1 : value, key2 : value } ]

Restituisce

Corpo

bulkload_opportunity_response

Ottenere l'elenco dei report

ID operazione:

GetReportList

Elencare i report

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
numero	number		integer	numero
size	size		integer	size

Restituisce

Nome	Percorso	Tipo	Descrizione
id	id	string	id
nome	name	string	nome

Ottenere l'ID esterno per l'ID WorkSpan

ID operazione:

GetExternalId

Ottenere l'identificatore univoco primario dell'applicazione esterna

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID oggetto dell'oggetto WorkSpan (ID lungo)	object_id	True	string	ID oggetto dell'oggetto WorkSpan (ID lungo)

Restituisce

Corpo

get_external_id_response

Ottenere lo stato dell'operazione di bulkload

ID operazione:

GetBulkloadStatus

Ottenere lo stato dell'operazione di caricamento bulk

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID integrazione	integration_id	True	string	ID integrazione
ID esecuzione (passaggio bu bulkload restituito)	execution_id	True	string	ID esecuzione di un'esecuzione di integrazione restituita dall'API bulk
Includere errori nella risposta in caso di errori	include_errors		boolean	Includere errori nella risposta in caso di errori
Numero massimo di errori da restituire nella risposta	max_errors		number	Numero massimo di errori da restituire nella risposta

Restituisce

Corpo

bulkload_status_response

Trigger

Inviare segnalazioni al Centro per i partner Microsoft da WorkSpan	Questo trigger viene attivato quando l'utente workSpan chiede di inviare l'opportunità al Centro per i partner Microsoft
Sottoscrivere eventi dell'oggetto WorkSpan	Sottoscrivere vari eventi di oggetto, ad esempio crea e aggiorna opportunità per aumentare la visibilità dell'influenza del partner
Sottoscrivere eventi di collaborazione WorkSpan	Sottoscrivere vari eventi di collaborazione, ad esempio creare e aggiornare l'appartenenza, le attività e i commenti per promuovere e migliorare la comunicazione con la rete interna e partner.

Inviare segnalazioni al Centro per i partner Microsoft da WorkSpan

ID operazione:

SubmitToPartnerCenterObjectEvent

Questo trigger viene attivato quando l'utente workSpan chiede di inviare l'opportunità al Centro per i partner Microsoft

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
nome	name	True	string	Nome del sottoscrittore dell'evento
Selezionare Integrazione configurata in WorkSpan	integration_id	True	string

Restituisce

Gli output di questa operazione sono dinamici.

Sottoscrivere eventi dell'oggetto WorkSpan

ID operazione:

SubscribeObjectEvent

Sottoscrivere vari eventi di oggetto, ad esempio crea e aggiorna opportunità per aumentare la visibilità dell'influenza del partner

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Sottoscrivere eventi oggetto	event	True	array of string
nome	name	True	string	Nome del sottoscrittore dell'evento
Selezionare Integrazione configurata in WorkSpan	integration_id	True	string
object_ids	object_ids		array of string
Esempio di filtro: (fase in [ "closed", "won", "lost" ]) AND (sales_details.partner = "P1")	filters		string	Filtri per gli eventi

Restituisce

Gli output di questa operazione sono dinamici.

Sottoscrivere eventi di collaborazione WorkSpan

ID operazione:

Subscribe

Sottoscrivere vari eventi di collaborazione, ad esempio creare e aggiornare l'appartenenza, le attività e i commenti per promuovere e migliorare la comunicazione con la rete interna e partner.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome evento	event	True	string
Nome sottoscrittore	name	True	string	Nome assegnato al webhook
ID oggetto WorkSpan	object_ids		array of string	ID oggetto per cui è registrato il webhook
Esempio di filtro: (fase in [ "closed", "won", "lost" ]) AND (sales_details.partner = "P1")	filters		string	Filtri per gli eventi

Restituisce

Gli output di questa operazione sono dinamici.

Definizioni

bulkload_opportunity_response

Nome	Percorso	Tipo	Descrizione
integration_id	integration_id	string	ID integrazione
execution_id	execution_id	string	ID esecuzione
creato_il	created_at	date-time	Data e ora di creazione

bulkload_response

Nome	Percorso	Tipo	Descrizione
integration_id	integration_id	string	ID integrazione
execution_id	execution_id	string	ID esecuzione
data_format	data_format	string	Formato dati
creato_il	created_at	date-time	Data e ora di creazione

bulkload_status_response

Nome	Percorso	Tipo	Descrizione
integration_id	integration_id	string	ID integrazione
execution_id	execution_id	string	ID esecuzione
status	status	string	Stato dell'esecuzione
succcess_count	succcess_count	number	Numero di record elaborati correttamente
error_count	error_count	number	Numero di record con errori
input_count	input_count	number	Numero di record ricevuti
skip_count	skip_count	number	Numero di record ignorati
started_at	started_at	date-time	Timestamp dell'esecuzione iniziale
completed_at	completed_at	date-time	Timestamp del completamento dell'esecuzione
include_errors	include_errors	boolean	Flag che indica se gli errori verranno restituiti nella risposta, se presenti
errori	errors	array of object
message	errors.message	string	Messaggio di errore
id	errors.id	string	ID del record che non è riuscito
data_row	errors.data_row	string	Riga di dati non riuscita

external_id_response

Nome	Percorso	Tipo	Descrizione
external_id	external_id	string	ID dal sistema esterno (ad esempio CRM)
object_id	object_id	string	ID oggetto WorkSpan (ID lungo)
field_name	field_name	string	Nome del campo WorkSpan in cui è archiviato il external_id da un sistema esterno

get_external_id_response

Nome	Percorso	Tipo	Descrizione
object_id	object_id	string	ID oggetto dell'oggetto WorkSpan (ID lungo)
external_ids	external_ids	array of object
field_name	external_ids.field_name	string	Nome del campo WorkSpan in cui è archiviato il external_id da un sistema esterno
external_id	external_ids.external_id	string	ID dal sistema esterno (ad esempio CRM)

audit_response

Nome	Percorso	Tipo	Descrizione
object_id	object_id	string	ID oggetto WorkSpan (ID lungo) aggiornato
field_name	field_name	string	Nome del campo WorkSpan aggiornato
status_code	status_code	string	Stato aggiornamenti

ReportDataResponse

Nome	Percorso	Tipo	Descrizione
endOfList	endOfList	boolean
results	results	array of
version	version	integer