# Chatbots

## Create end user

 - [POST /beta/endusers](https://docs.dixa.io/openapi/dixa-api/beta/end-users/postendusers.md): Create an end user.

## Get end user

 - [GET /beta/endusers/{userId}](https://docs.dixa.io/openapi/dixa-api/beta/end-users/getendusersuserid.md): Get an end user by id.

## List end user conversations

 - [GET /beta/endusers/{userId}/conversations](https://docs.dixa.io/openapi/dixa-api/beta/end-users/getendusersuseridconversations.md): Lists conversations requested by an end user.  Note: Custom attributes are not part of the response at this point. If you need to get custom attributes for a conversation use the GET /conversations/{conversationId} endpoint

## Create end user

 - [POST /beta/endusers](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/postendusers.md): Create an end user.

## Get end user

 - [GET /beta/endusers/{userId}](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/getendusersuserid.md): Get an end user by id.

## List end user conversations

 - [GET /beta/endusers/{userId}/conversations](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/getendusersuseridconversations.md): Lists conversations requested by an end user.  Note: Custom attributes are not part of the response at this point. If you need to get custom attributes for a conversation use the GET /conversations/{conversationId} endpoint

## Close conversation

 - [PUT /beta/conversations/{conversationId}/close](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/putconversationsconversationidclose.md): Mark a conversation as closed by providing its id.

## Followup conversation

 - [PUT /beta/conversations/{conversationId}/followup](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/putconversationsconversationidfollowup.md): Follow up a conversation by providing its id and expiration timestamp.

## Transfer conversation

 - [PUT /beta/conversations/{conversationId}/transfer/queue](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/putconversationsconversationidtransferqueue.md): Transfer a conversation to a target queue.

## Create conversation rating result

 - [POST /beta/conversations/{conversationId}/ratings/{ratingId}/submit](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/postconversationsconversationidratingsratingidsubmit.md): Create a rating result for a specific conversation.

## Create conversation rating offer

 - [POST /beta/conversations/{conversationId}/ratings/offer](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/postconversationsconversationidratingsoffer.md): Create a rating offer for a specific conversation.

## Create conversation

 - [POST /beta/conversations](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/postconversations.md): Create a conversation. For inbound messages the author is assumed to be the requester of the conversation (end user). For outbound messages the author is specified using the agentId field.

## Import conversation

 - [POST /beta/conversations/import](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/postconversationsimport.md): Import a previously created conversation into Dixa. For inbound messages the author is assumed to be the requester of the conversation (end user), unless the specific channel supports overriding the message author through its attributes. For outbound messages the author is specified using the agentId field.

## Claim conversation

 - [PUT /beta/conversations/{conversationId}/claim](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/putconversationsconversationidclaim.md): Claim a conversation for a given agent. To avoid taking over assigned conversations, set the force paremeter to false

## Get queue availability

 - [GET /beta/queues/{queueId}/availability](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/getqueuesqueueidavailability.md): Get availability of supported channels for a given queue. Currently supported channels are adachat, kindlychat, digitalgeniuschat.

## Get the position of the conversation in its current queue

 - [GET /beta/queues/conversation-position/{csid}](https://docs.dixa.io/openapi/dixa-api/beta/chatbots/getqueuesconversation-positioncsid.md): Get the approximate position of a given conversation in its current queue.

## Close conversation

 - [PUT /beta/conversations/{conversationId}/close](https://docs.dixa.io/openapi/dixa-api/beta/conversations/putconversationsconversationidclose.md): Mark a conversation as closed by providing its id.

## Followup conversation

 - [PUT /beta/conversations/{conversationId}/followup](https://docs.dixa.io/openapi/dixa-api/beta/conversations/putconversationsconversationidfollowup.md): Follow up a conversation by providing its id and expiration timestamp.

## Transfer conversation

 - [PUT /beta/conversations/{conversationId}/transfer/queue](https://docs.dixa.io/openapi/dixa-api/beta/conversations/putconversationsconversationidtransferqueue.md): Transfer a conversation to a target queue.

## Create conversation rating result

 - [POST /beta/conversations/{conversationId}/ratings/{ratingId}/submit](https://docs.dixa.io/openapi/dixa-api/beta/conversations/postconversationsconversationidratingsratingidsubmit.md): Create a rating result for a specific conversation.

## Create conversation rating offer

 - [POST /beta/conversations/{conversationId}/ratings/offer](https://docs.dixa.io/openapi/dixa-api/beta/conversations/postconversationsconversationidratingsoffer.md): Create a rating offer for a specific conversation.

## Create conversation

 - [POST /beta/conversations](https://docs.dixa.io/openapi/dixa-api/beta/conversations/postconversations.md): Create a conversation. For inbound messages the author is assumed to be the requester of the conversation (end user). For outbound messages the author is specified using the agentId field.

## Import conversation

 - [POST /beta/conversations/import](https://docs.dixa.io/openapi/dixa-api/beta/conversations/postconversationsimport.md): Import a previously created conversation into Dixa. For inbound messages the author is assumed to be the requester of the conversation (end user), unless the specific channel supports overriding the message author through its attributes. For outbound messages the author is specified using the agentId field.

## Claim conversation

 - [PUT /beta/conversations/{conversationId}/claim](https://docs.dixa.io/openapi/dixa-api/beta/conversations/putconversationsconversationidclaim.md): Claim a conversation for a given agent. To avoid taking over assigned conversations, set the force paremeter to false

## Create conversation rating result

 - [POST /beta/conversations/{conversationId}/ratings/{ratingId}/submit](https://docs.dixa.io/openapi/dixa-api/beta/ratings/postconversationsconversationidratingsratingidsubmit.md): Create a rating result for a specific conversation.

## Create conversation rating offer

 - [POST /beta/conversations/{conversationId}/ratings/offer](https://docs.dixa.io/openapi/dixa-api/beta/ratings/postconversationsconversationidratingsoffer.md): Create a rating offer for a specific conversation.

## Get queue availability

 - [GET /beta/queues/{queueId}/availability](https://docs.dixa.io/openapi/dixa-api/beta/queues/getqueuesqueueidavailability.md): Get availability of supported channels for a given queue. Currently supported channels are adachat, kindlychat, digitalgeniuschat.

## Get the position of the conversation in its current queue

 - [GET /beta/queues/conversation-position/{csid}](https://docs.dixa.io/openapi/dixa-api/beta/queues/getqueuesconversation-positioncsid.md): Get the approximate position of a given conversation in its current queue.