WorkSpan

O WorkSpan é uma plataforma colaborativa para planejar, executar e gerar receita com parceiros. Gerencie seus programas de parceiros e iniciativas de parceiros no WorkSpan e conecte-se perfeitamente com aplicativos internos e de parceiros. Você pode integrar seu CRM, Partner Center, ferramentas de colaboração e ferramentas de produtividade ao WorkSpan.

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regiões
Estúdio Copiloto	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes:      - Regiões do Azure Government      - Regiões do Azure China      - Departamento de Defesa dos EUA (DoD)
Aplicações Power	Premium	Todas as regiões do Power Apps , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Automatize o poder	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)

Contato
Nome	Suporte à API do WorkSpan
URL	https://support.workspan.com
Email	api-team@workspan.com

Metadados do conector
Editora	WorkSpan
Sítio Web	https://www.workspan.com
Categorias	Marketing; Vendas e CRM
Política de privacidade	https://www.workspan.com/privacy-policy

O WorkSpan é uma plataforma colaborativa para se conectar com seus parceiros e gerenciar seus programas de parceiros. A WorkSpan capacita programas de parceiros bem-sucedidos para algumas das principais empresas de tecnologia do mundo. Conecte seus aplicativos populares e preferidos com o WorkSpan Ecosystem Cloud para enriquecer o valor de suas oportunidades de vendas com o poder do seu ecossistema de parceiros. Com o WorkSpan Connector, os usuários podem turbinar e acelerar seus movimentos de ecossistema e parceria conectando-se perfeitamente a vários aplicativos de negócios, como o Dynamics 365 CRM e o Salesforce CRM. Os usuários podem sincronizar dados em seus principais aplicativos de CRM com o WorkSpan. Os usuários também podem se conectar a aplicativos de colaboração e produtividade, como Microsoft Teams, Slack e OneDrive. Os usuários podem permanecer notificados sobre os vários eventos relacionados à colaboração no WorkSpan, como tarefas atribuídas, comentários em objetos e ocorrências relacionadas à associação em objetos. O conector WorkSpan aumenta a produtividade, mantém a integridade dos dados em todos os aplicativos e fornece dados oportunos e valor aos usuários de aplicativos de negócios. Como resultado, as organizações que usam o conector experimentarão economia de custos, aumento de receitas, processos de vendas simplificados ou acelerados e relatórios aprimorados.

Pré-requisitos

A organização deve ser uma empresa registrada no WorkSpan

Como obter credenciais

Os usuários devem ser autenticados para usar o conector. O WorkSpan fornece acesso ao conector e aos dados no WorkSpan para usuários de aplicativos configurados no WorkSpan. Os passos detalhados estão disponíveis em https://support.workspan.com

Problemas conhecidos e limitações

Sem problemas conhecidos

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição	Parâmetros para criar conexão.	Todas as regiões	Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
Ambiente: Sandbox ou Produção	cadeia (de caracteres)	Ambiente de sandbox ou ambiente de produção	Verdade
ID do usuário do aplicativo	cadeia (de caracteres)	Id do usuário do aplicativo WorkSpan	Verdade
Segredo do usuário do aplicativo	securestring	Segredo do usuário do aplicativo	Verdade
Nome do host do aplicativo WorkSpan. Exemplo: demo.workspan.com /app.workspan.com	cadeia (de caracteres)	Digite o nome do host (sem https) Exemplo: demo.workspan.com / app.workspan.com	Verdade
Observações	cadeia (de caracteres)	Notas para conexão	Verdade

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	100	60 segundos

Ações

Adicionar informações de auditoria ao objeto WorkSpan	Adicionar informações de auditoria ao WorkSpanObject
Conectar uma ID externa a uma ID do WorkSpan	Atualizar o objeto WorkSpan com o identificador exclusivo primário do aplicativo externo
Dados de carga em massa (anexo)	Carregue um arquivo de entrada para sua integração. Os formatos permitidos são .xlsx, .json e .csv
Dados de carga em massa (dados no corpo)	Carregue dados de entrada como um corpo de solicitação para sua integração. Os formatos permitidos são .csv e .json
Ler dados do relatório	Ler dados do relatório
Obter ID externo para o WorkSpan ID	Obter o identificador exclusivo primário do aplicativo externo
Obter lista de relatórios	Listar relatórios
Obter o status da operação de carregamento em massa	Obter o status da operação de carregamento em massa
Oportunidades de carga em massa (dados no corpo)	Carregue dados de entrada como um corpo de solicitação para sua integração. Os formatos permitidos são .csv e .json
Oportunidades de carregamento em massa (anexo)	Carregue um arquivo de entrada para sua integração. Os formatos permitidos são .xlsx, .json e .csv

