WorkSpan
O WorkSpan é uma plataforma colaborativa para planejar, executar e gerar receita com parceiros. Gerencie seus programas parceiros e iniciativas de parceiro no WorkSpan e conecte-se perfeitamente com aplicativos internos e parceiros. Você pode integrar o CRM, o Partner Center, as ferramentas de colaboração e as ferramentas de produtividade ao WorkSpan.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – 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 |
| api-team@workspan.com |
| Metadados do conector | |
|---|---|
| Publicador | WorkSpan |
| Site | 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. O WorkSpan capacita programas de parceiros bem-sucedidos para algumas das principais empresas de tecnologia do mundo. Conecte seus aplicativos populares e preferenciais com o WorkSpan Ecosystem Cloud para enriquecer o valor de suas oportunidades de vendas com o poder do ecossistema de parceiros. Com o Conector do WorkSpan, os usuários podem sobrecarregar e acelerar seus movimentos de ecossistema e de parceria conectando-se perfeitamente com vários aplicativos de negócios, como o Dynamics 365 CRM e o Salesforce CRM. Os usuários podem sincronizar dados em seus aplicativos CRM premier com o WorkSpan. Os usuários também podem se conectar com 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 sobre objetos e ocorrências relacionadas à associação em objetos. O conector do WorkSpan aumenta a produtividade, mantém a integridade dos dados entre aplicativos e fornece dados e valor oportunos para os usuários de aplicativos empresariais. Como resultado, as organizações que usam o conector experimentarão economia de custos, aumento de receitas, processos de vendas simplificados e 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. As etapas detalhadas estão disponíveis em https://support.workspan.com
Problemas e limitações conhecidos
Nenhum problema conhecido
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | 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.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Ambiente: Área restrita ou produção | cadeia | Ambiente de área restrita ou ambiente de produção | Verdade |
| ID do usuário do aplicativo | cadeia | 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 | Insira o nome do host (sem https) Exemplo: demo.workspan.com/app.workspan.com | Verdade |
| Anotações | cadeia | Anotações de conexão | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
|
Adicionar informações de auditoria ao objeto Work |
Adicionar informações de auditoria ao WorkSpanObject |
| Carregar dados 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 |
|
Conectar uma ID externa a uma ID do Work |
Atualizar objeto WorkSpan com o identificador exclusivo primário do aplicativo externo |
| Dados de carregamento em massa (anexo) |
Carregue um arquivo de entrada na integração. Os formatos permitidos são .xlsx, .json e .csv |
| Ler dados do relatório |
Ler dados do relatório |
|
Obter ID externa para a ID do Work |
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 carregamento em massa (anexo) |
Carregue um arquivo de entrada na integração. Os formatos permitidos são .xlsx, .json e .csv |
| Oportunidades de carregamento 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 |
Adicionar informações de auditoria ao objeto WorkSpan
Adicionar informações de auditoria ao WorkSpanObject
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
field_name
|
field_name | True | string |
Nome de campo do Campo de Auditoria no WorkSpan. |
|
integration_id
|
integration_id | string |
ID de integração (ID longa) da integração relacionada |
|
|
external_id
|
external_id | string |
ID do sistema externo (exemplo. ID de CRM) |
|
|
status_code
|
status_code | True | string |
Código que representa o status da solicitação de auditoria. |
|
mensagem
|
message | True | string |
Informações adicionais para gravação no log de auditoria |
|
ID do objeto WorkSpan (ID longa)
|
object_id | True | string |
ID de objeto (ID longa) do objeto WorkSpan a ser atualizado com o status de integração |
Retornos
- Corpo
- audit_response
Carregar dados 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
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Selecionar Integração configurada no WorkSpan
|
integration_id | True | string |
ID de integração da interação crm configurada no WorkSpan |
|
Tipo de conteúdo de dados. Os formatos permitidos são .csv e .json
|
data_format | string |
Formato de 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 de dados. text/csv ou application/json.
|
Content-Type | string |
Tipo de conteúdo de dados. text/csv ou application/json. |
|
|
dados a serem carregados
|
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 } ] |
Retornos
- Corpo
- bulkload_response
Conectar uma ID externa a uma ID do WorkSpan
Atualizar objeto WorkSpan com o identificador exclusivo primário do aplicativo externo
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do objeto WorkSpan (ID longa)
|
object_id | True | string |
ID do objeto WorkSpan (ID longa) |
|
field_name
|
field_name | string |
Nome do campo da ID externa no WorkSpan. Se estiver vazio, o nome do campo padrão do campo de ID externo 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 (por exemplo, CRM) |
Retornos
- Corpo
- external_id_response
Dados de carregamento em massa (anexo)
Carregue um arquivo de entrada na integração. Os formatos permitidos são .xlsx, .json e .csv
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Selecionar Integração configurada no WorkSpan
|
integration_id | True | string |
ID de integração da interação 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 |
|
|
arquivo a ser carregado
|
file | True | file |
arquivo a ser carregado |
Retornos
- Corpo
- bulkload_response
Ler dados do relatório
Ler dados do relatório
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do relatório
|
reportId | True | integer |
ID do relatório |
|
colId
|
colId | string | ||
|
negar
|
negate | boolean | ||
|
Op
|
op | string | ||
|
tipo
|
type | string | ||
|
Op
|
op | string | ||
|
número
|
number | True | integer | |
|
size
|
size | True | integer |
Retornos
- Corpo
- ReportDataResponse
Obter ID externa para a ID do WorkSpan
Obter o identificador exclusivo primário do aplicativo externo
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do objeto WorkSpan (ID longa)
|
object_id | True | string |
ID do objeto WorkSpan (ID longa) |
Retornos
- Corpo
- get_external_id_response
Obter lista de relatórios
Listar relatórios
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
número
|
number | integer |
número |
|
|
size
|
size | integer |
size |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
id |
|
nome
|
name | string |
nome |
Obter o status da operação de carregamento em massa
Obter o status da operação de carregamento em massa
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID de integração
|
integration_id | True | string |
ID de integração |
|
ID de execução (etapa de carregamento em massa bu retornado)
|
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 |
Retornos
- Corpo
- bulkload_status_response
Oportunidades de carregamento em massa (anexo)
Carregue um arquivo de entrada na integração. Os formatos permitidos são .xlsx, .json e .csv
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Selecionar Integração configurada no WorkSpan
|
integration_id | True | string |
ID de integração da interação crm, configurada no WorkSpan |
|
Tipo de conteúdo de dados. Os formatos permitidos são .csv .xlsx e .json
|
content_type | string |
Tipo de conteúdo de dados. Os formatos permitidos são .csv .xlsx e .json |
|
|
O arquivo do Excel tem linha de cabeçalho?
|
has_header_row | boolean |
O arquivo do Excel tem linha de cabeçalho? |
|
|
arquivo a ser carregado
|
file | True | file |
arquivo a ser carregado |
Retornos
Oportunidades de carregamento 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
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Selecionar Integração configurada no WorkSpan
|
integration_id | True | string |
ID de integração da interação crm configurada no WorkSpan |
|
Tipo de conteúdo de dados. Os formatos permitidos são .csv e .json
|
content_type | string |
Tipo de conteúdo de 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 de dados. text/csv ou application/json.
|
Content-Type | string |
Tipo de conteúdo de dados. text/csv ou application/json. |
|
|
dados a serem carregados
|
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 } ] |
Retornos
Gatilhos
|
Assinar eventos de colaboração do Work |
Assine vários eventos de colaboração, como cria e atualiza sobre associação, tarefas e comentários para impulsionar e aprimorar a comunicação com sua rede interna e de parceiros. |
|
Assinar eventos do objeto Work |
Assine vários eventos de objeto, como cria e atualizações em Oportunidades, para aumentar a visibilidade da influência do parceiro |
|
Enviar referência ao Microsoft Partner Center do Work |
Esse gatilho é acionado quando o usuário do WorkSpan pede para enviar oportunidade ao Microsoft Partner Center |
Assinar eventos de colaboração do WorkSpan
Assine vários eventos de colaboração, como cria e atualiza sobre associação, tarefas e comentários para impulsionar e aprimorar a comunicação com sua rede interna e de parceiros.
Parâmetros
| Nome | Chave | Obrigató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 as quais o webhook está registrado |
|
|
Exemplo de filtro: (estágio em [ "closed", "won", "lost" ]) AND (sales_details.partner = "P1")
|
filters | string |
Filtros para eventos |
Retornos
Assinar eventos do objeto WorkSpan
Assine vários eventos de objeto, como cria e atualizações em Oportunidades, para aumentar a visibilidade da influência do parceiro
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Assinar eventos de objeto
|
event | True | array of string | |
|
nome
|
name | True | string |
Nome do assinante do evento |
|
Selecionar Integração configurada no WorkSpan
|
integration_id | True | string | |
|
object_ids
|
object_ids | array of string | ||
|
Exemplo de filtro: (estágio em [ "closed", "won", "lost" ]) AND (sales_details.partner = "P1")
|
filters | string |
Filtros para eventos |
Retornos
Enviar referência ao Microsoft Partner Center do WorkSpan
Esse gatilho é acionado quando o usuário do WorkSpan pede para enviar oportunidade ao Microsoft Partner Center
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
nome
|
name | True | string |
Nome do assinante do evento |
|
Selecionar Integração configurada no WorkSpan
|
integration_id | True | string |
Retornos
Definições
bulkload_opportunity_response
| Nome | 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 |
Data de criação |
bulkload_response
| Nome | 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 de dados |
|
criado_em
|
created_at | date-time |
Data de criação |
bulkload_status_response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
integration_id
|
integration_id | string |
ID de integração |
|
execution_id
|
execution_id | string |
ID de execução |
|
status
|
status | string |
Status da execução |
|
succcess_count
|
succcess_count | number |
Número de registros que foram processados com êxito |
|
error_count
|
error_count | number |
Número de registros com erros |
|
input_count
|
input_count | number |
Número de registros recebidos |
|
skip_count
|
skip_count | number |
Número de registros ignorados |
|
started_at
|
started_at | date-time |
Carimbo de data/hora da execução inicial |
|
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 registro que falhou |
|
data_row
|
errors.data_row | string |
A linha de dados que falhou |
external_id_response
| Nome | 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 longa) |
|
field_name
|
field_name | string |
Nome do campo WorkSpan em que o external_id de um sistema externo é armazenado |
get_external_id_response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
object_id
|
object_id | string |
ID do objeto WorkSpan (ID longa) |
|
external_ids
|
external_ids | array of object | |
|
field_name
|
external_ids.field_name | string |
Nome do campo WorkSpan em que o external_id de um sistema externo é armazenado |
|
external_id
|
external_ids.external_id | string |
ID do sistema externo (por exemplo, CRM) |
audit_response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
object_id
|
object_id | string |
ID do objeto WorkSpan (ID longa) que foi atualizada |
|
field_name
|
field_name | string |
Nome do campo WorkSpan que foi atualizado |
|
status_code
|
status_code | string |
Status das atualizações |
ReportDataResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
endOfList
|
endOfList | boolean | |
|
results
|
results | array of | |
|
versão
|
version | integer |