NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Dovetail

dovetail

Dovetail is an Australian software company that provides tools for transcription analysis, coding interpretation of interviews, survey responses, and feedback, enabling users to create summarized insights from their research analysis.

AnalyticsTranscriptionWeb del proveedor
Acciones
18
Triggers
0
Autenticación
—
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (18)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Create ChannelDOVETAIL_CREATE_CHANNELAcción

Tool to create a new channel in dovetail. use after confirming channel details.

Parámetros de entrada

  • namestringObligatorio

    The name of the channel.

  • typestringObligatorioenum

    Type of the channel (public or private).

    publicprivate
  • membersstring[]

    Optional list of member user IDs to add to the channel.

  • metadataobject

    Optional arbitrary metadata about the channel.

  • descriptionstring

    Optional description of the channel.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create ContactDOVETAIL_CREATE_CONTACTAcción

Tool to create a new contact in dovetail. use when you need to register a contact before logging interactions.

Parámetros de entrada

  • namestringObligatorio

    The contact's name.

  • emailanyObligatorioemail

    The contact's email address.

Parámetros de salida

  • dataobjectObligatorio

    Wrapper object containing the created contact data.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create Data PointDOVETAIL_CREATE_DATA_POINTAcción

Tool to create a data point within a channel. use after capturing new content to record and classify it in dovetail.

Parámetros de entrada

  • textstringObligatorio

    The data point's content, length between 1 and 5,000,000 characters

  • metadataobject

    Optional key-value metadata to include with the data point

  • timestampanyObligatoriodate-time

    The data point's timestamp in ISO8601 format

  • channel_idstringObligatorio

    Unique identifier of the channel that the data point is associated with

  • source_urlanyuri

    The URL of the original source from which this data point was extracted (optional)

  • source_titlestring

    The title of the original source from which this data point was extracted (optional)

Parámetros de salida

  • dataobjectObligatorio

    Response data for a created data point.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create InsightDOVETAIL_CREATE_INSIGHTAcción

Tool to create a new insight in dovetail. use after synthesizing findings when ready to store them. example: "create insight 'q1 user trends' with body '...' for project 'proj 123'."

Parámetros de entrada

  • bodystringObligatorio

    The main content of the insight.

  • tagsstring[]

    Tags for categorizing the insight.

  • titlestringObligatorio

    The title of the insight.

  • project_idstring

    ID of the related project. If omitted, the insight will not be tied to a specific project.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create TopicDOVETAIL_CREATE_TOPICAcción

Tool to create a new topic in a channel. use after confirming channel id, title, and optional description.

Parámetros de entrada

  • titlestringObligatorio

    Title of the new topic

  • channel_idstringObligatorio

    UUID of the channel to add the topic to

  • descriptionstring

    Optional description or body of the topic

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete ChannelDOVETAIL_DELETE_CHANNELAcción

Tool to delete an existing channel. use when you need to remove a channel and move it to the project's trash (restorable for 30 days). confirm the channel id before calling.

Parámetros de entrada

  • channel_idstringObligatorio

    The unique identifier of the channel to delete. Deleted channel ends up in project's trash, restorable for 30 days.

Parámetros de salida

  • dataobjectObligatorio

    Wrapper object containing the deleted channel details.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete TopicDOVETAIL_DELETE_TOPICAcción

Tool to delete an existing topic. use when you have confirmed the topic id and want to move it to trash (restorable for 30 days). example: "delete topic with id 123e4567-e89b-12d3-a456-426614174000."

Parámetros de entrada

  • topic_idstringObligatorio

    Unique identifier of the topic to delete. Deleted topic ends up in project's trash, restorable for 30 days.

Parámetros de salida

  • dataobjectObligatorio

    Wrapper object containing the deleted topic details.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get NoteDOVETAIL_GET_NOTEAcción

Tool to retrieve details of a specific note. use when you have confirmed the note id and need full note metadata from dovetail.

Parámetros de entrada

  • note_idstringObligatorio

    Unique identifier of the note to retrieve

Parámetros de salida

  • dataobjectObligatorio

    Retrieved note details

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Token InfoDOVETAIL_GET_TOKEN_INFOAcción

Tool to get information about the current api token. use after authenticating to verify token scopes and expiry.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Wrapper object containing the current token's information.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List ContactsDOVETAIL_LIST_CONTACTSAcción

Tool to list all contacts in dovetail. use after authenticating with a valid workspace token when you need the complete contact list.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobject[]Obligatorio

    List of contacts returned by the API.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List DataDOVETAIL_LIST_DATAAcción

Tool to list data items in dovetail. use when you need to retrieve, filter, sort, or paginate through your workspace data after authentication. supports dovetail filters, sort syntax, and cursor-based pagination.

Parámetros de entrada

  • sortstring

    Sort expression using Dovetail Sort syntax. See https://developers.dovetail.com/docs/sort.

  • filterstring

    Filter expression using Dovetail Filters syntax. See https://developers.dovetail.com/docs/filters.

  • page[limit]integer

    Number of items to return per page (1-100). Defaults to 100.

  • page[start_cursor]string

    Cursor to fetch the next page of results.

Parámetros de salida

  • dataobject[]Obligatorio

    List of data items returned by the API.

  • pageobjectObligatorio

    Pagination details for navigating through results.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List HighlightsDOVETAIL_LIST_HIGHLIGHTSAcción

Tool to list all highlights in dovetail. use after authenticating with a valid workspace token when you need to retrieve the complete highlight list.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobject[]Obligatorio

    List of highlights returned by the API.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List NotesDOVETAIL_LIST_NOTESAcción

Tool to list all notes in dovetail. use after confirming you have a valid workspace token and need to retrieve the full note list.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobject[]Obligatorio

    List of notes returned by the API.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List ProjectsDOVETAIL_LIST_PROJECTSAcción

Tool to list all projects in dovetail. use after authenticating with a valid workspace token when you need to retrieve the full project list.

Parámetros de entrada

  • pageinteger

    Page number to retrieve (minimum 1).

  • per_pageinteger

    Number of projects to return per page (minimum 1).

Parámetros de salida

  • dataobject[]Obligatorio

    List of projects returned by the API.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List TagsDOVETAIL_LIST_TAGSAcción

Tool to list all tags in dovetail. use after authenticating with a valid workspace token when you need to retrieve the complete tag list.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • datastring[]Obligatorio

    List of tags associated with the workspace.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List User InsightsDOVETAIL_LIST_USER_INSIGHTSAcción

Tool to list insights for a specific user. use when you need to retrieve all personal insights associated with a user id.

Parámetros de entrada

  • user_idstringObligatorio

    Unique identifier of the user whose insights will be listed.

Parámetros de salida

  • dataobject[]Obligatorio

    List of personal insights returned by the API.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Magic SearchDOVETAIL_MAGIC_SEARCHAcción

Tool to perform a magic search across workspace data. use when you need to retrieve relevant highlights, notes, insights, channels, themes, or tags by query.

Parámetros de entrada

  • pageinteger

    Page number for paginated results, 1-based

  • limitinteger

    Maximum number of items per type to return

  • querystringObligatorio

    Text query to search across workspace data

  • typesstring[]

    Result types to include; defaults to all types if omitted

Parámetros de salida

  • dataobjectObligatorio

    Search results container

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update TopicDOVETAIL_UPDATE_TOPICAcción

Tool to update an existing topic. use after confirming the topic id and fields to change. example: "update topic with id 123... to have title 'new'".

Parámetros de entrada

  • titlestring

    New title for the topic.

  • topic_idstringObligatorio

    UUID of the topic to update.

  • descriptionstring

    Updated description for the topic.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not