Activities

Link mail or WhatsApp messages to a task

Links one or more messages — received or sent, mail or WhatsApp — to a task that already exists: the «Collega a un’attività» of the mail reader and of a WhatsApp chat. channel says whose ids they are: email (the default; ids from email_search, email_get or email_get_thread) or whatsapp (message ids from whatsapp_get_chat). The message stays where it is and is NOT filed in the Archivio; a mail that is already there brings its Archivio document along as an attachment. The member behind this credential must be able to open every message themselves — any other id answers not-found for the whole call — and edit the task (as attivita_update_task does). A task holds at most 50 linked messages. Idempotent: a message linked already is not linked twice, and linked counts only the new links. To start a NEW task from messages, a person does that from the mail reader or the chat.

post/api/v1/rest/attivita/tasks/{id}/messages

Request

  • Base URL: https://api.custodo.ai
  • URL: https://api.custodo.ai/api/v1/rest/attivita/tasks/{id}/messages
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Headers

X-Tenant-Idstring uuid

The organisation to act in. An API key is bound to exactly one, so this is optional for a key and must match the one it was minted for.

Request body

channel'email' | 'whatsapp'

email (default) or whatsapp: which module the message ids belong to.

message_idsstring[] required

Message ids — mail ones from email_search, email_get or email_get_thread; WhatsApp ones from whatsapp_get_chat.

Response

Done. data is the tool’s own answer.

oktrue required
dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.