Skip to content

vodoo helpdesk

Manage Odoo Helpdesk tickets (requires Odoo Enterprise).

Commands

list

List helpdesk tickets.

Options:

Option Type Description
--stage TEXT Filter by stage name
--partner TEXT Filter by partner name
--assigned-to TEXT Filter by assigned user name
--limit INT Maximum number of tickets (default: 50)
--field / -f TEXT Specific fields to fetch (can be used multiple times)

show

Show detailed ticket information.

Arguments:

Argument Type Description
ticket_id INT Ticket ID

Options:

Option Type Description
--field / -f TEXT Specific fields to fetch (can be used multiple times)
--html BOOL Show raw HTML description instead of markdown

comment

Add a comment to a ticket (visible to customers).

Arguments:

Argument Type Description
ticket_id INT Ticket ID
message TEXT Comment message

Options:

Option Type Description
--author / -a INT User ID to post as
--no-markdown BOOL Disable markdown to HTML conversion

note

Add an internal note to a ticket (not visible to customers).

Arguments:

Argument Type Description
ticket_id INT Ticket ID
message TEXT Note message

Options:

Option Type Description
--author / -a INT User ID to post as
--no-markdown BOOL Disable markdown to HTML conversion

tags

List available helpdesk tags.

tag

Add a tag to a ticket.

Arguments:

Argument Type Description
ticket_id INT Ticket ID
tag_id INT Tag ID

chatter

Show message history/chatter for a ticket.

Arguments:

Argument Type Description
ticket_id INT Ticket ID

Options:

Option Type Description
--limit INT Maximum number of messages to show
--html BOOL Show raw HTML body instead of plain text

attachments

List attachments for a ticket.

Arguments:

Argument Type Description
ticket_id INT Ticket ID

download

Download a single attachment by ID.

Arguments:

Argument Type Description
attachment_id INT Attachment ID

Options:

Option Type Description
--output PATH Output file path (defaults to attachment name)

download-all

Download all attachments from a ticket.

Arguments:

Argument Type Description
ticket_id INT Ticket ID

Options:

Option Type Description
--output / -o PATH Output directory (defaults to current directory)
--extension / --ext TEXT Filter by file extension (e.g., pdf, jpg, png)

fields

List available fields or show field values for a specific ticket.

Arguments:

Argument Type Description
ticket_id INT Ticket ID (optional)

Options:

Option Type Description
--field-name TEXT Show details for a specific field

set

Set field values on a ticket.

Supports operators: =, +=, -=, *=, /=
HTML fields (like description) automatically convert markdown to HTML.

Examples:
    vodoo helpdesk set 42 priority=2 name="New Title"
    vodoo helpdesk set 42 user_id=5 stage_id=3
    vodoo helpdesk set 42 priority+=1
    vodoo helpdesk set 42 'tag_ids=json:[[6,0,[1,2,3]]]'
    vodoo helpdesk set 42 'description=# Heading

Paragraph text'

Arguments:

Argument Type Description
ticket_id INT Ticket ID
fields TEXT Field assignments in format 'field=value' or 'field+=amount'

Options:

Option Type Description
--no-markdown BOOL Disable markdown to HTML conversion for HTML fields

attach

Attach a file to a ticket.

Arguments:

Argument Type Description
ticket_id INT Ticket ID
file_path PATH Path to file to attach

Options:

Option Type Description
--name / -n TEXT Custom attachment name (defaults to filename)

url

Get the web URL for a ticket.

Arguments:

Argument Type Description
ticket_id INT Ticket ID