Partilhar via


Vocean

Vocean is the space for co-creation. Here you can collaborate with many, or few, individuals. With Vocean you can innovate together by gathering ideas, develop and evaluate them. Connect to Vocean to get informed about new insights, or retrieve insights gathered.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Vocean AB
URL https://vocean.com/contact-vocean/
Email support@vocean.com
Connector Metadata
Publisher Vocean AB
Website https://vocean.com
Privacy policy https://vocean.com/tos
Categories Collaboration;Business Management

With this Vocean connector you are able to retrieve insights gathered within Vocean for further use within programs already tightly involved in your organization. Use the power of our co-creation space without the need to alter your entire workflow, until you are ready to do so.

Prerequisites

To use this Vocean connector you must be a member of a Vocean space. You must also have a Vocean Premium Leader license.

If you are not yet a member of a Vocean space you can easily request for a space of your own here.

If you are a member of the Vocean space towards which you would like to use this connector, but lack the Premium Leader license, please ask the one who invited you to the space to provide you with a Premium Leader license.

How to get credentials

When you sign up for a Vocean space of your own, or accept an invitation to an existing space, you will get the credentials you need. When using this connector, you will be asked to log in using the same login you use in the Vocean space.

Get started with your connector

You will be able to retrieve ideas, votes and explore responses with this connector. Along with additional information added to those, for example likes. This information is gathered in activities created within Vocean and then the connector actions can be used to get the insights. You are also able to add ideas to an existing activity via the connector, or let a trigger inform you when an idea is added or altered in an activity that you specify.

Please note that you can only retrieve insights from activities where you have leader rights, and where your Vocean membership in that space has a Premium Leader license. (You can have the Premium Leader license in a space but only be a participant in a specific activity, then you will not be able to retrieve the insights from that activity via the connector.)

Please, also note that for Explore activities there is a possibility to set a privacy level. This prevents access to the responses - until the specified number of responses have been submitted. If this privacy level is provided, the Responder property will be empty and the Response Date will consist of date only, no timestamp.

Known issues and limitations

There is a limit for how many insights that can be retrieved via the connector.

  • For Prioritize activities a maximum of 1,000 votes will be returned.
  • For Innovate activities a maximum of 1,000 ideas will be returned.
  • For Explore activities an approximate maximum of 1,000 question responses will be returned. (If 1,000 is not evenly divisible by the number of questions in the activity the maximum is slightly increased.)

The dropdowns and actions for fetching spaces and activities are limited to 100 items. If you should encounter this limit you may manually add the activity id in the dropdown box. Open the activity in the Web browser and you will find the activity id from the activity's URL: It is the trailing part after /activity/. For example, in https://app.vocean.com/.../activity/3259511a-145e-4b2c-9c01-bd2b9e0a52bc the activity id would be 3259511a-145e-4b2c-9c01-bd2b9e0a52bc.

The Add ideas action is limited to 100 ideas.

What is a vote, an idea and a question response?

In Prioritize activities each respondent is assumed to provide one vote (even though the vote may contain for example dot-voting and hence providing values for several options within the activity). In Innovate activities each respondent can provide a number of ideas, limited or unlimited by the activity leader. For these activities each idea is counted. In Explore activities each respondent sets a response to each question of the activity when submitting. Here each question response is counted.

Common errors and remedies

For the moment we have no knowledge of such errors. But, please, inform us if you encounter any problems and we will do our best to fix them: https://vocean.com/contact-vocean/ or support@vocean.com

Please include:

  • Information regarding that it concerns the data connector
  • Which connector operation you are using (the name of the trigger or action)
  • A description of the error/problem
  • The activity's URL
  • Your contact information (e-mail and if possible, phone number)

FAQ

Do I need to own the Vocean space?

The Vocean spaces are usually set up per organization and then the organization can add several members to this space. You do not have to own the Vocean space, but you need to be a member of the space. You also must have a Premium Leader license in that space.

I am a leader of the activity, why can't I gather the insights?

You can be a leader of an activity with either Premium Leader license or without (Basic Leader license). Your membership needs to have the Premium Leader license to be able to gather insights with the connector.

I am a Premium Leader in the Vocean space, why can't I gather the insights?

If you have a Premium Leader license you still need to be appointed leader of the specific activity to gather its insights through the connector. Ask the leader of the activity to appoint you too as leader.

Can I use the same setup for a different activity?

For actions you will be asked to provide the activity you would like to use. As long as the activity type in Vocean is the same you can reuse your setup. But you need different setups for different activity types. (Since the different activity types provide you with different insights you would probably want different setups for the different activity types anyway.)

Why can’t I find the activity in the activity list?

