Cogfy Tables icon

Cogfy Tables

Interact with Cogfy Tables API for collections, records, and fields management

Actions26

Overview

This node operation allows you to create a new chat entry within a specified record in a collection. It is useful for scenarios where you want to programmatically add chat conversations or messages into a structured data system, such as customer support logs, collaborative workspaces, or any application that tracks chat histories linked to records.

For example, you might use this node to:

  • Add a new chat conversation to a customer support ticket.
  • Log chat interactions related to a project task.
  • Store chat history associated with a CRM contact record.

Properties

Name Meaning
Collection Id The identifier of the collection where the chat record exists.
Field Id The ID of the specific chat field within the record where the chat will be created.
Record Id The ID of the record in which the chat will be created.
Properties A JSON object mapping other field IDs to their values, allowing you to populate additional fields in the record. Example: { "fieldId1": "value1", "fieldId2": 123 }
Messages A JSON object containing an array of messages to set as the chat history. This defines the content of the chat conversation. Example: { "messages": [ { "role": "user", "content": "Hello" }, { "role": "assistant", "content": "Hi there!" } ] }

Output

The node outputs JSON data representing the newly created chat record. This typically includes identifiers and the stored chat content, reflecting the state after creation. If binary data were involved (e.g., attachments), it would be summarized here, but this operation focuses on JSON chat data only.

Dependencies

  • Requires an API key credential for authenticating with the Cogfy Tables API.
  • Needs the base URL of the Cogfy Tables service configured in the credentials.
  • Depends on the Cogfy Tables API being accessible and properly configured to accept chat creation requests.

Troubleshooting

  • Missing Required Fields: Ensure Collection Id, Field Id, and Record Id are provided; otherwise, the API will reject the request.
  • Invalid JSON in Properties or Messages: The Properties and Messages fields expect valid JSON strings. Malformed JSON will cause parsing errors.
  • Authentication Errors: Verify that the API key credential is correctly set up and has permissions to create chats.
  • API Endpoint Issues: Confirm the base URL is correct and the Cogfy Tables API is reachable.
  • Error Responses from API: Check error messages returned by the API for details like invalid IDs or permission issues.

Links and References

Discussion