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 creates a new conversation in the Konverte Digital system. It is useful for initiating customer support or communication threads within an account, specifying details such as the source, inbox, contact, and initial message. Practical applications include automating the creation of support tickets or chat threads when a new customer inquiry is received.
Use Case Examples
- Creating a new conversation for a customer support ticket with an initial message.
- Assigning a conversation to a specific agent or team automatically.
- Setting custom attributes and status for a conversation based on business rules.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the account where the conversation is created. |
| Source Id | The source identifier of the conversation. |
| Inbox Id | The ID of the inbox where the conversation is created, supporting types like Website, Phone, API, Email. |
| Contact Id | The contact ID for whom the conversation is created. |
| Additional Attributes | JSON object specifying additional attributes like browser information. |
| Custom Attributes | JSON object to save custom key-value attributes for the conversation. |
| Status | The status of the conversation, such as open, resolved, or pending. |
| Assignee Id | Agent ID to assign the conversation to a specific agent. |
| Team Id | Team ID to assign the conversation to a specific team. |
| Message | The initial message to be sent in the conversation, provided as a JSON object. |
| Request Options | Settings for request behavior such as batching, SSL validation, proxy, and timeout. |
Output
JSON
id- The unique identifier of the created conversation.account_id- The account ID associated with the conversation.source_id- The source ID of the conversation.inbox_id- The inbox ID where the conversation was created.contact_id- The contact ID related to the conversation.status- The current status of the conversation.assignee_id- The agent ID assigned to the conversation.team_id- The team ID assigned to the conversation.message- The initial message sent in the conversation.created_at- Timestamp when the conversation was created.
Dependencies
- Requires an API key credential for authentication with the Konverte Digital API.
Troubleshooting
- Ensure all required fields like Account Id, Source Id, and Inbox Id are provided to avoid validation errors.
- Check API credentials and base URL configuration if authentication errors occur.
- If SSL issues arise, consider enabling the option to ignore SSL certificate validation, but be aware of security risks.
- Timeouts can occur if the server is slow; adjust the timeout setting accordingly.