User.com REST API Docs # Create conversation
You can create a conversation with your user starting with a message. Message content can be just plain text or HTML.
Hi
<b>user</b>, enjoy our product!
The message will be shown as follow:
Hi user, enjoy our product!
POST /users/:user_id/conversations/
| Attributes | Type | Required | Description |
|---|---|---|---|
| user_id | integer | yes | A unique identifier for the user which is given by User.com automatically. |
| user | integer | no | A unique identifier for the agent (an author of the message) which is given by User.com automatically. |
| content | string | yes | A content of a message sent to the user. |
| source | integer | no | A source of your message (1 - chat, 2 - email, 3 - API, 4 - SMS, 5 - Slack). |
| source_context | string | no | An additional context for your source (only visible for you). |
# Request
- CURL
- JavaScript
- PHP
- Python
curl -X POST -H "Authorization: Token <your_64_char_api_key>"
-H "Accept: */*; version=2" -H "Content-Type: application/json" -d '{
"content": "Message sent using API",
"user": 926,
"source": 2,
"source_context": {
"name": "This is source_context used in API",
"id": 123
}
}' "https://<your_app_subdomain>.user.com/api/public/users/:user_id/conversations/"
# Response
{
"id":89,
"user": {
"id":322842,
"key":"2if9jlgsfsw3",
"name":"John Doe",
"email":"johndoe@response.example"},
"active":true,
"agent":null,
"messages":1
}