N8N Tools - Tidio API icon

N8N Tools - Tidio API

Complete Tidio integration - Live chat, AI chatbots, and customer engagement

Actions31

Visitor → Set Custom Properties

AI-generated

Overview

This node integrates with the Tidio API to manage visitor data within a live chat and customer engagement platform. Specifically, the "Visitor" resource with the "Set Custom Properties" operation allows users to set or update custom properties for a visitor identified by their Visitor ID. This is useful for enriching visitor profiles with additional metadata that can be used for personalized communication, segmentation, or automation triggers.

Practical examples include:

  • Adding custom attributes like user preferences or behavior tags to a visitor profile.
  • Updating visitor information dynamically based on interactions or external data sources.
  • Enhancing visitor records with business-specific data fields to improve targeting in chatbots or operator workflows.

Properties

Name Meaning
Visitor ID The unique identifier of the visitor whose custom properties will be set or updated.
Additional Fields A collection of optional fields including:
- Visitor Name, Email, Phone
- Tags (comma-separated)
- Tag Name
- Custom Properties (JSON object)
- Contact Name, Email, Phone
- Mailing List ID
- Bot Flow ID
- Status (Online, Offline, Away)
- Department
- Priority (Low, Normal, High, Urgent)
- Limit (number)
- Offset (number)
- Auto Reply (boolean)
- Send As Bot (boolean)

For this operation, the key relevant property inside Additional Fields is:

  • Custom Properties: JSON object representing the custom properties to set on the visitor.

Output

The node outputs a JSON object containing the response from the Tidio API after setting the custom properties. This typically includes confirmation of the updated visitor data or any error messages returned by the API.

No binary data output is involved in this operation.

Example output structure (simplified):

{
  "id": "visitor-id",
  "name": "Visitor Name",
  "email": "visitor@example.com",
  "custom_properties": {
    "key1": "value1",
    "key2": "value2"
  },
  ...
}

Dependencies

  • Requires an API key credential for authenticating with the Tidio API.
  • Needs configuration of the Tidio API base URL and client credentials (Client ID and Client Secret).
  • The node uses an HTTP proxy service endpoint (https://n8ntools.io/api/v1/proxy/tidio) to forward requests to the Tidio API.

Troubleshooting

  • Invalid Visitor ID: If the provided Visitor ID does not exist, the API will return an error. Verify the Visitor ID is correct.
  • Malformed Custom Properties JSON: Ensure the JSON string provided in Custom Properties is valid JSON; otherwise, parsing errors will occur.
  • Authentication Errors: Check that the API key and client credentials are correctly configured and have sufficient permissions.
  • API Rate Limits or Network Issues: Temporary failures may occur due to rate limiting or connectivity problems; retrying later might help.
  • Unknown Operation or Resource Errors: These indicate misconfiguration of the node parameters; ensure the Resource is set to "Visitor" and Operation to "Set Custom Properties".

Links and References

Discussion