Make sure you have selected a space, and that it is the correct one. A space is needed before activities can be fetched. Depending on the operation the activities shown can be limited to the activity type, make sure you are looking for an activity of the correct type. Make sure you are looking for the activity's header in the list, and not the workboard’s header.

The dropdowns and actions for fetching spaces and activities are limited to 100 items. If you should encounter this limit you may manually add the activity id in the dropdown box. Open the activity in the Web browser and you will find the activity id from the activity's URL as the trailing part after /activity/. For example, in https://app.vocean.com/.../activity/3259511a-145e-4b2c-9c01-bd2b9e0a52bc the activity id would be 3259511a-145e-4b2c-9c01-bd2b9e0a52bc.

Why can't I see any Explore responses?

If there is a privacy level set for the activity, you will not be able to see any responses until the minimum number of responses have been submitted.

Why is the Responder property empty?

For Explore activities where the privacy level is set, the Responder property will be empty. This is to prevent corss-references between questions with potentially sensitive information.

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Add idea

Create an idea in a specific Vocean activity.

Add ideas

Create ideas in a specific Vocean activity.

Get activities

Get available activities in Vocean, for the specified network. (Activities where the user is a leader.)

Get explore responses

Get all the responses from a specified Explore activity in Vocean, when the privacy level allows it.

Get ideas

Get all the ideas and related data from a specified Innovate activity in Vocean.

Get spaces

Get available spaces in Vocean. (Where the user has a Premium Leader license.)

Get votes

Get all the votes from a specified Prioritize activity in Vocean.

Add idea

Create an idea in a specific Vocean activity.

Parameters

Name Key Required Type Description
Space id
networkId True string

Specify the id of the space where the activities are located.

Activity id
activityId True string

Specify the Innovate activity's id. (Found in the activity's URL.)

Idea
text True string

Idea text to be added.

Returns

Name Path Type Description
ID
ideaId string

The id of the created idea.

Add ideas

Create ideas in a specific Vocean activity.

Parameters

Name Key Required Type Description
Space id
networkId True string

Specify the id of the space where the activities are located.

Activity id
activityId True string

Specify the Innovate activity's id. (Found in the activity's URL.)

Idea
text string

Idea text to be added.

Returns

Name Path Type Description
array of object
ID
ideaId string

The id of the created idea.

Get activities

Get available activities in Vocean, for the specified network. (Activities where the user is a leader.)

Parameters

Name Key Required Type Description
Space id
networkId True string

Specify the id of the space where the activities are located.

Activity type.
activityType True string

Specify the activity type for the activities to be fetched.

Returns

Name Path Type Description
array of object
ID
activityId string

The id of the activity.

Created Date
createdDate string

The timestamp for when the activity was created.

Header
header string

The header, or title, of the activity.

Type
activityType string

The activity type.

Get explore responses

Get all the responses from a specified Explore activity in Vocean, when the privacy level allows it.

Parameters

Name Key Required Type Description
Space id
networkId string

Specify the id of the space where the activities are located.

Activity id
activityId True string

Specify the Explore activity's id. (Found in the activity's URL.)

Returns

Name Path Type Description
array of object
ID
responseId string

The id of the response.

Activity ID
activityId string

The id of the Explore activity for which responses were requested.

Question ID
questionId string

The id of the specific question within the Explore activity.

Responder
responder string

An id enabling answers from the same respondent to be linked, within the activity.

Response Date
responseCreateDate string

The timestamp of when the response was submitted.

Order
questionOrder integer

The order of the questions in relation to other questions within the Explore activity.

Question
questionText string

The question text in the original language.

Type
type string

Type of question.

Text
responseTextOriginal string

For text questions the text is presented here.

Translation
responseTextEnglishTranslation string

For text questions the English translation of the text is presented here.

Numeric
responseNumericValue string

For numeric questions the value is presented here.

Slider
responseSliderValue string

For slider questions the value is presented here.

Yes or No
responseYesNoValue string

For yes (true) or no (false) questions the Boolean value is presented here.

Multiple Values
responseMultipleValues array of object

For multiple answer questions the values for each option is presented here.

label
responseMultipleValues.label string

label

value
responseMultipleValues.value string

value

Get ideas

Get all the ideas and related data from a specified Innovate activity in Vocean.

Parameters

Name Key Required Type Description
Space id
networkId string

Specify the id of the space where the activities are located.

Activity id
activityId True string

Specify the Innovate activity's id. (Found in the activity's URL.)

Returns

Name Path Type Description
array of object
ID
ideaId string

The id of the idea.

Activity ID
activityId string

The id of the Innovate activity for which ideas were requested.

Created Date
ideaCreateDate string

