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 protected] |
| 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 [email protected]
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. |