Skip to content

Create a Chat Conversation

POST
/api/partners/v1/community/{community_id}/chat-conversations/

Create a Chat Conversation in Funnel for a Chat Conversation created by a partner

community_id
required
string

The Community ID, this will look like either ‘1234’ or ‘P1234-567’. Alternatively, if you prefix this value with partner-id:, for example partner-id:apts123 you can use your own community, as long as you have previously provided that ID to Funnel.

Examples

Funnel Community ID

The raw integer Funnel ID of a community.

1234
object
funnel_renter_id

Funnel Renter ID

integer
123
conversation_type

Obtain appropriate value from Funnel

string
website_url

URL where the covnersation happened

string
http://example.com
is_active

Has the conversation finished

boolean
true
messages
Array<object>
object
author_type

Who wrote the message

string
Allowed values: CHATBOT CLIENT
message

The content of the message

string
hi
timestamp

Datetime of when the message was created

string format: date-time
2023-10-04T00:02:23

Chat Conversation created succesfully.

We were unable to authenticate your request with the provided API key.

object
error_type
string
CommunityNotFound
message
string
Could not find community with corresponding ID.

A community with this ID does not exist.

object
error_type
string
CommunityNotFound
message
string
Could not find community with corresponding ID.