Adicionar informações de auditoria ao objeto WorkSpan

ID da Operação:

ObjectAudit

Adicionar informações de auditoria ao WorkSpanObject

Parâmetros

Name	Chave	Necessário	Tipo	Description
field_name	field_name	True	string	Nome do campo de auditoria no WorkSpan.
integration_id	integration_id		string	ID de integração (ID longo) da integração relacionada
external_id	external_id		string	ID do sistema externo (exemplo. ID do CRM)
status_code	status_code	True	string	Código que representa o estado do pedido de auditoria.
mensagem	message	True	string	Informações adicionais para registro no log de auditoria
ID do objeto WorkSpan (ID longo)	object_id	True	string	ID do objeto (ID longo) do objeto WorkSpan a ser atualizado com o status de integração

Devoluções

Body

audit_response

Conectar uma ID externa a uma ID do WorkSpan

ID da Operação:

UpdateExternalId

Atualizar o objeto WorkSpan com o identificador exclusivo primário do aplicativo externo

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do objeto WorkSpan (ID longo)	object_id	True	string	ID do objeto WorkSpan (ID longo)
field_name	field_name		string	Nome do campo de ID externo no WorkSpan. Se estiver vazio, o nome do campo de identificação externa será usado. Os nomes de campo padrão são: objeto de oportunidade: 'sales_details.crm_opportunity_id'; Objeto Accound: 'account_info.external_account_id'
external_id	external_id	True	string	ID do sistema externo (ex. CRM)

Devoluções

Body

external_id_response

Dados de carga em massa (anexo)

ID da Operação:

BulkloadDataFileAttachment

Carregue um arquivo de entrada para sua integração. Os formatos permitidos são .xlsx, .json e .csv

Parâmetros

Name	Chave	Necessário	Tipo	Description
Selecione Integração configurada no WorkSpan	integration_id	True	string	ID de integração da intergação do CRM, configurada no WorkSpan
Formatar dados. Os formatos permitidos são .csv .xlsx e .json	data_format		string	Formatar dados. Os formatos permitidos são .csv .xlsx e .json
ficheiro a carregar	file	True	file	ficheiro a carregar

Devoluções

Body

bulkload_response

Dados de carga em massa (dados no corpo)

ID da Operação:

BulkloadData

Carregue dados de entrada como um corpo de solicitação para sua integração. Os formatos permitidos são .csv e .json

Parâmetros

Name	Chave	Necessário	Tipo	Description
Selecione Integração configurada no WorkSpan	integration_id	True	string	ID de integração da intergação do CRM configurada no WorkSpan
Tipo de conteúdo dos dados. Os formatos permitidos são .csv e .json	data_format		string	Formato dos dados. Os formatos permitidos são csv e json
Delimitador de coluna (usado se content_type for CSV)	column_delimiter		string	Delimitador de coluna (usado se content_type for CSV)
Tipo de conteúdo dos dados. texto/csv ou aplicativo/json.	Content-Type		string	Tipo de conteúdo dos dados. texto/csv ou aplicativo/json.
dados a carregar	bulkload_request			Para o tipo de conteúdo 'CSV': linhas de dados como csv. A primeira linha será cabeçalhos de coluna. Para o tipo de conteúdo 'JSON', o formato de dados é matriz: [ { key1 : value, key2 : value}, { key1 : value, key2 : value } ]

Devoluções

Body

bulkload_response

Ler dados do relatório

ID da Operação:

GetReportData

Ler dados do relatório

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do relatório	reportId	True	integer	ID do relatório
colId	colId		string
negar	negate		boolean
PO	op		string
tipo	type		string
PO	op		string
número	number	True	integer
size	size	True	integer

Devoluções

Body

ReportDataResponse

