Inbox conversations

Creates a new inbox conversation

post

Required Permission: chatbots.inbox.conversations.create

Resource: chatbots/:chatbotId

Authorizations

x-chatcaptain-key

x-chatcaptain-keystringRequired

Path parameters

chatbotIdstringRequired

The ID of the chatbot.

Body

application/json

namestringRequired

The name of the contact for the new conversation.

Example: John Doe

emailstring · emailOptional

The email address of the contact.

Example: [e-mail]

phonestringOptional

The phone number of the contact.

Example: [phone]

channelIdstringRequired

The ID of the channel in which the conversation is created.

Example: sTjncRDMuTdv65ex4I05

Responses

201

Conversation created successfully.

application/json

400

Invalid input data.

403

Insufficient permissions.

post

/v1/inbox/{chatbotId}/conversations

HTTPcURLJavaScriptPython

POST /v1/inbox/{chatbotId}/conversations HTTP/1.1
Host: api.chatcaptain.com
x-chatcaptain-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 110

{
  "name": "John Doe",
  "email": "[e-mail]",
  "phone": "[phone]",
  "channelId": "sTjncRDMuTdv65ex4I05"
}

{
  "conversationId": "bI0xfJiGQuPXCJ9slT5G",
  "error": "text"
}