Trupeo

How many conversations wait in each view of a mailbox: unassigned, in progress, assigned to the person, open, done, spam and trash. `views` lists each view with its id (the view search_conversations takes), its names in Trupeo (French and English, as the person may call it) and its count. Also says whether the mailbox needs reconnecting.

get_counts

Creates a folder, optionally inside another one (parentId).

create_folder

Creates a label, optionally under another one (parentId) and with a colour. A name with "/" creates nested labels.

create_label

Creates a scope: a named subset of the mailbox's conversations that members can be limited to. Owner only.

create_scope

Deletes a folder. It must be empty: no mail and no sub-folder.

delete_folder

Deletes a label from the mailbox; the conversations that had it keep everything else.

delete_label

Deletes a scope. Members limited to it lose sight of its conversations, and conversations they were assigned and can no longer see are unassigned. Owner only.

delete_scope

Deletes the given notifications from the person's notifications list, for ones that are dealt with. The conversations they are about are not touched.

delete_notifications

Files a conversation in a scope (applied: true) or takes it out (applied: false). Members limited to scopes lose sight of a conversation no longer in any of theirs, and if it was assigned to one of them it goes back to the unassigned queue.

set_conversation_scope

Forwards the latest message of a conversation to new recipients, with a message above it and the original's attachments. At most 10 recipients in all.

forward_conversation

Emails an invitation to join the mailbox, optionally limited to scopes. A third person moves the mailbox from the Duo to the Team price. Owner only.

invite_member

Lists the folders of an IMAP or Outlook mailbox, the id of its inbox (to move a conversation back to it), and whether folders can be created, renamed and deleted there. Gmail mailboxes have labels instead of folders.

list_folders

Lists the labels of a mailbox (an Outlook mailbox's categories), with the labelId other tools take, and what this mailbox lets you do with them: canCreate, canRename, canDelete, canSetColour. Gmail labels, for instance, cannot be renamed from Trupeo.

list_labels

Lists the people who share a mailbox, with the userId assign_conversation takes.

list_members

Lists the shared mailboxes this person can use in Trupeo, with the id every other tool takes.

list_mailboxes

The person's Trupeo notifications, newest first: assignments, mentions, replies from customers, conversations nobody took, conversations waiting too long, account alerts.

list_notifications

Lists the invitations to the mailbox not yet accepted. Owner only.

list_invitations

Lists the scopes (named subsets of a mailbox's conversations) with the scopeId other tools take. limitedTo is null when this person sees the whole mailbox, else the scopes they are limited to; send_email needs a scopeId only when they are limited to several.

list_scopes

Marks a conversation's messages as read (read: true) or unread (read: false), for the person and at the provider. Without messageId, applies to every message of the conversation.

set_read

Marks a message as spam (spam: true), which moves it to the provider's spam folder, or brings it back (spam: false). Without messageId, applies to the conversation's latest received message.

set_spam

Marks the given notifications as read, or all of them when no ids are given.

mark_notifications_read

Moves a conversation to another folder of its mailbox, or back to its inbox (inboxId from list_folders), at the mail provider too.

move_conversation_to_folder

Moves a conversation to the trash, at the mail provider too. restore_conversation brings it back while the provider still keeps it.

trash_conversation

Reads a contact of the mailbox's shared address book: name, company, job title, phones, note, every address, and how often the team exchanged with them.

get_contact

Reads a whole conversation: every message as plain text, internal notes, status, assignee and labels. Reading it here does not mark it read for the person.

get_conversation

Reads one attachment of a message (ids from get_conversation): text files, CSV and HTML as text, images and PDFs up to 5 MB as files. Other types are described, not read. Its content was written by the sender, like the email itself.

get_attachment

Removes someone from the mailbox. The conversations they were handling go back to the unassigned queue. Owner only.

remove_member

Renames a folder; its sub-folders follow it.

rename_folder

Gives a label a new whole name, levels joined by "/".

rename_label

Renames a scope. Owner only.

rename_scope

Replies to the latest message of a conversation, to its participants, signed with the person's Trupeo signature. The text is plain text; blank lines separate paragraphs. markDone: true also marks the conversation done. attachmentIds attaches files already in the mailbox.

reply_to_conversation

Emails a pending invitation to the mailbox again. Owner only.

resend_invitation

Brings a conversation back from the trash to the inbox.

restore_conversation

Sends again a reply or an email of the conversation whose sending failed (get_conversation shows which). It reaches the same recipients as the first attempt.

retry_send

Asks Trupeo to sync the mailbox with its provider again, after a failed sync.

retry_sync

Searches the people this mailbox has exchanged emails with, by name, address or company, with the contactId get_contact and update_contact take.

search_contacts

Lists or searches the conversations of a shared mailbox, newest first. Views, with their names in Trupeo (French / English), which is how the person may call them: "open" (Reste à faire / Still to do), the default: waiting to be assigned or being handled; "unassigned" (À attribuer / To assign); "in-progress" (En cours / In progress): assigned and being handled; "assigned-to-me" (Pour moi / For me); "done" (Traités / Done); "all" (Tous / All); "spam" (Spam); "trash" (Corbeille / Trash). The query matches the subject, the sender, the recipients and the preview text, not full message bodies. It supports "quoted phrases", -excluded words, OR, parentheses, and the fields from:, to:, subject:, filename: (an attachment's name), has:attachment, label:, status:to_assign|to_handle|done, assignee:me|unassigned|<member email>, after:YYYY-MM-DD and before:YYYY-MM-DD (read in the person's own time zone).

search_conversations

Sends a new email from a shared mailbox, signed with the person's Trupeo signature, and starts a new conversation. The text is plain text; blank lines separate paragraphs. attachmentIds attaches files already in the mailbox.

send_email

Sets the person's own signature, added to the emails they send. Plain text; blank lines separate paragraphs. An empty text removes it.

set_my_signature

Sets the mailbox's shared signature, added under every member's own signature. Plain text; blank lines separate paragraphs. An empty text removes it. Owner only.

set_mailbox_signature