Conversations
Conversations in Clarityflow can contain one or several messages exchanged between multiple people.
Last updated
Conversations in Clarityflow can contain one or several messages exchanged between multiple people.
Last updated
POST https://app.clarityflow.com/api/v1/conversations/create_conversation
Creates a new conversation.
| Name | Type | Description |
|---|---|---|
GET https://app.clarityflow.com/api/v1/conversations/get_conversation
Retrieves a single conversation the account. If neither title nor slug are passed, then this will return the most recently created conversation in the account.
GET https://app.clarityflow.com/api/v1/conversations/get_conversations
Returns an array of conversations from the account.
| Name | Type | Description |
|---|---|---|
| Name | Type | Description |
|---|---|---|
title
string
If title is passed, the new conversation will have the passed value as title. If title is not passed, then the new conversation will use the default naming convention for new conversatons based in the account settings.
slug
string
If slug is set, new conversation will be have the passed value as slug. This cannot contain spaces or special characters except for _ or -.
anyone_can_post
boolean
If true then the conversation will be visible to anyone who can access it's URL. If false then it will be set to "Private" and only accessible by logged-in users who are members of this conversation. If not set, it will default to whatever this setting is in the account settings.
allow_anonymous_messages
boolean
If true then when people submit their replies, they will have the option to post their reply messages anonymously. If false, then they will be required to register with their name and email or sign into Clarityflow in order to submit their reply to this conversation.
allow_search_engines
boolean
If true then this conversation can be indexed by search engines. If false then robots.txt will instruct search engines not to index this conversation URL. If not set, then this setting defaults to what this is set to in account settings.
primary_intake_page
boolean
If true, it will be as if this conversation was created by submitting the form on your account's primary intake page.
This is useful if you want to automatically apply the workflow that is set on your primary intake page to the conversation.
intake_page_id
integer
If set to the ID of a secondary intake page, it will be as if this conversation was created by submitting the form on your that intake page. This is useful if you want to automatically apply the workflow that is set on your intake page to the conversation.
title
String
If passed, the most recently created conversation with a title that exactly matches this string (case insensitive) will be returned. If not passed, or if the title doesn't match any conversatoins, then the most recently created conversation in the account will be returned.
slug
String
If passed, the most recently created conversation with a slug that exactly matches this string (case insensitive) will be returned. If not passed, or if the title doesn't match any conversatoins, then the most recently created conversation in the account will be returned.
page
integer
A maximum of 50 conversations will be returned starting from th most recently created conversation. To retrieve conversations further back than 50, pass the page number.