Fale JáInstall

Summary

Add labels to a conversation, replacing all existing labels.

Inputs

• apiType — Select which API to use based on your role and use case. Options: Application API (for agents and admins), Client API (for end-users/customers), or Platform API (for system administrators). The selected API determines the scope of conversation and label management available in the backend Chatwoot instance. Defaults to Application API if omitted.
• conversationId (required) — The unique identifier of the conversation to which labels will be applied. This value is mandatory for the operation to execute.
• labels (required) — Comma-separated list of label names to assign to the conversation (e.g., 'urgent,sales,vip'). This parameter replaces all existing labels on the conversation; previously assigned labels are removed and only the newly provided ones remain.

Output shape

The operation does not return a structured payload visible in the n8n node UI; success is indicated by the node's execution completion and any downstream error handling. Side effects include updating the conversation's label set on the connected Chatwoot instance according to the selected API type.

Label names are case-sensitive and must match existing or create new labels depending on the Chatwoot backend configuration. If the labels string is empty or omitted, the node may reject the execution due to the required: true constraint.

Examples

Example 1: Add 'urgent' and 'vip' labels to conversation ID 42 using the Application API.

apiType: application, conversationId: 42, labels: urgent,vip

Links

• n8n community nodes installation guide