Obter ID externo para o WorkSpan ID

ID da Operação:

GetExternalId

Obter o identificador exclusivo primário do aplicativo externo

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID do objeto WorkSpan (ID longo)	object_id	True	string	ID do objeto WorkSpan (ID longo)

Devoluções

Body

get_external_id_response

Obter lista de relatórios

ID da Operação:

GetReportList

Listar relatórios

Parâmetros

Name	Chave	Necessário	Tipo	Description
número	number		integer	número
size	size		integer	size

Devoluções

Name	Caminho	Tipo	Description
id	id	string	id
nome	name	string	nome

Obter o status da operação de carregamento em massa

ID da Operação:

GetBulkloadStatus

Obter o status da operação de carregamento em massa

Parâmetros

Name	Chave	Necessário	Tipo	Description
ID de integração	integration_id	True	string	ID de integração
ID de execução (etapa de bulkload bu retornada)	execution_id	True	string	ID de execução de uma execução de integração que é retornada da API em massa
Incluir erros na resposta se houver erros	include_errors		boolean	Incluir erros na resposta se houver erros
Número máximo de erros a serem retornados na resposta	max_errors		number	Número máximo de erros a serem retornados na resposta

Devoluções

Body

bulkload_status_response

Oportunidades de carga em massa (dados no corpo)

ID da Operação:

BulkloadOpportunity

Carregue dados de entrada como um corpo de solicitação para sua integração. Os formatos permitidos são .csv e .json

Parâmetros

Name	Chave	Necessário	Tipo	Description
Selecione Integração configurada no WorkSpan	integration_id	True	string	ID de integração da intergação do CRM configurada no WorkSpan
Tipo de conteúdo dos dados. Os formatos permitidos são .csv e .json	content_type		string	Tipo de conteúdo dos dados. Os formatos permitidos são .csv e .json
Delimitador de coluna (usado se content_type for CSV)	column_delimiter		string	Delimitador de coluna (usado se content_type for CSV)
Tipo de conteúdo dos dados. texto/csv ou aplicativo/json.	Content-Type		string	Tipo de conteúdo dos dados. texto/csv ou aplicativo/json.
dados a carregar	bulkload_opportunity_request			Para o tipo de conteúdo 'CSV': linhas de dados como csv. A primeira linha será cabeçalhos de coluna. Para o tipo de conteúdo 'JSON', o formato de dados é matriz: [ { key1 : value, key2 : value}, { key1 : value, key2 : value } ]

Devoluções

Body

bulkload_opportunity_response

Oportunidades de carregamento em massa (anexo)

ID da Operação:

BulkloadOpportunityFileAttachment

Carregue um arquivo de entrada para sua integração. Os formatos permitidos são .xlsx, .json e .csv

Parâmetros

Name	Chave	Necessário	Tipo	Description
Selecione Integração configurada no WorkSpan	integration_id	True	string	ID de integração da intergação do CRM, configurada no WorkSpan
Tipo de conteúdo dos dados. Os formatos permitidos são .csv .xlsx e .json	content_type		string	Tipo de conteúdo dos dados. Os formatos permitidos são .csv .xlsx e .json
O arquivo excel tem linha de cabeçalho?	has_header_row		boolean	O arquivo excel tem linha de cabeçalho?
ficheiro a carregar	file	True	file	ficheiro a carregar

Devoluções

Body

bulkload_opportunity_response

Acionadores

Enviar referência para o Microsoft Partner Center a partir do WorkSpan	Esse gatilho é acionado quando o usuário do WorkSpan pede para enviar oportunidade ao Microsoft Partner Center
Inscreva-se nos eventos de colaboração do WorkSpan	Inscreva-se em vários eventos de colaboração, como criações e atualizações sobre associação, tarefas e comentários para impulsionar e melhorar a comunicação com sua rede interna e de parceiros.
Inscrever-se em eventos de objeto do WorkSpan	Inscreva-se em vários eventos de objetos, como criações e atualizações em Oportunidades para aumentar a visibilidade da influência do seu parceiro

Enviar referência para o Microsoft Partner Center a partir do WorkSpan

ID da Operação:

SubmitToPartnerCenterObjectEvent

