Assign conversation

This method assigns a specific conversation to a specific administrator (or removes an assignment).

URL

POST https://api.dashly.app/v1/conversations/{id}/assign

The ID of the conversation should be used as {id}.

Arguments

This method follows the general rules. Arguments are transmitted as GET or POST parameters.

Argument Description
auth_token Required. Authorization token (requires scope: conversations-write)
admin Required. ID of administrator assigned to the conversation (or null for deassignment)
from_admin Specify the administrator ID if the administrator (not the bot) creates it.<!-- You can specify default_admin - default administrator
bot_name Specify the bot name who sends the replica. The default name is Bot.-->
random_id Random Conversation. Part ID for sending control. Default: 0

If the conversation is already assigned to this administrator, the answer with 200 status will be returned.

Answer

{
  "data": {
  }
  "meta": {
    "status": 200
  }
}

Answer will be empty.

Example

<!-- Assign a conversation with ID=716 to the administrator with ID=819 on behalf of the bot:

curl -X POST \
  --data-urlencode 'auth_token=XXX' \
  --data-urlencode 'admin=819' \
  'https://api.dashly.app/v1/conversations/716/assign'

--> Assign a conversation with ID=716 to the administrator with ID=819 on behalf of another administrator with ID=912:

curl -X POST \
  --data-urlencode 'auth_token=XXX' \
  --data-urlencode 'admin=819' \
  --data-urlencode 'from_admin=912' \
  'https://api.dashly.app/v1/conversations/716/assign'