ToldGuard MessageInstall

Summary

Posts each incoming item as a normalized message to the ToldGuard aggregator, then adds the response details to that item under toldguard.

Inputs

• Conversation ID (required) — Stable conversation identifier used for batching.
• Message ID (required) — Stable message identifier used for deduplication.
• Sender — Sender role: user, contact, customer, or lead; defaults to user.
• Content — Message text. Required unless at least one attachment is provided.
• Content Type — Message type: text, audio, image, file, or attachment; defaults to text.
• Created At — Message timestamp. Defaults to the current time if empty.
• Contact ID — Optional contact identifier.
• Inbox ID — Optional inbox identifier.
• Phone Number — Optional phone number.
• Source Channel — Origin label stored with the message; defaults to n8n.
• Attachments — Optional attachment array following ToldGuard's aggregator attachment contract.
• Raw Event Reference — Optional reference to the upstream event.
• Raw Payload — Original event stored for diagnostics; defaults to the incoming item JSON.

Output shape

One output item per successfully submitted input item, preserving its original JSON and adding a toldguard object.

The toldguard object contains response status, reason, conversation_id, message_id, and the full response as raw. Requires ToldGuard credentials with Tenant ID and Aggregator Input Token. Execution errors if either ID is empty or both content and attachments are empty.

Links

• n8n community nodes installation guide