The timestamp for when the idea was created.

Idea
ideaTextOriginal string

The idea text, in the original language.

Key Phrases
ideaKeyPhrasesOriginal array of string

The key phrases found in the idea text (original language).

Translation
ideaTextEnglishTranslation string

The idea text translated to English.

Key Phrases (En)
ideaKeyPhrasesEnglishTranslation array of string

The key phrases found in the English translation of the idea text.

Likes
likes integer

Number of likes the idea has received.

Values
ideaPropertyValues array of object

When properties are used the values for the idea is presented here.

Label
ideaPropertyValues.label string

Property label.

Value
ideaPropertyValues.value float

Property value.

Categories
ideaCategories array of string

Categories assigned to the idea.

Get spaces

Get available spaces in Vocean. (Where the user has a Premium Leader license.)

Returns

Name Path Type Description
array of object
ID
id string

The id of the space.

Created Date
createdDate string

The timestamp for when the space was created.

Name
name string

The name of the space.

Code
code string

The code of the space.

Get votes

Get all the votes from a specified Prioritize activity in Vocean.

Parameters

Name Key Required Type Description
Space id
networkId string

Specify the id of the space where the activities are located.

Activity id
activityId True string

Specify the Prioritize activity's id. (Found in the activity's URL.)

Returns

Name Path Type Description
array of object
ID
voteId string

The id of the vote.

Activity ID
activityId string

The id of the Prioritize activity for which votes were requested.

Vote Date
voteCreateDate string

The timestamp of when the vote was submitted.

Values
voteOptionValues array of object

The values for each vote option.

label
voteOptionValues.label string

label

value
voteOptionValues.value integer

value

Triggers

When an activity's, or a workboard's, availability changes for the current user

Triggers when something happens to an activity, or a workboard, that affects the current user's possibility to interact with the activity or workboard. For example, when a user is added as leader to a workboard or when an activity where the user is participating is finished.

When an idea is added or interacted with

Triggers when an idea is added, or something happens to an existing idea. For example, that the idea is liked, or the idea text is changed.

When an activity's, or a workboard's, availability changes for the current user

Triggers when something happens to an activity, or a workboard, that affects the current user's possibility to interact with the activity or workboard. For example, when a user is added as leader to a workboard or when an activity where the user is participating is finished.

Parameters

Name Key Required Type Description
Space id
networkId string

Specify the id of a space to monitor, or leave blank to monitor all spaces.

Event Types
eventType string

Specify the event type(s) the trigger should listen to. (No selection will listen to all activity event types.)

Returns

Name Path Type Description
ID
id string

The id of the event.

Event Type
eventType string

The name of the event type.

Event Time
eventTime string

The timestamp for when the event occurred.

Event Path
eventPath string

A string description of what the event is related to. (/activity/{Activity ID}/{Event Type})

ID
data.activityId string

The id of the activity.

Created Date
data.createdDate string

The timestamp for when the activity was created.

Header
data.header string

The header, or title, of the activity.

Type
data.activityType string

The activity type.

When an idea is added or interacted with

Triggers when an idea is added, or something happens to an existing idea. For example, that the idea is liked, or the idea text is changed.

Parameters

Name Key Required Type Description
Space id
networkId True string

Specify the id of the space where the activity is located.

Activity id
activityId True string

Specify the Innovate activity's id. (Found in the activity's URL.)

Event Types
eventType string

Specify the event type(s) the trigger should listen to. (No selection will listen to all idea event types.)

Returns

Name Path Type Description
ID
id string

The id of the event.

Event Type
eventType string

The name of the event type.

Event Time
eventTime string

The timestamp for when the event occurred.

Event Path
eventPath string

A string description of what the event is related to. (/Innovate/{Activity ID}/{Event Type})

ID
data.ideaId string

The id of the idea.

Activity ID
data.activityId string

The id of the Innovate activity where the idea exists.

Created Date
data.ideaCreateDate string

The timestamp for when the idea was created.

Idea
data.ideaTextOriginal string

The idea text, in the original language.

Key Phrases
data.ideaKeyPhrasesOriginal array of string

The key phrases found in the idea text (original language).

Translation
data.ideaTextEnglishTranslation string

The idea text translated to English.

Key Phrases (En)
data.ideaKeyPhrasesEnglishTranslation array of string

The key phrases found in the English translation of the idea text.

Likes
data.likes integer

Number of likes the idea has received.

Values
data.ideaPropertyValues array of object

When properties are used the values for the idea is presented here.

Label
data.ideaPropertyValues.label string

Property label.

Value
data.ideaPropertyValues.value float

Property value.

Categories
data.ideaCategories array of string

Categories assigned to the idea.