Automate your customer service. Sign up free
API Version

You're browsing the legacy version of the API documentation. Switch to the latest stable version →

User Segment

ChatBot automatically collects all users that chat with the bot and stores their data in the Users section. You can browse this section to find a particular person or a group that meets specified criteria.

Create segment

Creates new segment.

POST https://api.chatbot.com/segments

Properties

parameter type required default
name String(1, 256) required

Request URL

curl --request POST \
	--url https://api.chatbot.com/segments \
	--header 'authorization: Bearer ${DEVELOPER_ACCESS_TOKEN}' \
	--header 'content-type: application/json'

Response Example

    {
      "id": "\<ID\>",
      "timestamp": "2018-01-19T11:55:07.552Z",
      "status": {
        "code": 200,
        "type": "success"
      }
    }

List segments

Returns list of Segments.

GET https://api.chatbot.com/segments

Request URL

curl --request GET \
	--url https://api.chatbot.com/segments \
	--header 'authorization: Bearer ${DEVELOPER_ACCESS_TOKEN}'

Response Example

    [
      {
        "id": "5b7ff8476f7g3fb33c9249a8",
        "name": "Foo",
        "users": 0,
        "createdAt": "2019-01-23 13:32:30.163Z"
      }
    ]

Segment object

parameter type
id String
name String
users Number
createdAt String

Update segment

Update segment name.

PUT https://api.chatbot.com/segments/:id

URL Params

Required:

id=[alphanumeric]

Properties

parameter type required default
name String(1, 256) required

Request URL

curl --request PUT \
	--url https://api.chatbot.com/segments/:id \
	--header 'authorization: Bearer ${DEVELOPER_ACCESS_TOKEN}' \
	--header 'content-type: application/json'

Response Example

    {
      "timestamp": "2018-01-19T11:55:07.552Z",
      "status": {
        "code": 200,
        "type": "success"
      }
    }

Remove segment

Remove segment.

DELETE https://api.chatbot.com/segments/:id

URL Params

Required:

id=[alphanumeric]

Request URL

curl --request DELETE \
	--url https://api.chatbot.com/segments/:id \
	--header 'authorization: Bearer ${DEVELOPER_ACCESS_TOKEN}' \
	--header 'content-type: application/json'

Response Example

    {
      "timestamp": "2018-01-19T11:55:07.552Z",
      "status": {
        "code": 200,
        "type": "success"
      }
    }

Add members

Adds one or more Users to on or more Segments.

POST https://api.chatbot.com/segments/members

Properties

parameter type required
segments String[1,100] required
users String[1,1000] required

Request URL

curl --request POST \
	--url https://api.chatbot.com/segments/members \
	--header 'authorization: Bearer ${DEVELOPER_ACCESS_TOKEN}' \
	--header 'content-type: application/json'

Response Example

    {
      "timestamp": "2018-01-19T11:55:07.552Z",
      "status": {
        "code": 200,
        "type": "success"
      }
    }

Start a free ChatBot trial
and build your first chatbot today!

Free 14-day trial No credit card required

Discover our text| products