Open Channel Operators: Overview of Methods

Open channel operators work with dialogues: they accept them for processing, transfer them, complete them, or mark them as spam.

Quick Navigation: All Methods

Operators' Interaction with Other ObjectsOperators' Interaction with Other Objects

Chats. The operator's actions are applied to the chat using the identifier CHAT_ID. This identifier can be obtained through the methods imopenlines.session.open and imopenlines.dialog.get.

User. The operator switches the dialogue to an employee with the identifier USER_ID. The user identifier can be retrieved using the methods user.get and user.search.

Open Channels. The operator transfers the dialogue to the queue of another open channel using the identifier QUEUE_ID or a string in the format queue<QUEUE_ID>. The queue identifier can be obtained through the method imopenlines.config.list.get.

How to Use the MethodsHow to Use the Methods

Choose a method based on your workflow:

• start processing a new request — imopenlines.operator.answer
• complete your dialogue — imopenlines.operator.finish
• complete another operator's dialogue — imopenlines.operator.another.finish
• transfer the dialogue to a specific employee or another queue — imopenlines.operator.transfer
• pass the dialogue to the next operator in the queue — imopenlines.operator.skip
• close an inappropriate request — imopenlines.operator.spam

Rules for Calling imopenlines.operator.transferRules for Calling imopenlines.operator.transfer

• Only pass one parameter: TRANSFER_ID, USER_ID, or QUEUE_ID. Do not pass TRANSFER_ID along with USER_ID or QUEUE_ID simultaneously.
• Use USER_ID of the employee or a string in the format queue<QUEUE_ID> as TRANSFER_ID.

Response Format of the MethodsResponse Format of the Methods

All methods in this section return the same response format:

• result — status of the operation,
• time — information about the execution time.

{
            "result": true,
            "time": {
                "start": 1773663032,
                "finish": 1773663032.493037,
                "duration": 0.49303698539733887,
                "processing": 0,
                "date_start": "2026-03-16T15:10:32+01:00",
                "date_finish": "2026-03-16T15:10:32+01:00",
                "operating_reset_at": 1773663632,
                "operating": 0
            }
        }
        

Overview of MethodsOverview of Methods

Scope: imopenlines

Who can execute the method: any user with dialogue permissions