Esse gatilho é acionado quando o usuário do WorkSpan pede para enviar oportunidade ao Microsoft Partner Center

Parâmetros

Name	Chave	Necessário	Tipo	Description
nome	name	True	string	Nome do assinante do evento
Selecione Integração configurada no WorkSpan	integration_id	True	string

Devoluções

As saídas desta operação são dinâmicas.

Inscreva-se nos eventos de colaboração do WorkSpan

ID da Operação:

Subscribe

Inscreva-se em vários eventos de colaboração, como criações e atualizações sobre associação, tarefas e comentários para impulsionar e melhorar a comunicação com sua rede interna e de parceiros.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Nome do Evento	event	True	string
Nome do Assinante	name	True	string	Nome atribuído ao webhook
ID do objeto WorkSpan	object_ids		array of string	Ids de objeto para os quais o webhook está registrado
Exemplo de filtro: (estágio em [ "fechado", "ganhou", "perdeu" ]) E (sales_details.partner = "P1")	filters		string	Filtros para eventos

Devoluções

As saídas desta operação são dinâmicas.

Inscrever-se em eventos de objeto do WorkSpan

ID da Operação:

SubscribeObjectEvent

Inscreva-se em vários eventos de objetos, como criações e atualizações em Oportunidades para aumentar a visibilidade da influência do seu parceiro

Parâmetros

Name	Chave	Necessário	Tipo	Description
Inscrever-se em Eventos de Objeto	event	True	array of string
nome	name	True	string	Nome do assinante do evento
Selecione Integração configurada no WorkSpan	integration_id	True	string
object_ids	object_ids		array of string
Exemplo de filtro: (estágio em [ "fechado", "ganhou", "perdeu" ]) E (sales_details.partner = "P1")	filters		string	Filtros para eventos

Devoluções

As saídas desta operação são dinâmicas.

Definições

bulkload_opportunity_response

Name	Caminho	Tipo	Description
integration_id	integration_id	string	ID de integração
execution_id	execution_id	string	ID de execução
criado_em	created_at	date-time	Tempo de criação

bulkload_response

Name	Caminho	Tipo	Description
integration_id	integration_id	string	ID de integração
execution_id	execution_id	string	ID de execução
data_format	data_format	string	Formato dos dados
criado_em	created_at	date-time	Tempo de criação

bulkload_status_response

Name	Caminho	Tipo	Description
integration_id	integration_id	string	ID de integração
execution_id	execution_id	string	ID de execução
estado	status	string	Estado de execução
succcess_count	succcess_count	number	Número de registos que foram processados com êxito
error_count	error_count	number	Número de registos com erros
input_count	input_count	number	Número de registos recebidos
skip_count	skip_count	number	Número de registos ignorados
started_at	started_at	date-time	Carimbo de data/hora do início da execução
concluído_em	completed_at	date-time	Carimbo de data/hora da conclusão da execução
include_errors	include_errors	boolean	Sinalizador que indica se os erros serão retornados na resposta, se houver
erros	errors	array of object
mensagem	errors.message	string	Mensagem de erro
id	errors.id	string	ID do registo que falhou
data_row	errors.data_row	string	A linha de dados que falhou

external_id_response

Name	Caminho	Tipo	Description
external_id	external_id	string	ID do sistema externo (por exemplo, CRM)
object_id	object_id	string	ID do objeto WorkSpan (ID longo)
field_name	field_name	string	Nome do campo WorkSpan onde o external_id de um sistema externo é armazenado

get_external_id_response

Name	Caminho	Tipo	Description
object_id	object_id	string	ID do objeto WorkSpan (ID longo)
external_ids	external_ids	array of object
field_name	external_ids.field_name	string	Nome do campo WorkSpan onde o external_id de um sistema externo é armazenado
external_id	external_ids.external_id	string	ID do sistema externo (por exemplo, CRM)

audit_response

Name	Caminho	Tipo	Description
object_id	object_id	string	ID do objeto WorkSpan (ID longo) que foi atualizado
field_name	field_name	string	Nome do campo WorkSpan que foi atualizado
status_code	status_code	string	Status das atualizações

ReportDataResponse

Name	Caminho	Tipo	Description
endOfList	endOfList	boolean
results	results	array of
versão	version	integer