ChatWoot Application icon

ChatWoot Application

Interact with ChatWoot Application APIs

Actions112

Conversation → Create New Conversation

AI-generated

Summary

Create a new conversation in a specified Chatwoot account, optionally assigning it to an inbox, contact, agent, or team, and setting initial message content and conversation attributes.

Inputs

  • Account ID (required) — The numeric ID of the Chatwoot account in which to create the conversation.
  • Source ID (required) — The source identifier for the conversation (e.g., a unique ID for the conversation source).
  • Inbox ID — The ID of the inbox (Website, Phone, API, Email) where to create the conversation.
  • Contact ID — The ID of the contact associated with the conversation.
  • Assignee ID — The agent ID to assign the conversation to.
  • Team ID — The team ID to assign the conversation to.
  • Additional Attributes — JSON object with additional attributes such as browser information.
  • Custom Attributes — Object of custom attributes to save on the conversation, supports key-value pairs defined in Chatwoot.
  • Message Content — Text content of the initial message to send in the conversation.
  • Message Template Params — JSON template parameters for the initial message, used especially for WhatsApp channels.
  • Snoozed Until — Date and time until which the conversation is snoozed.
  • Status — Conversation status: open, pending, or resolved.

Output shape

a single conversation object representing the newly created conversation

The response body will include all details of the created conversation. Optional fields are included if provided. Errors from the Chatwoot API may be returned if required fields are missing or invalid.

Links

Discussion