WorkSpan
WorkSpan est une plateforme collaborative permettant de planifier, d’exécuter et de générer des revenus avec des partenaires. Gérez vos programmes partenaires et initiatives partenaires sur WorkSpan et connectez-vous en toute transparence avec les applications internes et partenaires. Vous pouvez intégrer vos outils CRM, Espace partenaires, Collaboration et Productivité à WorkSpan.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Prise en charge de l’API WorkSpan |
| URL | https://support.workspan.com |
| Messagerie électronique | api-team@workspan.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | WorkSpan |
| Site internet | https://www.workspan.com |
| Catégories | Marketing; Ventes et CRM |
| Politique de confidentialité | https://www.workspan.com/privacy-policy |
WorkSpan est une plateforme collaborative pour la connexion avec vos partenaires et la gestion de vos programmes partenaires. WorkSpan alimente des programmes partenaires réussis pour certaines des principales entreprises technologiques du monde. Connectez vos applications populaires et préférées à WorkSpan Ecosystem Cloud pour enrichir la valeur de vos opportunités de vente avec la puissance de votre écosystème partenaire. Avec les utilisateurs du connecteur WorkSpan, vous pouvez accélérer et accélérer leur écosystème et leurs mouvements de partenariat en vous connectant en toute transparence à un certain nombre d’applications métier telles que Dynamics 365 CRM et Salesforce CRM. Les utilisateurs peuvent synchroniser des données dans leurs applications CRM principales avec WorkSpan. Les utilisateurs peuvent également se connecter avec des applications de collaboration et de productivité telles que Microsoft Teams, Slack et OneDrive. Les utilisateurs peuvent rester informés des différents événements liés à la collaboration dans WorkSpan, tels que les tâches affectées, les commentaires sur les objets et les occurrences associées à l’appartenance sur les objets. Le connecteur WorkSpan améliore la productivité, maintient l’intégrité des données entre les applications et fournit des données et des valeurs en temps opportun aux utilisateurs de l’application métier. Par conséquent, les organisations qui utilisent le connecteur bénéficieront d’économies de coûts, d’augmentation des revenus, de processus de vente simplifiés et accélérés et de rapports améliorés.
Prerequisites
L’organisation doit être une société inscrite sur WorkSpan
Comment obtenir des informations d’identification
Les utilisateurs doivent être authentifiés pour utiliser le connecteur. WorkSpan fournit l’accès au connecteur et aux données dans WorkSpan pour les utilisateurs d’application configurés dans WorkSpan. Des étapes détaillées sont disponibles à l’adresse https://support.workspan.com
Problèmes connus et limitations
Aucun problème connu
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Environnement : bac à sable ou production | ficelle | Environnement de bac à sable ou environnement de production | Vrai |
| ID d’utilisateur de l’application | ficelle | ID de l’utilisateur d’application WorkSpan | Vrai |
| Secret utilisateur de l’application | securestring | Secret utilisateur de l’application | Vrai |
| Nom d’hôte de l’application WorkSpan. Exemple : demo.workspan.com /app.workspan.com | ficelle | Entrer le nom d’hôte (sans https) Exemple : demo.workspan.com / app.workspan.com | Vrai |
| Remarques | ficelle | Remarques relatives à la connexion | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
|
Ajouter des informations d’audit à l’objet Work |
Ajouter des informations d’audit à WorkSpanObject |
| Chargement en bloc de données (données dans le corps) |
Chargez les données d’entrée en tant que corps de requête dans votre intégration. Les formats autorisés sont .csv et .json |
| Charger des données en bloc (pièce jointe) |
Chargez un fichier d’entrée dans votre intégration. Les formats autorisés sont .xlsx, .json et .csv |
|
Connecter un ID externe à un ID Work |
Mettre à jour l’objet WorkSpan avec l’identificateur unique principal de l’application externe |
| Lire les données de rapport |
Lire les données de rapport |
| Obtenir la liste des rapports |
Répertorier les rapports |
| Obtenir l’état de l’opération de chargement en bloc |
Obtenir l’état de l’opération de chargement en bloc |
|
Obtenir un ID externe pour l’ID Work |
Obtenir l’identificateur unique principal de l’application externe |
| Opportunités de chargement en bloc (données dans le corps) |
Chargez les données d’entrée en tant que corps de requête dans votre intégration. Les formats autorisés sont .csv et .json |
| Opportunités de chargement en bloc (pièce jointe) |
Chargez un fichier d’entrée dans votre intégration. Les formats autorisés sont .xlsx, .json et .csv |
Ajouter des informations d’audit à l’objet WorkSpan
Ajouter des informations d’audit à WorkSpanObject
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
field_name
|
field_name | True | string |
Nom du champ Audit dans WorkSpan. |
|
integration_id
|
integration_id | string |
ID d’intégration (ID long) de l’intégration associée |
|
|
external_id
|
external_id | string |
ID du système externe (exemple. ID CRM) |
|
|
status_code
|
status_code | True | string |
Code représentant l’état de la demande d’audit. |
|
Message
|
message | True | string |
Informations supplémentaires pour l’enregistrement dans le journal d’audit |
|
ID d’objet WorkSpan (ID long)
|
object_id | True | string |
ID d’objet (ID long) de l’objet WorkSpan à mettre à jour avec l’état d’intégration |
Retours
- Corps
- audit_response
Chargement en bloc de données (données dans le corps)
Chargez les données d’entrée en tant que corps de requête dans votre intégration. Les formats autorisés sont .csv et .json
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Sélectionner Intégration configurée dans WorkSpan
|
integration_id | True | string |
ID d’intégration de l’interopérabilité CRM configurée dans WorkSpan |
|
Type de contenu de données. Les formats autorisés sont .csv et .json
|
data_format | string |
Format des données. Les formats autorisés sont csv et json |
|
|
délimiteur de colonne (utilisé si content_type est csv)
|
column_delimiter | string |
délimiteur de colonne (utilisé si content_type est csv) |
|
|
Type de contenu de données. text/csv ou application/json.
|
Content-Type | string |
Type de contenu de données. text/csv ou application/json. |
|
|
données à charger
|
bulkload_request |
Pour le type de contenu « CSV » : lignes de données en tant que csv. la première ligne sera les en-têtes de colonne. Pour le type de contenu « JSON », le format de données est tableau : [ { key1 : value, key2 : value}, { key1 : value, key2 : value } ] |
Retours
- Corps
- bulkload_response
Charger des données en bloc (pièce jointe)
Chargez un fichier d’entrée dans votre intégration. Les formats autorisés sont .xlsx, .json et .csv
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Sélectionner Intégration configurée dans WorkSpan
|
integration_id | True | string |
ID d’intégration de l’interopérabilité CRM, configuré dans WorkSpan |
|
Mettre en forme les données. Les formats autorisés sont .csv .xlsx et .json
|
data_format | string |
Mettre en forme les données. Les formats autorisés sont .csv .xlsx et .json |
|
|
fichier à charger
|
file | True | file |
fichier à charger |
Retours
- Corps
- bulkload_response
Connecter un ID externe à un ID WorkSpan
Mettre à jour l’objet WorkSpan avec l’identificateur unique principal de l’application externe
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’objet de l’objet WorkSpan (ID long)
|
object_id | True | string |
ID d’objet de l’objet WorkSpan (ID long) |
|
field_name
|
field_name | string |
Nom de champ de l’ID externe dans WorkSpan. S’il est vide, le nom de champ par défaut du champ ID externe est utilisé. Les noms de champs par défaut sont : objet opportunité : ' sales_details.crm_opportunity_id' ; Objet accound : 'account_info.external_account_id' |
|
|
external_id
|
external_id | True | string |
ID du système externe (ex. CRM) |
Retours
- Corps
- external_id_response
Lire les données de rapport
Lire les données de rapport
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de rapport
|
reportId | True | integer |
ID de rapport |
|
colId
|
colId | string | ||
|
nier
|
negate | boolean | ||
|
op
|
op | string | ||
|
type
|
type | string | ||
|
op
|
op | string | ||
|
nombre
|
number | True | integer | |
|
size
|
size | True | integer |
Retours
- Corps
- ReportDataResponse
Obtenir la liste des rapports
Répertorier les rapports
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
nombre
|
number | integer |
nombre |
|
|
size
|
size | integer |
size |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
pièce d'identité
|
id | string |
pièce d'identité |
|
nom
|
name | string |
nom |
Obtenir l’état de l’opération de chargement en bloc
Obtenir l’état de l’opération de chargement en bloc
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’intégration
|
integration_id | True | string |
ID d’intégration |
|
ID d’exécution (étape de chargement en bloc bu retournée)
|
execution_id | True | string |
ID d’exécution d’une exécution d’intégration retournée par l’API en bloc |
|
Inclure des erreurs dans la réponse s’il y a des erreurs
|
include_errors | boolean |
Inclure des erreurs dans la réponse s’il y a des erreurs |
|
|
Nombre maximal d’erreurs à retourner dans la réponse
|
max_errors | number |
Nombre maximal d’erreurs à retourner dans la réponse |
Retours
- Corps
- bulkload_status_response
Obtenir un ID externe pour l’ID WorkSpan
Obtenir l’identificateur unique principal de l’application externe
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’objet de l’objet WorkSpan (ID long)
|
object_id | True | string |
ID d’objet de l’objet WorkSpan (ID long) |
Retours
- Corps
- get_external_id_response
Opportunités de chargement en bloc (données dans le corps)
Chargez les données d’entrée en tant que corps de requête dans votre intégration. Les formats autorisés sont .csv et .json
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Sélectionner Intégration configurée dans WorkSpan
|
integration_id | True | string |
ID d’intégration de l’interopérabilité CRM configurée dans WorkSpan |
|
Type de contenu de données. Les formats autorisés sont .csv et .json
|
content_type | string |
Type de contenu de données. Les formats autorisés sont .csv et .json |
|
|
délimiteur de colonne (utilisé si content_type est csv)
|
column_delimiter | string |
délimiteur de colonne (utilisé si content_type est csv) |
|
|
Type de contenu de données. text/csv ou application/json.
|
Content-Type | string |
Type de contenu de données. text/csv ou application/json. |
|
|
données à charger
|
bulkload_opportunity_request |
Pour le type de contenu « CSV » : lignes de données en tant que csv. la première ligne sera les en-têtes de colonne. Pour le type de contenu « JSON », le format de données est tableau : [ { key1 : value, key2 : value}, { key1 : value, key2 : value } ] |
Retours
Opportunités de chargement en bloc (pièce jointe)
Chargez un fichier d’entrée dans votre intégration. Les formats autorisés sont .xlsx, .json et .csv
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Sélectionner Intégration configurée dans WorkSpan
|
integration_id | True | string |
ID d’intégration de l’interopérabilité CRM, configuré dans WorkSpan |
|
Type de contenu de données. Les formats autorisés sont .csv .xlsx et .json
|
content_type | string |
Type de contenu de données. Les formats autorisés sont .csv .xlsx et .json |
|
|
Le fichier Excel comporte-t-il une ligne d’en-tête ?
|
has_header_row | boolean |
Le fichier Excel comporte-t-il une ligne d’en-tête ? |
|
|
fichier à charger
|
file | True | file |
fichier à charger |
Retours
Déclencheurs
|
Envoyer une référence à l’Espace partenaires Microsoft à partir de Work |
Ce déclencheur est déclenché lorsque l’utilisateur WorkSpan demande d’envoyer l’opportunité à l’Espace partenaires Microsoft |
|
S’abonner aux événements d’objet Work |
S’abonner à différents événements d’objet tels que des créations et des mises à jour sur les opportunités pour augmenter la visibilité de votre influence partenaire |
|
S’abonner aux événements Work |
Abonnez-vous à différents événements de collaboration, tels que les créations et mises à jour sur l’appartenance, les tâches et les commentaires, pour favoriser et améliorer la communication avec votre réseau interne et partenaire. |
Envoyer une référence à l’Espace partenaires Microsoft à partir de WorkSpan
Ce déclencheur est déclenché lorsque l’utilisateur WorkSpan demande d’envoyer l’opportunité à l’Espace partenaires Microsoft
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
nom
|
name | True | string |
Nom de l’abonné aux événements |
|
Sélectionner Intégration configurée dans WorkSpan
|
integration_id | True | string |
Retours
S’abonner aux événements d’objet WorkSpan
S’abonner à différents événements d’objet tels que des créations et des mises à jour sur les opportunités pour augmenter la visibilité de votre influence partenaire
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
S’abonner aux événements d’objet
|
event | True | array of string | |
|
nom
|
name | True | string |
Nom de l’abonné aux événements |
|
Sélectionner Intégration configurée dans WorkSpan
|
integration_id | True | string | |
|
object_ids
|
object_ids | array of string | ||
|
Exemple de filtre : (étape dans [ « fermé », « won », « lost » ]) AND (sales_details.partner = « P1 »)
|
filters | string |
Filtres pour les événements |
Retours
S’abonner aux événements WorkSpan Collaboration
Abonnez-vous à différents événements de collaboration, tels que les créations et mises à jour sur l’appartenance, les tâches et les commentaires, pour favoriser et améliorer la communication avec votre réseau interne et partenaire.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de l'événement
|
event | True | string | |
|
Nom de l’abonné
|
name | True | string |
Nom attribué au webhook |
|
ID d’objet WorkSpan
|
object_ids | array of string |
ID d’objet pour lesquels le webhook est inscrit |
|
|
Exemple de filtre : (étape dans [ « fermé », « won », « lost » ]) AND (sales_details.partner = « P1 »)
|
filters | string |
Filtres pour les événements |
Retours
Définitions
bulkload_opportunity_response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
integration_id
|
integration_id | string |
ID d’intégration |
|
execution_id
|
execution_id | string |
ID d’exécution |
|
date_de_création
|
created_at | date-time |
Date de création |
bulkload_response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
integration_id
|
integration_id | string |
ID d’intégration |
|
execution_id
|
execution_id | string |
ID d’exécution |
|
data_format
|
data_format | string |
Format données |
|
date_de_création
|
created_at | date-time |
Date de création |
bulkload_status_response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
integration_id
|
integration_id | string |
ID d’intégration |
|
execution_id
|
execution_id | string |
ID d’exécution |
|
status
|
status | string |
État de l’exécution |
|
succcess_count
|
succcess_count | number |
Nombre d’enregistrements qui ont été traités avec succès |
|
error_count
|
error_count | number |
Nombre d’enregistrements avec des erreurs |
|
input_count
|
input_count | number |
Nombre d’enregistrements reçus |
|
skip_count
|
skip_count | number |
Nombre d’enregistrements ignorés |
|
started_at
|
started_at | date-time |
Horodatage de démarrage de l’exécution |
|
terminé_à
|
completed_at | date-time |
Horodatage de la fin de l’exécution |
|
include_errors
|
include_errors | boolean |
Indicateur qui indique si des erreurs seront retournées dans la réponse le cas échéant |
|
Erreurs
|
errors | array of object | |
|
Message
|
errors.message | string |
Message d'erreur |
|
pièce d'identité
|
errors.id | string |
ID de l’enregistrement qui a échoué |
|
data_row
|
errors.data_row | string |
Ligne de données qui a échoué |
external_id_response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
external_id
|
external_id | string |
ID du système externe (par exemple CRM) |
|
object_id
|
object_id | string |
ID d’objet WorkSpan (ID long) |
|
field_name
|
field_name | string |
Nom du champ WorkSpan où le external_id d’un système externe est stocké |
get_external_id_response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
object_id
|
object_id | string |
ID d’objet de l’objet WorkSpan (ID long) |
|
external_ids
|
external_ids | array of object | |
|
field_name
|
external_ids.field_name | string |
Nom du champ WorkSpan où le external_id d’un système externe est stocké |
|
external_id
|
external_ids.external_id | string |
ID du système externe (par exemple CRM) |
audit_response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
object_id
|
object_id | string |
ID d’objet WorkSpan (ID long) mis à jour |
|
field_name
|
field_name | string |
Nom du champ WorkSpan mis à jour |
|
status_code
|
status_code | string |
État des mises à jour |
ReportDataResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
endOfList
|
endOfList | boolean | |
|
results
|
results | array of | |
|
version
|
version | integer |