Actions115
- Teams Actions
- Account Users Actions
- Custom Attributes Actions
- Contacts Actions
- Conversation Labels Actions
- Reports Actions
- Accounts Actions
- Contact 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
- Messages Actions
- Automation Rule Actions
- Help Center Actions
- Conversations Actions
- Conversation Assignment Actions
- Inboxes Actions
- Integrations Actions
- Profile Actions
- Custom Filters Actions
- Webhooks Actions
Overview
This node interacts with the Conversations API to create a new conversation. It is useful in scenarios where you need to programmatically initiate conversations within a messaging or customer support platform, such as starting a chat with a contact in a specific inbox. For example, it can be used to automate customer engagement by creating conversations based on triggers or events in a workflow.
Use Case Examples
- Automate customer support by creating a conversation when a new support ticket is generated.
- Start a conversation with a contact when they perform a specific action on a website or app.
Properties
| Name | Meaning |
|---|---|
| Inbox Identifier | The identifier obtained from the API inbox channel, specifying the inbox where the conversation will be created. |
| Contact Identifier | The source ID of the contact obtained when the contact was created, identifying the contact for the conversation. |
| Custom Attributes | Custom attributes of the conversation, provided as a JSON object to add additional metadata or information. |
| Request Options | Settings to control request behavior such as batching, SSL certificate validation, proxy usage, and timeout duration. |
Output
JSON
id- The unique identifier of the created conversation.inbox_identifier- The identifier of the inbox where the conversation was created.contact_identifier- The identifier of the contact involved in the conversation.custom_attributes- Custom attributes associated with the conversation.created_at- Timestamp when the conversation was created.status- Current status of the conversation.
Dependencies
- Requires an API key credential for authentication to the Conversations API endpoint.
Troubleshooting
- Ensure the Inbox Identifier and Contact Identifier are valid and exist in the system to avoid errors.
- If SSL certificate validation fails and you trust the endpoint, enable the 'Ignore SSL Issues' option to bypass SSL errors.
- Check proxy settings if requests fail due to network restrictions.
- Adjust timeout settings if the server response is slow to prevent premature request abortion.