Create a conversation
Example Request & Response
$ curl https://api.intercom.io/conversations \
-X POST \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' -d
{
"from": {
"type": "user",
"id": "536e564f316c83104c000020"
},
"body": "Hey"
}
HTTP/1.1 200 OK
{
"type": "user_message",
"id": "2001",
"created_at": 1401917202,
"body" : "Hey, is the new thing in stock?",
"message_type": "inapp"
}
intercom.messages.create(
:from => {
:type => "user",
:id => "536e564f316c83104c000020"
},
:body => "Hey"
)
<?php
$intercom->messages->create([
"message_type" => "inapp",
"body" => "Surely, I said, knowledge is the food of the soul",
"from" => [
"type" => "user",
"id" => "5989303470da497b1babb9ef"
]
]);
?>
UserMessage userMessage = new UserMessage()
.setBody("Hey! Is there, is there a reward?")
.setUser(user);
Conversation.create(userMessage);
You can create a conversation that has been initiated by a contact (ie. user or lead). The conversation can be an in-app message only.
Sending for vistitors
You can also send a message from a visitor by specifying their user_id
or id
value in the from
field, along with a type
field value of contact
. This visitor will be automatically converted to a contact with a lead role once the conversation is created.
Request Body Parameters
Parameter | Type | Required? | Description |
---|---|---|---|
from | Object | Yes | See Form Object below for more. |
body | String | Yes | The content of the message. HTML is not supported. |
From Object
Attribute | Type | Required? | Description |
---|---|---|---|
type | String | Yes | The role associated to the contact - user or lead . |
id | String | Yes | The identifier for the contact which is given by Intercom. |
Response
This will return the Message model that has been created.