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
- Webhooks Actions
- Teams Actions
- Custom Filters Actions
- Reports Actions
Overview
This node integrates with the Conversations API to create a new conversation within a specified inbox and contact context. It is useful for automating customer support workflows, initiating chat sessions, or logging conversations programmatically in systems that use the Conversations API.
Typical scenarios include:
- Automatically starting a conversation when a new customer inquiry is received.
- Creating conversations linked to specific contacts for tracking communication history.
- Adding custom metadata to conversations for enhanced filtering or reporting.
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 associated with the conversation. |
| Custom Attributes | JSON object containing any custom attributes to attach to the conversation (optional). |
Output
The node outputs JSON data representing the newly created conversation object as returned by the Conversations API. This typically includes details such as conversation ID, status, timestamps, linked contact and inbox information, and any custom attributes set during creation.
No binary data output is produced by this node.
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
@devlikeapro/n8n-openapi-nodepackage for OpenAPI integration.
Troubleshooting
- Missing Required Fields: Ensure that both "Inbox Identifier" and "Contact Identifier" are provided; otherwise, the API call will fail.
- Invalid JSON in Custom Attributes: If the "Custom Attributes" field contains malformed JSON, the node will throw a parsing error. Validate JSON syntax before input.
- Authentication Errors: Verify that the API key credential is correctly configured and has sufficient permissions.
- API Endpoint Issues: Confirm that the base URL is correct and reachable from your n8n instance.