Actions113
- Accounts Actions
- Account Users Actions
- Agent Bots Actions
- Users Actions
- Inbox API Actions
- Contacts API Actions
- Conversations API Actions
- Messages API Actions
- CSAT Survey Page Actions
- Account Agent Bots Actions
- Agents Actions
- Canned Responses Actions
- Canned Response Actions
- Custom Attributes Actions
- Contacts Actions
- Contact Actions
- Automation Rule Actions
- Help Center Actions
- Conversations Actions
- Conversation Assignment Actions
- Conversation Labels Actions
- Inboxes Actions
- Messages Actions
- Integrations Actions
- Teams Actions
- Custom Filters Actions
- Webhooks Actions
- Reports Actions
Overview
This node allows you to create a new conversation in the Conversations API of a messaging or customer support platform. It is useful for automating the initiation of conversations with contacts within specific inbox channels, enabling seamless communication workflows. For example, you can use this node to start a chat session with a customer after they submit a form or trigger a conversation based on an event in your system.
Properties
| Name | Meaning |
|---|---|
| Inbox Identifier | The unique identifier of the inbox channel where the conversation will be created. |
| Contact Identifier | The unique source ID of the contact with whom the conversation is initiated. |
| Custom Attributes | A JSON object containing any custom attributes to associate with the conversation. |
Output
The node outputs JSON data representing the newly created conversation. This typically includes details such as the conversation ID, status, timestamps, and any metadata returned by the Conversations API. There is no binary output.
Dependencies
- Requires an API key credential for authenticating with the Conversations API.
- The base URL for the API must be configured in the node credentials.
- The node depends on the external Conversations API service being available and accessible.
Troubleshooting
- Missing Required Fields: Ensure that both the Inbox Identifier and Contact Identifier are provided; otherwise, the API call will fail.
- Invalid JSON in Custom Attributes: If the custom attributes JSON is malformed, the request may be rejected. Validate JSON syntax before input.
- Authentication Errors: Verify that the API key credential is correctly set up and has sufficient permissions.
- API Endpoint Issues: Confirm that the base URL is correct and the Conversations API service is reachable from n8n.
Links and References
- Conversations API Documentation (example link, replace with actual if known)
- JSON Syntax Validator - Useful for validating custom attributes input